從PHP源碼目錄結(jié)構(gòu)的介紹以及PHP生命周期可知：嵌入式PHP類似CLI，也是SAPI接口的另一種實(shí)現(xiàn)。 一般情況下，它的一個(gè)請(qǐng)求的生命周期也會(huì)和其它的SAPI一樣：模塊初始化=>請(qǐng)求初始化=>處理請(qǐng)求=>關(guān)閉請(qǐng)求=>關(guān)閉模塊。 當(dāng)然，這只是理想情況。因?yàn)樘囟ǖ膽?yīng)用由自己特殊的需求，只是在處理PHP腳本這個(gè)環(huán)節(jié)基本一致。

對(duì)于嵌入式PHP或許我們了解比較少，或者說(shuō)根本用不到，甚至在網(wǎng)上相關(guān)的資料也不多， 例如很多游戲中使用Lua語(yǔ)言作為粘合語(yǔ)言，或者作為擴(kuò)展游戲的腳本語(yǔ)言，類似的， 瀏覽器中的Javascript語(yǔ)言就是嵌入在瀏覽器中的。只是目前很少有應(yīng)用將PHP作為嵌入語(yǔ)言來(lái)使用， PHP的強(qiáng)項(xiàng)目前還是在Web開(kāi)發(fā)方面。

PHP對(duì)于嵌入式PHP的支持以及PHP為嵌入式提供了哪些接口或功能呢？首先我們看下所要用到的示例源碼：

#include <sapi/embed/php_embed.h>#ifdef ZTS void ***tsrm_ls;#endif/* Extension bits */zend_module_entry php_mymod_module_entry = { STANDARD_MODULE_HEADER, 'mymod', /* extension name */ NULL, /* function entries */ NULL, /* MINIT */ NULL, /* MSHUTDOWN */ NULL, /* RINIT */ NULL, /* RSHUTDOWN */ NULL, /* MINFO */ '1.0', /* version */ STANDARD_MODULE_PROPERTIES};/* Embedded bits */static void startup_php(void){ int argc = 1; char *argv[2] = { 'embed5', NULL }; php_embed_init(argc, argv PTSRMLS_CC); zend_startup_module(&php_mymod_module_entry);}static void execute_php(char *filename){ zend_first_try {char *include_script;spprintf(&include_script, 0, 'include ’%s’', filename);zend_eval_string(include_script, NULL, filename TSRMLS_CC);efree(include_script); } zend_end_try();}int main(int argc, char *argv[]){ if (argc <= 1) {printf('Usage: embed4 scriptfile';);return -1; } startup_php(); execute_php(argv[1]); php_embed_shutdown(TSRMLS_CC); return 0;}

以上的代碼可以在《Extending and Embedding PHP》在第20章找到（原始代碼有一個(gè)符號(hào)錯(cuò)誤，有興趣的童鞋可以去圍觀下）。 上面的代碼是一個(gè)嵌入式PHP運(yùn)行器（我們權(quán)當(dāng)其為運(yùn)行器吧），在這個(gè)運(yùn)行器上我們可以運(yùn)行PHP代碼。 這段代碼包括了對(duì)于PHP嵌入式支持的聲明，啟動(dòng)嵌入式PHP運(yùn)行環(huán)境，運(yùn)行PHP代碼，關(guān)閉嵌入式PHP運(yùn)行環(huán)境。 下面我們就這段代碼分析PHP對(duì)于嵌入式的支持做了哪些工作。 首先看下第一行：

#include <sapi/embed/php_embed.h>

在sapi目錄下的embed目錄是PHP對(duì)于嵌入式的抽象層所在。在這里有我們所要用到的函數(shù)或宏定義。 如示例中所使用的php_embed_init，php_embed_shutdown等函數(shù)。

第2到4行：

#ifdef ZTS void ***tsrm_ls;#endif

ZTS是Zend Thread Safety的簡(jiǎn)寫，與這個(gè)相關(guān)的有一個(gè)TSRM（線程安全資源管理）的東東，這個(gè)后面的章節(jié)會(huì)有詳細(xì)介紹，這里就不再作闡述。

第6到17行：

zend_module_entry php_mymod_module_entry = { STANDARD_MODULE_HEADER, 'mymod', /* extension name */ NULL, /* function entries */ NULL, /* MINIT */ NULL, /* MSHUTDOWN */ NULL, /* RINIT */ NULL, /* RSHUTDOWN */ NULL, /* MINFO */ '1.0', /* version */ STANDARD_MODULE_PROPERTIES};

以上PHP內(nèi)部的模塊結(jié)構(gòu)聲明，此處對(duì)于模塊初始化，請(qǐng)求初始化等函數(shù)指針均為NULL， 也就是模塊在初始化及請(qǐng)求開(kāi)始結(jié)束等事件發(fā)生的時(shí)候不執(zhí)行任何操作。 不過(guò)這些操作在sapi/embed/php_embed.c文件中的php_embed_shutdown等函數(shù)中有體現(xiàn)。 關(guān)于模塊結(jié)構(gòu)的定義在zend/zend_modules.h中。

startup_php函數(shù)：

static void startup_php(void){ int argc = 1; char *argv[2] = { 'embed5', NULL }; php_embed_init(argc, argv PTSRMLS_CC); zend_startup_module(&php_mymod_module_entry);}

這個(gè)函數(shù)調(diào)用了兩個(gè)函數(shù)php_embed_init和zend_startup_module完成初始化工作。 php_embed_init函數(shù)定義在sapi/embed/php_embed.c文件中。它完成了PHP對(duì)于嵌入式的初始化支持。 zend_startup_module函數(shù)是PHP的內(nèi)部API函數(shù)，它的作用是注冊(cè)定義的模塊，這里是注冊(cè)mymod模塊。 這個(gè)注冊(cè)過(guò)程僅僅是將所定義的zend_module_entry結(jié)構(gòu)添加到注冊(cè)模塊列表中。

execute_php函數(shù)：

static void execute_php(char *filename){ zend_first_try {char *include_script;spprintf(&include_script, 0, 'include ’%s’', filename);zend_eval_string(include_script, NULL, filename TSRMLS_CC);efree(include_script); } zend_end_try();}

從函數(shù)的名稱來(lái)看，這個(gè)函數(shù)的功能是執(zhí)行PHP代碼的。 它通過(guò)調(diào)用sprrintf函數(shù)構(gòu)造一個(gè)include語(yǔ)句，然后再調(diào)用zend_eval_string函數(shù)執(zhí)行這個(gè)include語(yǔ)句。 zend_eval_string最終是調(diào)用zend_eval_stringl函數(shù)，這個(gè)函數(shù)是流程是一個(gè)編譯PHP代碼， 生成zend_op_array類型數(shù)據(jù)，并執(zhí)行opcode的過(guò)程。 這段程序相當(dāng)于下面的這段php程序，這段程序可以用php命令來(lái)執(zhí)行，雖然下面這段程序沒(méi)有實(shí)際意義， 而通過(guò)嵌入式PHP中，你可以在一個(gè)用C實(shí)現(xiàn)的系統(tǒng)中嵌入PHP，然后用PHP來(lái)實(shí)現(xiàn)功能。

<?phpif($argc < 2) die('Usage: embed4 scriptfile');include $argv[1];?>

main函數(shù)：

int main(int argc, char *argv[]){ if (argc <= 1) {printf('Usage: embed4 scriptfile';);return -1; } startup_php(); execute_php(argv[1]); php_embed_shutdown(TSRMLS_CC); return 0;}

這個(gè)函數(shù)是主函數(shù)，執(zhí)行初始化操作，根據(jù)輸入的參數(shù)執(zhí)行PHP的include語(yǔ)句，最后執(zhí)行關(guān)閉操作，返回。 其中php_embed_shutdown函數(shù)定義在sapi/embed/php_embed.c文件中。它完成了PHP對(duì)于嵌入式的關(guān)閉操作支持。 包括請(qǐng)求關(guān)閉操作，模塊關(guān)閉操作等。

以上是使用PHP的嵌入式方式開(kāi)發(fā)的一個(gè)簡(jiǎn)單的PHP代碼運(yùn)行器，它的這些調(diào)用的方式都基于PHP本身的一些實(shí)現(xiàn)， 而針對(duì)嵌入式的SAPI定義是非常簡(jiǎn)單的，沒(méi)有Apache和CGI模式的復(fù)雜，或者說(shuō)是相當(dāng)簡(jiǎn)陋，這也是由其所在環(huán)境決定。 在嵌入式的環(huán)境下，很多的網(wǎng)絡(luò)協(xié)議所需要的方法都不再需要。如下所示，為嵌入式的模塊定義。

sapi_module_struct php_embed_module = { 'embed', /* name */ 'PHP Embedded Library',/* pretty name */ php_embed_startup, /* startup */ php_module_shutdown_wrapper, /* shutdown */ NULL, /* activate */ php_embed_deactivate, /* deactivate */ php_embed_ub_write, /* unbuffered write */ php_embed_flush,/* flush */ NULL, /* get uid */ NULL, /* getenv */ php_error, /* error handler */ NULL, /* header handler */ NULL, /* send headers handler */ php_embed_send_header, /* send header handler */ NULL, /* read POST data */ php_embed_read_cookies, /* read Cookies */ php_embed_register_variables, /* register server variables */ php_embed_log_message, /* Log message */ NULL, /* Get request time */ NULL, /* Child terminate */ STANDARD_SAPI_MODULE_PROPERTIES};/* }}} */

在這個(gè)定義中我們看到了若干的NULl定義，在前面一小節(jié)中說(shuō)到SAPI時(shí)，我們是以cookie的讀取為例， 在這里也有讀取cookie的實(shí)現(xiàn)——php_embed_read_cookies函數(shù)，但是這個(gè)函數(shù)的實(shí)現(xiàn)是一個(gè)空指針NULL。