開發函數計算的正確姿式———爲 PHP 運行時添加自定義擴展

時間  2020-02-28
標籤 開發 函數 計算 正確 php 運行時 添加 自定義 擴展 欄目 PHP 简体版
原文   原文鏈接

PHP 語言提供了一種擴展機制（Extension），經過 PHP 擴展能夠加強語法、調用 C/C++ 實現的庫函數以及優化執行性能。PHP 擴展是與平臺相關的動態連接庫，在 Linux 和 Mac 平臺是 .so 文件，在 Windows 平臺是 .dll 文件。因爲函數計算的開發一般在 Mac 和 Windows 平臺，而運行時是 Linux（Debain）環境，因此爲函數計算 PHP 運行時添加擴展會遇到因爲動態連接庫平臺相關而致使要麼本地沒法調試，要麼遠端沒法運行的問題。本文介紹藉助 Funcraft 工具提供的模擬環境進行 PHP 擴展的安裝、本地運行調試以及構建發佈。 php

準備工做

依賴工具

本項目是在 MacOS 下開發的，涉及到的工具是平臺無關的，對於 Linux 和 Windows 桌面系統應該也一樣適用。在開始本例以前請確保以下工具已經正確的安裝，更新到最新版本，並進行正確的配置。html

Fun 和 Fcli 工具依賴於 docker 來模擬本地環境。 對於 MacOS 用戶可使用 homebrew 進行安裝：前端

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

Windows 和 Linux 用戶安裝請參考：linux

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

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

注意, 若是你已經安裝過了 fun，確保 fun 的版本在 3.6.1 以上。github

$ fun --version
3.6.1

PHP 自定義擴展

在函數代碼目錄建立一個名爲 extension 的目錄，而且將擴展對應的 .ini 和 .so 文件放在 extension 目錄下。例如，如下爲一個 hello 的自定義擴展，假設該擴展裏有一份 hello_world 函數：算法

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

hello.inimongodb

extension=/code/extension/hello.so

main.phpdocker

<?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.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

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

  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

安裝之後會多處一個 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 的場景也一樣適用。

參考閱讀

  1. Funcraft
  2. fc-db 開源項目
  3. Funfile 功能介紹
  4. 函數計算- PHP 運行環境- 自定義擴展

加入咱們

團隊介紹

阿里雲函數服務是一個全新的，支持事件驅動編程模式的計算服務。 他幫助用戶聚焦自身業務邏輯，以 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

「阿里巴巴雲原生技術圈關注微服務、Serverless、容器、Service Mesh 等技術領域、聚焦雲原生流行技術趨勢、雲原生大規模的落地實踐，作最懂雲原生開發者的技術圈。」

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程