本文介紹PHP如何實現(xiàn)并應用函數實例生命周期回調方法。
背景信息
當您實現(xiàn)并配置函數實例生命周期回調后，函數計算將在相關實例生命周期事件發(fā)生時調用對應的回調程序。函數實例生命周期涉及Initializer、PreFreeze和PreStop三種回調。當前PHP運行時支持Initializer和PreStop兩種函數實例生命周期回調函數。更多信息，請參見函數實例生命周期回調。
函數實例生命周期回調程序與正常調用請求計費規(guī)則一致，但其執(zhí)行日志只能在函數日志、實例日志或高級日志中查詢，調用請求列表不會展示回調程序日志。具體操作，請參見查看實例生命周期回調函數日志。
Initializer回調
Initializer示例
初始化回調程序（Initializer回調）在函數實例啟動成功之后，運行請求處理程序（Handler）之前執(zhí)行。函數計算保證在一個實例生命周期內，成功且最多成功執(zhí)行一次Initializer回調。例如，您的Initializer回調第一次執(zhí)行失敗后系統(tǒng)會重試，直到成功為止，然后再執(zhí)行您的請求處理程序。因此，您在實現(xiàn)Initializer回調時，需要保證其被重復調用時的正確性。
Initializer回調只有一個$context輸入參數，使用方法和事件請求處理程序一樣。
一個最簡單的Initializer回調如下所示。
<?php
function my_initializer($context) {
$logger = $GLOBALS['fcLogger'];
$logger->info("hello world");
}
?> my_initializer是Initializer回調方法名，需要與您在函數計算控制臺配置的Initializer 回調程序相對應。例如，您為函數配置的Initializer 回調程序為main.my_initializer，那么函數計算在配置Initializer屬性后會去加載main.php中定義的my_initializer方法。
方法簽名
- 輸入參數只有
context，包含的信息和事件請求處理程序（handler）的context保持一致。 context中initializer和initializationTimeout兩個信息是為Initializer回調設計，如果使用Initializer功能，會被分別設置為您為函數配置的Initializer 回調程序和Initializer 回調超時時間的值，否則為空，且不生效。- 無返回值。
PreStop回調
預停止回調程序（PreStop回調）在函數實例銷毀前執(zhí)行，方法簽名同Initializer回調。
<?php
$counter = 0;
function preStop($context) {
$GLOBALS['fcLogger']->info("preStop ok");
}
function handler($event, $context) {
global $counter;
$counter += 2;
return $counter;
}
?><funcName> AND <ServiceName> AND qualifier: <VERSION>配置生命周期回調函數
通過控制臺配置
[文件名.方法名]，例如：
- Initializer 回調程序設置為
index.initialize，表示index.php文件中的initialize方法。 - PreStop 回調程序設置為
index.preStop，表示index.php文件中的preStop方法。
通過Serverless Devs工具配置
s.yaml配置文件中添加Initializer 回調程序和PreStop 回調程序。
- Initializer回調配置
在function配置下添加initializer和initializationTimeout兩個字段。
- PreStop回調配置
在function配置下添加instanceLifecycleConfig.preStop字段，包括handler和timeout兩個字段。
具體的示例如下所示。
edition: 1.0.0 # 命令行YAML規(guī)范版本，遵循語義化版本（Semantic Versioning）規(guī)范
name: hello-world-app # 項目名稱
access: default # 密鑰別名
vars:
region: cn-hangzhou
service:
name: php72-mysql # service名稱
description: 'hello world by serverless devs' # Service的簡短描述
services:
helloworld: # 業(yè)務名稱/模塊名稱
component: fc
props:
region: ${vars.region}
service: ${vars.service}
function:
name: php72-mysql # function名稱
description: 'hello world by serverless devs' # function的簡短描述
runtime: php7.2 # 運行時
codeUri: ./code # 代碼位置
handler: index.handler # function執(zhí)行的入口，具體格式和語言相關
memorySize: 128 # function的內存規(guī)格
timeout: 60 # function運行的超時時間
initializationTimeout: 20 # 初始化方法超時時間
initializer: index.initialize # 初始化方法
instanceLifecycleConfig: # 擴展函數
preStop: # PreStop函數
handler: index.pre_stop # 函數入口
timeout: 20 # 超時時間關于Serverless Devs的YAML配置規(guī)范，請參見Serverless Devs操作命令。
查看實例生命周期回調函數日志
您可以通過函數日志功能查看回調函數日志。
示例程序
函數計算為您提供了使用Initializer回調和PreStop回調的MySQL示例程序。在本示例中，Initializer回調函數用于從環(huán)境變量中獲取MySQL數據庫配置，創(chuàng)建MySQL連接并測試連通性，PreStop回調函數負責關閉MySQL連接。
詳細信息，請參見php72-mysql。