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

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

PHP對于嵌入式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章找到（原始代碼有一個符號錯誤，有興趣的童鞋可以去圍觀下）。 上面的代碼是一個嵌入式PHP運行器（我們權(quán)當(dāng)其為運行器吧），在這個運行器上我們可以運行PHP代碼。 這段代碼包括了對于PHP嵌入式支持的聲明，啟動嵌入式PHP運行環(huán)境，運行PHP代碼，關(guān)閉嵌入式PHP運行環(huán)境。 下面我們就這段代碼分析PHP對于嵌入式的支持做了哪些工作。 首先看下第一行：

#include <sapi/embed/php_embed.h>

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

第2到4行：

#ifdef ZTS void ***tsrm_ls;#endif

ZTS是Zend Thread Safety的簡寫，與這個相關(guān)的有一個TSRM（線程安全資源管理）的東東，這個后面的章節(jié)會有詳細(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)聲明，此處對于模塊初始化，請求初始化等函數(shù)指針均為NULL， 也就是模塊在初始化及請求開始結(jié)束等事件發(fā)生的時候不執(zhí)行任何操作。 不過這些操作在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);}

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

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

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

以上是使用PHP的嵌入式方式開發(fā)的一個簡單的PHP代碼運行器，它的這些調(diào)用的方式都基于PHP本身的一些實現(xiàn)， 而針對嵌入式的SAPI定義是非常簡單的，沒有Apache和CGI模式的復(fù)雜，或者說是相當(dāng)簡陋，這也是由其所在環(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};/* }}} */

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