文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

为PHP运行时如何添加自定义扩展

2023-06-04 13:49

关注

这篇文章将为大家详细讲解有关为PHP运行时如何添加自定义扩展,小编觉得挺实用的,因此分享给大家做个参考,希望大家阅读完这篇文章后可以有所收获。

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

准备工作

依赖工具

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

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

brew cask install dockerbrew tap vangie/formulabrew install funbrew install fcli

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 --version3.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 运行时提供的扩展方法。实践过程中会碰到如下两个问题:

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

  2. 有了 .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.2RUN apt-get update && apt-get install -y libcurl4-openssl-dev pkg-config libssl-devRUN pecl install mongodbRUN mkdir -p /code/extension && mv /usr/local/lib/php/extensions/*/mongodb.so /code/extensionRUN echo "extension=/code/extension/mongodb.so" > /code/extension/mongodb.ini

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

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

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

  3. 通过 pecl 下载、构建并且安装 mongodb 扩展

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

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

然后执行

fun install -f phpusing 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.ymlskip pulling image aliyunfc/runtime-php7.2:build-1.9.0...Using version ^1.6 for mongodb/mongodb./composer.json has been createdLoading composer repositories with package informationUpdating dependencies (including require-dev)Package operations: 1 install, 0 updates, 0 removals  - Installing mongodb/mongodb (1.6.0): Downloading (100%)         Writing lock fileGenerating 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 文件

<?phprequire '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_DATABASEMONGO_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 invokeusing template: template.ymlMissing invokeName argument, Fun will use the first function fc-mongodb/fc-mongodb as invokeNameskip pulling image aliyunfc/runtime-php7.2:1.9.2...FunctionCompute php7.2 runtime inited.FC Invoke Start RequestId: b1764771-896b-4c27-9ad8-6c325cc3d749Inserted 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,如下图

为PHP运行时如何添加自定义扩展

发布并调用

请将 template.yml 配置文件中的 MONGO_DATABASEMONGO_URL 环境变量更新为您线上系统的相应配置,然后发布

$ fun deployusing template: template.ymlusing region: cn-shanghaiusing accountId: ***********4733using accessKeyId: ***********EUz3using timeout: 60Collecting 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. YesWaiting 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 successservice fc-mongodb deploy success

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

关于“为PHP运行时如何添加自定义扩展”这篇文章就分享到这里了,希望以上内容可以对大家有一定的帮助,使各位可以学到更多知识,如果觉得文章不错,请把它分享出去让更多的人看到。

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯