PHP 运行环境

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

• 打印日志
• 错误处理
• PHP 内置扩展
• PHP 自定义扩展
• PHP 内置库
• PHP 自定义库
• 调用外部命令

打印日志

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 函数在执行过程中发生异常时，函数计算捕获异常并返回异常信息。以下示例代码返回了 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。有关函数计算错误类型的更多信息，请参见错误类型。

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 添加自定义库。下文演示添加 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

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

您要使用的库没有发布在 Packagist The PHP Package Repository 时，例如 Aliyun-openapi-php-sdk 和 日志服务 PHP SDK，您可以直接下载对应库，然后在代码中直接引用。下文演示添加日志服务 PHP SDK 自定义库。

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

   mkdir /tmp/code

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

<?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 目录中下载依赖。

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

打包上传到函数计算

打包时，需要针对文件进行打包，而不是针对代码整体目录进行打包。打包完成后，入口函数文件需要位于包内的根目录。

• 在 Windows 下打包时，可以进入函数代码目录，全选所有文件以后，单击鼠标右键，选择压缩为 zip 包，生成代码包。

• 在 Linux 下打包时，通过调用 zip 命令时，将源文件指定为代码目录下的所有文件，实现生成部署代码包，例如 zip code.zip /tmp/code/*。

打包后，您通过函数计算控制台代码执行页面，您可以选择 OSS 上传或者代码包上传方式上传代码包。

调用外部命令

当您的 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);
}