PHP 运行环境

函数计算支持 PHP 7.2.7（runtime = php7.2）运行环境。本文主要介绍以下 PHP 运行环境相关内容：

• 使用 logger
• PHP 内置扩展
• PHP 自定义扩展
• PHP 内置库
• PHP 自定义库
• 调用外部命令
• 错误处理

使用 logger

PHP 函数通过 $GLOBALS['fcLogger'] 打印的内容会被收集到创建服务时指定的日志服务 Logstore 中。函数计算内置了 logger 模块，您可以通过 $GLOBALS['fcLogger'] 使用该内置 logger。

日志级别

您可以通过 setLevel 方法改变日志级别，其中有如下几种从高到低的日志级别：

更多有关函数日志的详情，请参阅 函数日志。

logger 示例一

<?php
function handler($event, $context) {
    $logger = $GLOBALS['fcLogger'];
    $logger->info("hello world");
    return 'hello world';
};

输出的日志内容为：

message:2017-07-05T05:13:35.920Z a72df088-f738-cee3-e0fe-323ad89118e5 [INFO] hello world

logger 示例二

<?php
use Monolog\Logger;
function handler($evt, $ctx) {
    $logger = $GLOBALS['fcLogger'];
    $logger->setLevel(400);
    $logger->error("console error 1");
    $logger->info("console info 1");
    $logger->warning("console warn 1");
    $logger->debug("console debug 1");
    $logger->setLevel(Logger::WARNING);
    $logger->error("console error 2");
    $logger->info("console info 2");
    $logger->warn("console warn 2");
    $logger->debug("console debug 2");
    $logger->setLevel(200);
}

输出的日志内容为：

2018-08-22T09:01:26Z c19b2706-9c4d-270b-52c8-5248ed5e2315 [ERROR]: console error 1
2018-08-22T09:01:26Z c19b2706-9c4d-270b-52c8-5248ed5e2315 [ERROR]: console error 2
2018-08-22T09:01:26Z c19b2706-9c4d-270b-52c8-5248ed5e2315 [WARNING]: console warn 2

PHP 内置扩展

以下为 PHP 运行环境的内置扩展（built-in extension），能覆盖您的大部分需求：

"Core", "date", "libxml", "openssl", "pcre", "zlib", "curl","filter", "hash", "readline", "Reflection", 
"SPL", "session","xml", "standard", "mysqlnd", "bcmath", "bz2", "calendar","ctype", "dom", "mbstring", 
"fileinfo", "ftp", "gettext", "gmp", "iconv","imagick", "json", "exif", "mysqli", "pcntl", "PDO", 
"pdo_mysql","Phar", "posix", "protobuf", "redis", "shmop", "SimpleXML", "soap","sockets", "sysvmsg", "zip", "memcached",
"sysvsem", "sysvshm", "tokenizer", "xmlreader","xmlrpc", "xmlwriter"

PHP 内置扩展使用示例

以下示例代码使用 imagick 对图片做了简单处理：

<?php
function imageProc($event, $context) {
    $image = new Imagick(__DIR__ . '/lena.jpg');
    $image->thumbnailImage(100, 0);
    $image->writeImages(__DIR__ . "/thumb.jpg", true);
    return strval($image->getImageWidth()) . "," . strval($image->getImageHeight());
}

PHP 自定义扩展

您可以在函数入口文件同级目录下创建一个名为 extension 的目录，并且将扩展对应的 .ini 和 .so 文件放在 extension 目录下，以此添加 PHP 自定义扩展。例如，以下为一个 hello 的自定义扩展，假设该扩展里有一份 hello_world 函数：

.
|____extension
| |____hello.ini
| |____hello.so
|____main.php

• hello.ini

    extension=/code/extension/hello.so

• main.php

    <?php
    function handler($event, $context) {
        var_dump(extension_loaded('hello'));
        hello_world(); 
        return "ok";
    }

PHP 内置库

函数计算的 PHP 运行环境中自带了一些常用库（Package）供您直接引用，目前包含的内置库有：

PHP 内置库使用示例

以下代码使用了 OSS 库中的方法上传了一份 TXT 文件：

<?php
use OSS\OssClient;
function handler($event, $context) {
     $accessKeyId = $context["credentials"]["accessKeyId"];
     $accessKeySecret = $context["credentials"]["accessKeySecret"];
     $securityToken = $context["credentials"]["securityToken"];
     $endpoint = "oss-cn-shenzhen.aliyuncs.com";
     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint, false, $securityToken);
     $bucket = "my-bucket";
     $object = "php.txt";
     $content = "Hello fc!";
     try {
        $ossClient->putObject($bucket, $object, $content);
     } catch (OssException $e) {
        print($e->getMessage());
     }
    return 'success';
}

PHP 自定义库

除内置库外，您可以在上传 PHP 函数代码时打包您需要的自定义库。建议您使用 Composer 添加自定义库。

方式一：使用 Composer 添加自定义库示例

您要使用的库已经发布在 Packagist The PHP Package Repository 时，您可以使用 Composer 添加自定义库。本示例将演示通过 Fun 添加一个 Humble HTTP request library package requests 的步骤：

1. 新建目录用于存放代码和依赖模块。

   mkdir /tmp/code

2. 新建代码文件，例如 /tmp/code/index.php ，在代码中使用requests:

   <?php
   require_once __DIR__ . "/vendor/autoload.php";
   function handler($event, $context){
      $headers = array('Accept' => 'application/json');
      $options = array('auth' => array('user', 'pass'));
      $request = Requests::get('https://www.baidu.com', $headers, $options);
      var_dump($request->status_code);
      // int(200)
      var_dump($request->headers['content-type']);
      // string(31) "application/json; charset=utf-8"
      var_dump($request->body);
      // string(26891) "[...]"
   }

3. 在 /tmp/code 目录下安装自定义库。

   1. 编辑一份文件取名为 composer.json。

      {
        "require": {
            "rmccue/requests": ">=1.0"
        }
      }

   2. 执行命令 composer install --no-dev 安装依赖。

      cd /tmp/code
      composer install --no-dev

   3. 检查是否成功安装依赖。安装完成之后，/tmp/code 目录的内容应该为如下所示：

      ls -l /tmp/code
      -rw-r--r--  1 rsong  staff    72  8 22 09:54 composer.json
      -rw-r--r--  1 rsong  staff  2165  8 22 09:54 composer.lock
      -rw-r--r--  1 rsong  staff   523  8 22 09:54 index.php
      drwxr-xr-x  5 rsong  staff   160  8 22 09:54 vendor

4. 编写 template.yml，并发布

   • 在 /tmp/code 编写一个名为 template.yml 的文件

     ROSTemplateFormatVersion: '2015-09-01'
     Transform: 'Aliyun::Serverless-2018-04-03'
     Resources:
     FunDemo: 
      Type: 'Aliyun::Serverless::Service'
      phpdemo: 
        Type: 'Aliyun::Serverless::Function'
        Properties:
          Handler: index.handler
          Runtime: php7.2
          CodeUri: './'

     这个 template.yml 的含义如下：声明一个名为 FunDemo 的 服务，并在这个服务下，再声明一个名为 phpdemo 的 函数，配置函数入口为 index.handler，以及函数的 runtime 为 php7.2。并且，我们指定了 CodeUri 为当前目录。在部署时，Fun 会将 CodeUri 指定的目录打包上传。更多的配置规则 请参考。

   • 执行 fun deploy 进行发布

     fun deploy

     可以看到发布成功的日志：

     using region: cn-hangzhou
     using accountId: ***********3557
     using accessKeyId: ***********r3Ra
     using timeout: 300
     Waiting for service FunDemo to be deployed...
        Waiting for function phpdemo to be deployed...
            Waiting for packaging function phpdemo code...
            package function phpdemo code done
        function phpdemo deploy success
     service FunDemo deploy success

     登录控制台，即可看到相关的服务、函数被创建成功，且触发执行可以返回正确的结果。

     这里简单介绍下 fun deploy 所做的事情：使用 Fun 部署时，Fun 会根据这个 template.yml 的配置，为我们创建一个名为 FunDemo 的服务，然后再在该服务下创建一个运行环境为 php7.2、名称为 phpdemo 的函数，并且会将当前目录（CodeUri 指定的目录）打包，作为函数的代码上传到函数计算。因为我们打包的代码包含了 vendor 目录，而我们安装的库都在这个目录中，所以函数计算就可以直接使用这个库了。

方式二：直接下载自定义库

您要使用的库没有发布在 Packagist The PHP Package Repository 时，例如 Aliyun-openapi-php-sdk 和 日志服务 PHP SDK，您可以直接下载对应库，然后在代码中直接引用。本示例通过函数计算命令行工具 Fun 添加了日志服务 PHP SDK 自定义库：

1. 新建目录存放代码和依赖模块。

   mkdir /tmp/code

2. 新建函数文件，例如 /tmp/code/index.php ，在代码中使用日志服务的自定义库。

   <?php
   /* 使用 autoloader 类自动加载所有需要的 PHP 模块。注意使用合适的路径指向 autoloader 类所在文件 */
   require_once realpath(dirname(__FILE__) . '/aliyun-log-php-sdk/Log_Autoload.php');
   function handler($event, $context){
      $endpoint = 'cn-hangzhou.sls.aliyuncs.com'; // 选择与上面步骤创建 project 所属区域匹配的接入地址 Endpoint
      $accessKeyId = 'your_access_key_id';        // 使用您的阿里云访问密钥 AccessKeyId
      $accessKey = 'your_access_key';             // 使用您的阿里云访问密钥 AccessKeySecret
      $project = 'your_project';                  // logProject 名称
      $logstore = 'your_logstore';                // LogStore 名称
      $client = new Aliyun_Log_Client($endpoint, $accessKeyId, $accessKey);
      # 列出当前 logProject 下的所有日志库名称
      $req1 = new Aliyun_Log_Models_ListLogstoresRequest($project);
      $res1 = $client->listLogstores($req1);
      var_dump($res1);
   }

3. 在 /tmp/code 目录中下载依赖。

   1. 执行命令，下载依赖。

       cd /tmp/code
       git clone https://github.com/aliyun/aliyun-log-php-sdk.git

   2. 检查是否成功下载依赖。下载完成之后，/tmp/code 目录的内容应该为如下所示：

       ls -l /tmp/code
       drwxr-xr-x  11 rsong  staff  352  8 22 10:35 aliyun-log-php-sdk
       -rw-r--r--   1 rsong  staff  957  8 22 10:42 index.php

4. 编写 template.yml 并发布。

   • 在 /tmp/code 编写一个名为 template.yml 的文件

     ROSTemplateFormatVersion: '2015-09-01'
     Transform: 'Aliyun::Serverless-2018-04-03'
     Resources:
     FunDemo: 
      Type: 'Aliyun::Serverless::Service'
      phpdemo: 
        Type: 'Aliyun::Serverless::Function'
        Properties:
          Handler: index.handler
          Runtime: php7.2
          CodeUri: './'

     这个 template.yml 的含义如下：声明一个名为 FunDemo 的 服务，并在这个服务下，再声明一个名为 phpdemo 的 函数，配置函数入口为 index.handler，以及函数的 runtime 为 php7.2。并且，我们指定了 CodeUri 为当前目录。在部署时，Fun 会将 CodeUri 指定的目录打包上传。更多的配置规则 请参考。

   • 执行 fun deploy 进行发布

     fun deploy

     可以看到发布成功的日志：

     using region: cn-hangzhou
     using accountId: ***********3557
     using accessKeyId: ***********r3Ra
     using timeout: 300
     Waiting for service FunDemo to be deployed...
        Waiting for function phpdemo to be deployed...
            Waiting for packaging function phpdemo code...
            package function phpdemo code done
        function phpdemo deploy success
     service FunDemo deploy success

     登录控制台，即可看到相关的服务、函数被创建成功，且触发执行可以返回正确的结果。

     这里简单介绍下 fun deploy 所做的事情：使用 Fun 部署时，Fun 会根据这个 template.yml 的配置，为我们创建一个名为 FunDemo 的服务，然后再在该服务下创建一个运行环境为 php7.2、名称为 phpdemo 的函数，并且会将当前目录（CodeUri 指定的目录）打包，作为函数的代码上传到函数计算。因为我们打包的代码包含了将包含了整个项目目录，而我们安装的库都在这个目录中，所以函数计算就可以直接使用这个库了。

调用外部命令

当您的 PHP 函数需要调用非 PHP 语言构建的工具，例如，例如 Shell 脚本、C++ 或者 go 编译出来的可执行文件时，您可以将工具与函数代码一起打包上传，然后在函数中通过运行外部命令的方法使用工具。常见的调用外部命令的 PHP 方法有 exec、system 和 shell-exec。

说明：使用 C、C++ 和 go 编译的可执行文件，需要与函数计算的运行环境兼容。函数计算的 PHP 运行环境采用了 Linux 4.4.24-2.al7.x86_64 内核版本和 docker pull php:7.2 基础镜像。

以下示例演示了如何使用 exec 方法调用一份 Shell 脚本：

<?php
function handler($evt, $ctx){
    $script = $_ENV['FC_FUNC_CODE_PATH'] . '/script.sh';
    $a = exec("bash " . $script, $out, $status);
    print_r($a);
    var_dump($out);
    print_r($status);
}

错误处理

PHP 函数在执行过程中发生异常时，函数计算捕获异常并返回异常信息。以下示例代码返回了 oops 的异常信息：

<?php
function handler($event, $context) {
  throw new Exception("oops");
}

根据以上示例代码，您调用函数时可能收到如下响应信息：

{
    "errorMessage":"oops",
    "errorType":"Exception",
    "stackTrace":{
        "file":"/code/index.php",
        "line":3,
        "traceString":"#0 /var/fc/runtime/php7/src/invoke.php(67): handler('{\n "product"...', Array)
#1 "
    }
}

发生异常时，函数调用的响应的 HTTP header 中会包含 X-Fc-Error-Type: UnhandledInvocationError。更多有关函数计算的错误类型，请参阅 错误类型。