开发函数计算的正确姿势，为PHP运行时添加自定义扩展

其他 2020-03-06 15:48:46 阅读次数: 0

PHP 语言提供了一种扩展机制（Extension），通过 PHP 扩展可以增强语法、调用 C/C++ 实现的库函数以及优化执行性能。PHP 扩展是与平台相关的动态链接库，在 Linux 和 Mac 平台是 .so 文件，在 Windows 平台是 .dll 文件。由于函数计算的开发通常在 Mac 和 Windows 平台，而运行时是 Linux（Debain）环境，所以为函数计算 PHP 运行时添加扩展会遇到由于动态链接库平台相关而导致要么本地无法调试，要么远端无法运行的问题。本文介绍借助 Funcraft 工具提供的模拟环境进行 PHP 扩展的安装、本地运行调试以及构建发布。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-94siVwka-1583133453951)(https://data-analysis.cn-shanghai.log.aliyuncs.com/logstores/article-logs/track_ua.gif?APIVersion=0.6.0&title=%E5%BC%80%E5%8F%91%E5%87%BD%E6%95%B0%E8%AE%A1%E7%AE%97%E7%9A%84%E6%AD%A3%E7%A1%AE%E5%A7%BF%E5%8A%BF%20%E2%80%94%E2%80%94%20%E4%B8%BA%20PHP%20%E8%BF%90%E8%A1%8C%E6%97%B6%E6%B7%BB%E5%8A%A0%E8%87%AA%E5%AE%9A%E4%B9%89%E6%89%A9%E5%B1%95&author=%E5%80%9A%E8%B4%A4&src=article)]

准备工作

依赖工具

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

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

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-WwNmjVBd-1583133453952)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-q2Mavfqv-1583133453952)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

Windows 和 Linux 用户安装请参考：

  1. https://github.com/aliyun/fun/blob/master/docs/usage/installation.md
  2. https://github.com/aliyun/fcli/releases

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

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

$ fun --version
3.6.1

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-k5UB7ZgB-1583133453954)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-3D2gN7Oi-1583133453954)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

PHP 自定义扩展

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

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sLCztvv7-1583133453954)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-TZjrlgjz-1583133453955)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

hello.ini

extension=/code/extension/hello.so

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-7rs1pJ1o-1583133453956)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-UHCJ289r-1583133453957)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

main.php

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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-TjmDyAlk-1583133453958)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-2n7VSgf0-1583133453960)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

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

  1. .so 文件应该如何构建出来，或者去哪里下载
  2. 有了 .so 文件后，本地如何调试代码

完整示例

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

初始化项目

# 创建工程目录并进入
$ mkdir fc-mongodb && cd fc-mongodb

# 初始化
$ fun init event-php7.2

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-LGRQpJUR-1583133453961)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-qPNCM8br-1583133453962)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

通过 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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-7RyonBOo-1583133453964)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-gO3aZYcl-1583133453965)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

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

  1. 第一行先声明是一个 php7.2 版本的 Runtime，
  2. 接着安装 构建 mongodb 所需要的依赖，这里主要是为了装 openssl，为了能让 mongodb 扩展库支持 ssl，以解决连接时的一个报错。所有
  3. 通过 pecl 下载、构建并且安装 mongodb 扩展
  4. 将 mongodb 扩展拷贝到 /code/extendsion 目录，该目录是函数计算约定的 extension 目录
  5. 生成 mongodb.int 文件，这里文件名是随意的，只需要 .ini 结尾就好了。

然后执行

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

Install Success

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-7RHvrLUh-1583133453965)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-q6GOWwPi-1583133453967)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

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

╰─➜  tree
.
├── Funfile
├── extension
│   ├── mongodb.ini
│   └── mongodb.so
├── index.php
└── template.yml

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-zNOFdGh4-1583133453968)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-SA4uvbsq-1583133453968)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

安装 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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-qSR828Bt-1583133453971)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Ef300EOB-1583133453974)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

安装成功后会在代码目录多处 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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-RZ2p3p4U-1583133453975)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-KMSLMg87-1583133453976)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

本地调试

更新 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;
}

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-HhE7NV9L-1583133453976)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-4CSpqwRb-1583133453977)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

借助 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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-094xd5M6-1583133453977)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-lCtUZabG-1583133453978)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

更新 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:[email protected]:27017/admin

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-E0D6GZgH-1583133453978)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-dOSKWCEA-1583133453979)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

使用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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-PJm1YVgN-1583133453980)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-O8FPpE4u-1583133453982)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

如果希望本地断点调试可以使用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

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Spu5sDfR-1583133453983)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==)][外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-eLfZbKOb-1583133453983)(data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw== “点击并拖拽以移动”)]

最使用fun invoke命令验证调用结果。

小结

本文主要介绍如何结合 fun install 和 fun local invoke 进行附带 extension 的 PHP 项目开发和调试。Funfile 文件可以描述 extension 的安装命令，如果您有 Dockerfile 的使用经验，那你会发现两者使用体验非常类似。虽然这里只举了一个 mongodb 的示例，但是这个示例是比较完整的，对于其他类似需要安装 PHP extension 的场景也同样适用。

查看更多：https://yqh.aliyun.com/detail/6390?utm_content=g_1000105890

上云就看云栖号：更多云资讯，上云案例，最佳实践，产品入门，访问：https://yqh.aliyun.com/

阿里云技术
发布了1216 篇原创文章 · 获赞 84 · 访问量 20万+
他的留言板 关注

猜你喜欢

转载自blog.csdn.net/weixin_43970890/article/details/104612341
今日推荐
《美国对全球网络空间安全与发展的威胁和破坏》报告发布
火速冲上 GitHub 热榜 —— 开源编程语言、框架哪有这么可爱？
北京人形机器人创新中心发布全球首个纯电驱拟人奔跑的全尺寸人形机器人“天工”
LFOSSA 源来如此公开课 | 掌握云原生未来：CNCF 认证全面攻略与备考秘籍
周排行
让自己的头脑极度开放
CentOS 6.5(x64) 和Redhat6.5操作系误删libc
高可用注册中心
【日记】12.28/【题解】AtCoder AGC041
XML（5）_XML 约束_DTD
Java集合Map（四）
树梅派安装桌面环境教程
pipenv 的 使用和安装
小程序白屏问题和内存研究
C语言简单选择排序
每日归档
更多
2024-05-02(0)
2024-05-01(4)
2024-04-30(1)
2024-04-29(40)
2024-04-28(0)
2024-04-27(56)
2024-04-26(39)
2024-04-25(22)
2024-04-24(36)
2024-04-23(26)

代码天地 © 2018 codetd.com

境外服务器   最新电视剧2022