PHP 語言提供了一種擴充套件機制（Extension），透過 PHP 擴充套件可以增強語法、呼叫 C/C++ 實現的庫函式以及最佳化執行效能。PHP 擴充套件是與平臺相關的動態連結庫，在 Linux 和 Mac 平臺是 .so 檔案，在 Windows 平臺是 .dll 檔案。由於[函式計算](https://statistics.functioncompute.com/?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&url=http%3A%2F%2Ffc.console.aliyun.com%2F%3Ffctraceid%3DYXV0aG9yJTNEJUU1JTgwJTlBJUU4JUI0JUE0JTI2dGl0bGUlM0QlRTUlQkMlODAlRTUlOEYlOTElRTUlODclQkQlRTYlOTUlQjAlRTglQUUlQTElRTclQUUlOTclRTclOUElODQlRTYlQUQlQTMlRTclQTElQUUlRTUlQTclQkYlRTUlOEElQkYlMjAlRTIlODAlOTQlRTIlODAlOTQlMjAlRTQlQjglQkElMjBQSFAlMjAlRTglQkYlOTAlRTglQTElOEMlRTYlOTclQjYlRTYlQjclQkIlRTUlOEElQTAlRTglODclQUElRTUlQUUlOUElRTQlQjklODklRTYlODklQTklRTUlQjElOTU%3D)的開發通常在 Mac 和 Windows 平臺，而執行時是 Linux（Debain）環境，所以為函式計算 PHP 執行時新增擴充套件會遇到由於動態連結庫平臺相關而導致要麼本地無法除錯，要麼遠端無法執行的問題。本文介紹藉助 Funcraft 工具提供的模擬環境進行 PHP 擴充套件的安裝、本地執行除錯以及構建釋出。
![](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 桌面系統應該也同樣適用。在開始本例之前請確保如下工具已經正確的安裝，更新到最新版本，並進行正確的配置。

- [Docker](https://www.docker.com/)
- [Fun](https://github.com/alibaba/funcraft)

Fun 和 Fcli 工具依賴於 docker 來模擬本地環境。
對於 MacOS 使用者可以使用 [homebrew](https://brew.sh/) 進行安裝：

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

Windows 和 Linux 使用者安裝請參考：

1. [https://github.com/aliyun/fun/blob/master/docs/usage/installation.md](https://github.com/alibaba/funcraft/blob/master/docs/usage/installation.md)
2. [https://github.com/aliyun/fcli/releases](https://github.com/aliyun/fcli/releases)

安裝好後，記得先執行 `fun config` 初始化一下配置。

**注意**, 如果你已經安裝過了 fun，確保 fun 的版本在 3.6.1 以上。

```bash
$ fun --version
3.6.1
```

## PHP 自定義擴充套件

在函式程式碼目錄建立一個名為 extension 的目錄，並且將擴充套件對應的 .ini 和 .so 檔案放在 extension 目錄下。例如，以下為一個 hello 的自定義擴充套件，假設該擴充套件裡有一份 hello_world 函式：

hello.ini

```ini
extension=/code/extension/hello.so
```

main.php

```php
 <?php function="" handler($event,="" $context)="" {="" var_dump(extension_loaded('hello'));="" hello_world();="" return="" "ok";="" }="" ```="" 上述方法是函式計算PHP="" 執行時提供的擴充套件方法。實踐過程中會碰到如下兩個問題：="" 1.="" .so="" 檔案應該如何構建出來，或者去哪裡下載="" 2.="" 有了="" 檔案後，本地如何除錯程式碼="" ##="" 完整示例="" 下面會基於借用="" [PHP="" 訪問="" MongoDB="" 的例子]()來介紹如何藉助於="" Funcraft="" 進行="" PHP="" 開發，因為="" composer="" 依賴="" mongodb/mongodb="" 需要安裝="" extension。="" 初始化專案="" ```bash="" #="" 建立工程目錄並進入="" $="" mkdir="" fc-mongodb="" &&="" cd="" 初始化="" fun="" init="" event-php7.2="" ###="" 透過="" Funfile="" 安裝="" 我們在="" Linux="" 平臺下通常會透過="" [pecl](https://zh.wikipedia.org/wiki/Pecl)="" 工具進行="" 的擴充套件安裝。比如="" `pecl="" install="" mongodb`。該命令會觸發原始碼下載、編譯並複製到系統="" 目錄。pecl="" 需要執行在="" 環境中才能裝linux="" 版本的="" 檔案。在函式計算這裡可以透過="" 機制進行安裝。="" 新建一個="" 檔案，內容如下：="" ```Dockerfile="" RUNTIME="" php7.2="" RUN="" apt-get="" update="" -y="" libcurl4-openssl-dev="" pkg-config="" libssl-dev="" pecl="" -p=""/>ode/extension && mv /usr/local/lib/php/extensions/*/mongodb.so /code/extension
RUN 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 結尾就好了。

然後執行

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

Install Success
```

安裝以後會多處一個 extension 目錄，包含 mongodb.so 和 mongodb.ini 檔案

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

### 安裝 mongodb 依賴

執行下面命令透過 composer 安裝依賴 'mongodb/mongodb'

```bash
$ 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 目錄

```bash
╰─➜  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
<?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 資料庫

```bash
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` 環境變數。

```bash
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` 本地模擬執行

```bash
$ 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](https://marketplace.visualstudio.com/items?itemName=aliyun.aliyun-serverless)，如下圖

![](https://img.alicdn.com/tfs/TB1y3viwhD1gK0jSZFKXXcJrVXa-1852-1232.png)

### 釋出並呼叫

請將 template.yml 配置檔案中的 `MONGO_DATABASE` 和 `MONGO_URL` 環境變數更新為您線上系統的相應配置，然後釋出

```bash
$ 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 的場景也同樣適用。

## 參考閱讀

1. [Funcraft](https://github.com/alibaba/funcraft)
2. [fc-db 開源專案](https://github.com/vangie/fc-db)
3. [Funfile 功能介紹](https://yq.aliyun.com/articles/719100)
4. [函式計算- PHP 執行環境- 自定義擴充套件](https://help.aliyun.com/document_detail/89032.html#using-customextension)

## 加入我們

### 團隊介紹

阿里雲函式服務是一個全新的，支援事件驅動程式設計模式的計算服務。 他幫助使用者聚焦自身業務邏輯，以 Serverless的方式構建應用，快速的實現低成本，可擴充套件，高可用的系統，而無需考慮伺服器等底層基礎設施的管理。 使用者能夠快速的建立原型，同樣的架構能隨業務規模平滑伸縮。讓計算變得更高效，更經濟，更彈性，更可靠。無論小型創業公司，還是大型企業，都受益其中。我們的團隊正在迅速擴張，求賢若渴。我們想尋找這樣的隊友：
基本功紮實。既能閱讀論文追蹤業界趨勢，又能快速編碼解決實際問題。
嚴謹的，系統化的思維能力。既能整體考慮業務機會，系統架構，運維成本等諸多因素，又能掌控設計/開發/測試/釋出的完整流程，預判並控制風險。
好奇心和使命感驅動。樂於探索未知領域，不僅是夢想家，也是踐行者。
堅韌、樂觀、自信。能在壓力和困難中看到機會，讓工作充滿樂趣！
如果您對雲端計算充滿熱情，想要構建一個有影響力計算平臺和生態體系，請加入我們，和我們一起實現夢想!

### 職位描述

構建新一代 Serverless 計算平臺，包括：

1. 設計和實現完整可擴充套件的前端系統，包括身份驗證/許可權管理，後設資料管理，流量控制，計量計費，日誌監控等等
2. 設計和實現彈性可靠的後端系統，包括資源排程，負載均衡，容錯處理等等
3. 豐富易用的 SDK/Tools/CLI/控制檯
4. 使用者需求驅動，追蹤業界趨勢，利用技術推動業務的成長

### 職位要求

1. 演算法/資料結構/作業系統等基礎知識紮實，優秀的邏輯思維能力。
2. 至少掌握一門程式語言。例如 Java/Go/C/C#/C++。
3. 有大規模、高可用分散式系統開發經驗者優先。
4. 有 Web/Mobile Backends/Microservice 開發經驗者優先。
5. 良好的溝通能力和團隊合作精神，有一定的組織協調能力。
6. 本科及以上學歷
7. 3 年以上工作經驗，透過“阿里巴巴編碼規範” 認證的同學優先錄取，認證地址：https://edu.aliyun.com/certification/cldt02

### 簡歷提交

yixian.dw AT alibaba-inc.com

>“[阿里巴巴雲原生技術圈](https://developer.aliyun.com/group/alisoftwaretech/)關注微服務、Serverless、容器、Service Mesh 等技術領域、聚焦雲原生流行技術趨勢、雲原生大規模的落地實踐，做最懂雲原生開發者的技術圈。”</?php>

開發函式計算的正確姿勢———為 PHP 執行時新增自定義擴充套件

相關文章