开发函数计算的正确姿势———为 PHP 运行时添加自定义扩展
PHP 语言提供了一种扩展机制(Extension),通过 PHP 扩展可以增强语法、调用 C/C++ 实现的库函数以及优化执行性能。PHP 扩展是与平台相关的动态链接库,在 Linux 和 Mac 平台是 .so 文件,在 Windows 平台是 .dll 文件。由于函数计算的开发通常在 Mac 和 Windows 平台,而运行时是 Linux(Debain)环境,所以为函数计算 PHP 运行时添加扩展会遇到由于动态链接库平台相关而导致要么本地无法调试,要么远端无法运行的问题。本文介绍借助 Funcraft 工具提供的模拟环境进行 PHP 扩展的安装、本地运行调试以及构建发布。
准备工作
依赖工具
本项目是在 MacOS 下开发的,涉及到的工具是平台无关的,对于 Linux 和 Windows 桌面系统应该也同样适用。在开始本例之前请确保如下工具已经正确的安装,更新到最新版本,并进行正确的配置。
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=/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=/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
安装成功后会在代码目录多处 composer.json 文件、composer.lock 文件和 vendor 目录
╰─➜ tree -L 2 . ├── Funfile ├── composer.json ├── composer.lock ├── extension │ ├── mongodb.ini │ └── mongodb.so ├── index.php ├── template.yml └── vendor ├── autoload.php ├── composer └── mongodb
本地调试
更新 index.php 文件
<?php require 'vendor/autoload.php'; function handler($event, $context) { $db_name = $_ENV['MONGO_DATABASE']; $uri = $_ENV['MONGO_URL']; $client = new MongoDB\Client($uri); $collection = $client->$db_name->fc_col; $result = $collection->insertOne(['DEMO' => 'FC', 'MSG' => 'Hello FunctionCompute For MongoDB']); echo "Inserted with Object ID '{$result->getInsertedId()}'", "\n"; $cursor = $collection->find(['DEMO' => 'FC']); $result = ''; foreach ($cursor as $entry) { echo json_encode($entry->getArrayCopy()), "\n"; $result = $result . json_encode($entry->getArrayCopy()) . "\n"; } return $result; }
借助 docker 启动一个临时的 mongodb 数据库
docker run --rm --name mongo_for_fc \ -e MONGO_INITDB_ROOT_USERNAME=mongoadmin \ -e MONGO_INITDB_ROOT_PASSWORD=secret \ -p 27017:27017 \ mongo
更新 template.yml 文件,添加 MONGO_DATABASE
和 MONGO_URL
环境变量。
ROSTemplateFormatVersion: '2015-09-01' Transform: 'Aliyun::Serverless-2018-04-03' Resources: fc-mongodb: Type: 'Aliyun::Serverless::Service' Properties: Description: 'helloworld' fc-mongodb: Type: 'Aliyun::Serverless::Function' Properties: Handler: index.handler Runtime: php7.2 CodeUri: './' EnvironmentVariables: MONGO_DATABASE: admin MONGO_URL: mongodb://mongoadmin:secret@host.docker.internal:27017/admin
使用 fun local
本地模拟运行
$ fun local invoke using template: template.yml Missing invokeName argument, Fun will use the first function fc-mongodb/fc-mongodb as invokeName skip pulling image aliyunfc/runtime-php7.2:1.9.2... FunctionCompute php7.2 runtime inited. FC Invoke Start RequestId: b1764771-896b-4c27-9ad8-6c325cc3d749 Inserted with Object ID '5e539d08c42dc23cf23863e2' {"_id":{"$oid":"5e539d08c42dc23cf23863e2"},"DEMO":"FC","MSG":"Hello FunctionCompute For MongoDB"} FC Invoke End RequestId: b1764771-896b-4c27-9ad8-6c325cc3d749 {"_id":{"$oid":"5e539d08c42dc23cf23863e2"},"DEMO":"FC","MSG":"Hello FunctionCompute For MongoDB"} RequestId: b1764771-896b-4c27-9ad8-6c325cc3d749 Billed Duration: 214 ms Memory Size: 1989 MB Max Memory Used: 27 MB
如果希望本地断点调试可以使用 Aliyun Serverless VSCode Extension,如下图
发布并调用
请将 template.yml 配置文件中的 MONGO_DATABASE
和 MONGO_URL
环境变量更新为您线上系统的相应配置,然后发布
$ fun deploy using template: template.yml using region: cn-shanghai using accountId: ***********4733 using accessKeyId: ***********EUz3 using timeout: 60 Collecting your services information, in order to caculate devlopment changes... Resources Changes(Beta version! Only FC resources changes will be displayed): ┌────────────┬──────────────────────────────┬────────┬──────────────────────┐ │ Resource │ ResourceType │ Action │ Property │ ├────────────┼──────────────────────────────┼────────┼──────────────────────┤ │ fc-mongodb │ Aliyun::Serverless::Service │ Modify │ Description │ ├────────────┼──────────────────────────────┼────────┼──────────────────────┤ │ │ │ │ Handler │ │ │ │ ├──────────────────────┤ │ │ │ │ Runtime │ │ fc-mongodb │ Aliyun::Serverless::Function │ Modify ├──────────────────────┤ │ │ │ │ CodeUri │ │ │ │ ├──────────────────────┤ │ │ │ │ EnvironmentVariables │ └────────────┴──────────────────────────────┴────────┴──────────────────────┘ ? Please confirm to continue. Yes Waiting for service fc-mongodb to be deployed... Waiting for function fc-mongodb to be deployed... Waiting for packaging function fc-mongodb code... The function fc-mongodb has been packaged. A total of 761 files files were compressed and the final size was 2.81 MB function fc-mongodb deploy success service fc-mongodb deploy success
最使用 fun invoke
命令验证调用结果。
小结
本文主要介绍如何结合 fun install 和 fun local invoke 进行附带 extension 的 PHP 项目开发和调试。Funfile 文件可以描述 extension 的安装命令,如果您有 Dockerfile 的使用经验,那你会发现两者使用体验非常类似。虽然这里只举了一个 mongodb 的示例,但是这个示例是比较完整的,对于其他类似需要安装 PHP extension 的场景也同样适用。
参考阅读
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
【云栖号案例 | 教育与科研机构】科研机构上云提供更加精准分析检测服务
云栖号案例库:【点击查看更多上云案例】不知道怎么上云?看云栖号案例库,了解不同行业不同发展阶段的上云方案,助力你上云决策! 公司介绍 武汉某科研机构是国内最早提供地球化学测试专业服务的第三方实验室之一,提供碎样、磨片、单矿物分选、制靶、透反射、阴极发光、XRF全岩主量元素分析等测试服务。 独立的实验室支持机构,为地质、矿产、材料行业科研及生产单位提供快速、专业、精准的微量元素分析检测服务和产品支持。 客户痛点 本地现有一台物理机,由于本地机房使用年限较长,性能方面已经无法满足,现有业务为企业内部实验数据和企业官网,对云服务没有过多了解,担心在云上数据备份丢失,想充分利用本地已有物理机实现数据实时备份。 想采购ECS服务器,像本地一样所有业务都部署到一台服务器上。 解决方案 有两个业务,因预算有限无法承担高防产品,考虑业务安全性。将两个业务进行拆分,购买两台ECS分别部署,避免网站被DDOS等攻击时影响企业系统。 企业系统都是生产类数据,有部分数据较为机密,对数据安全有一定要求,所以就搭配上了数据库,因为通过内网访问较为安全,并且提供数据的秒级恢复以及防暴力破解,通过SSL实现数据加密传...
- 下一篇
云存储网关"NFS V4优化"选项详解
背景 阿里云云存储网关支持以传统文件访问协议(NFS/SMB)来访问阿里云对象存储服务,网关通过暴露一个文件共享来和后端的OSS Bucket映射。用户操作对应的文件共享也就相当于在相应的OSS Bucket上进行操作,大大的便利了习惯于传统文件协议的用户。 NFS网络文件系统是在Linux机器上通用的一种文件系统,允许用户能够以本地文件系统类似的方式通过网络来访问远端服务器上的文件。NFS自推出以来,历经了NFSv2、NFSv3、NFSv4几个版本,现在的Linux机器上基本都已经用的NFSv4的版本,NFSv3在一些稍微老些版本的机器上还有使用,NFSv2已经几乎没有人使用了。 云存储网关是支持以NFSv3和NFSv4两个版本的协议来进行访问的,为了使这两个版本都能支持(主要是为了兼顾NFSv3的支持),在实现方面实际上有些权衡,导致默认情况下数据上传到OSS Bucket的效率对NFSv4协议来说其实不是最优的。这也就是为什么引入“NFS V4优化“这个选项的原因。 原理解析 使用过云存储网关的用户应该都知道,在用户写入一个文件到云存储网关的NFS共享里面之后,云存储网关会在后台...
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
推荐阅读
最新文章
- CentOS关闭SELinux安全模块
- SpringBoot2初体验,简单认识spring boot2并且搭建基础工程
- SpringBoot2整合Redis,开启缓存,提高访问速度
- MySQL8.0.19开启GTID主从同步CentOS8
- Hadoop3单机部署,实现最简伪集群
- 设置Eclipse缩进为4个空格,增强代码规范
- CentOS7,CentOS8安装Elasticsearch6.8.6
- Linux系统CentOS6、CentOS7手动修改IP地址
- CentOS6,7,8上安装Nginx,支持https2.0的开启
- Windows10,CentOS7,CentOS8安装MongoDB4.0.16