标签：

PHP 语言供给了一种扩展机制（Extension），通过 PHP 扩展可以增强语法、挪用 C/C++ 实现的库函数以及优化执行性能。PHP 扩展是与平台相关的动态链接库，在 Linux 和 Mac 平台是 .so 文件，在 Windows 平台是 .dll 文件。由于函数计算的开发凡是在 Mac 和 Windows 平台，而运行时是 Linux（Debain）环境，所以为函数计算 PHP 运行时添加扩展会遇到由于动态链接库平台相关而导致要么本地无法调试，要么远端无法运行的问题。本文介绍借助 Funcraft 工具供给的模拟环境进行 PHP 扩展的安置、本地运行调试以及构建颁布。

筹备事情 依赖工具

本项目是在 MacOS 下开发的，涉及到的工具是平台无关的，对付 Linux 和 Windows 桌面系统应该也同样适用。在开始本例之前请确保如下工具已经正确的安置，更新到最新版本，并进行正确的配置。

Docker

Fun

Fun 和 Fcli 工具依赖于 docker 来模拟本地环境。
对付 MacOS 用户可以使用 homebrew 进行安置：

brew cask install docker brew tap vangie/formula brew install fun brew install fcli

Windows 和 Linux 用户安置请参考：

https://github.com/aliyun/fun/blob/master/docs/usage/installation.md

https://github.com/aliyun/fcli/releases

安置好后，记得先执行 fun config 初始化一下配置。

注意, 如果你已经安置过了 fun，确保 fun 的版本在 3.6.1 以上。

$ fun --version 3.6.1 PHP 自界说扩展

在函数代码目录创建一个名为 extension 的目录，并且将扩展对应的 .ini 和 .so 文件放在 extension 目录下。例如，以下为一个 hello 的自界说扩展，假设该扩展里有一份 hello_world 函数：

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

hello.ini

extension=http://www.mamicode.com/code/extension/hello.so

main.php

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

上述要领是函数计算PHP 运行时供给的扩展要领。实践过程中会碰到如下两个问题：

.so 文件应该如何构建出来，或者去哪里下载

有了 .so 文件后，本地如何调试代码

完整示例

下面会基于借用 [PHP 访谒 MongoDB 的例子]()来介绍如何借助于 Funcraft 进行 PHP 开发，因为 composer 依赖 mongodb/mongodb 需要安置 extension。

初始化项目

# 创建工程目录并进入 $ mkdir fc-mongodb && cd fc-mongodb # 初始化 $ fun init event-php7.2 通过 Funfile 安置

我们在 Linux 平台下凡是会通过 pecl 工具进行 PHP 的扩展安置。好比 pecl install mongodb。该命令会触起源代码下载、编译并拷贝到系统 PHP 目录。pecl 需要执行在 Linux 环境中才华装linux 版本的 .so 文件。在函数计算这里可以通过 fun install 机制进行安置。

新建一个 Funfile 文件，内容如下：

RUNTIME php7.2 RUN apt-get update && apt-get install -y libcurl4-openssl-dev pkg-config libssl-dev RUN pecl install mongodb RUN mkdir -p /code/extension && mv /usr/local/lib/php/extensions/*/mongodb.so /code/extension RUN echo "extension=http://www.mamicode.com/code/extension/mongodb.so" > /code/extension/mongodb.ini

逐行解释一下上面五行指令

第一行先声明是一个 php7.2 版本的 Runtime，

接着安置 构建 mongodb 所需要的依赖，这里主要是为了装 openssl，为了能让 mongodb 扩展库撑持 ssl，以解决连接时的一个报错。所有

通过 pecl 下载、构建并且安置 mongodb 扩展

将 mongodb 扩展拷贝到 /code/extendsion 目录，该目录是函数计算约定的 extension 目录

生成 mongodb.int 文件，这里文件名是随意的，只需要 .ini 结尾就好了。

然后执行

fun install -f php using template: template.yml ... Install Success

安置以后会多处一个 extension 目录，包罗 mongodb.so 和 mongodb.ini 文件

╰─? tree . ├── Funfile ├── extension │ ├── mongodb.ini │ └── mongodb.so ├── index.php └── template.yml 安置 mongodb 依赖

执行下面命令通过 composer 安置依赖 ‘mongodb/mongodb‘

$ fun install sbox -f fc-mongodb -c "composer require mongodb/mongodb" using template: template.yml skip pulling image aliyunfc/runtime-php7.2:build-1.9.0... Using version ^1.6 for mongodb/mongodb ./composer.json has been created Loading composer repositories with package information Updating dependencies (including require-dev) Package operations: 1 install, 0 updates, 0 removals - Installing mongodb/mongodb (1.6.0): Downloading (100%) Writing lock file Generating autoload files