准备工作
本项目是在 MacOS 下开发的,涉及到的工具是平台无关的,对于 Linux 和 Windows 桌面系统应该也同样适用。在开始本例之前请确保如下工具已经正确的安装,更新到最新版本,并进行正确的配置。
Fun 和 Fcli 工具依赖于 docker 来模拟本地环境。
对于 MacOS 用户可以使用 homebrew 进行安装:
brew cask install docker
brew tap vangie/formula
brew install fun
brew install fcli
Windows 和 Linux 用户安装请参考:
安装好后,记得先执行 fun config
初始化一下配置。
注意, 如果你已经安装过了 fun,确保 fun 的版本在 3.6.1 以上。
$ fun --version
3.6.1
在函数代码目录创建一个名为 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 运行时提供的扩展方法。实践过程中会碰到如下两个问题:
下面会基于借用 [PHP 访问 MongoDB 的例子]()来介绍如何借助于 Funcraft 进行 PHP 开发,因为 composer 依赖 mongodb/mongodb 需要安装 extension。
初始化项目
# 创建工程目录并进入
$ mkdir fc-mongodb && cd fc-mongodb
# 初始化
$ fun init event-php7.2
我们在 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
逐行解释一下上面五行指令
然后执行
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
执行下面命令通过 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
命令验证调用结果。
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。