07-再次探討SAPI java api 1.8中文版 jquery api steam api64.dl

在PHP的生命週期的各個階段，一些與服務相關的操作都是透過SAPI介面實現。 這些內建實現的物理位置在PHP源碼的SAPI目錄。這個目錄存放了PHP對各個伺服器抽象層的程式碼， 例如命令列程式的實現，Apache的mod_php模組實作以及fastcgi的實作等等。

在各個伺服器抽象層之間遵守著相同的約定，這裡我們稱之為SAPI介面。 每個SAPI實作都是一個_sapi_module_struct結構體變數。 （SAPI介面）。 在PHP的源碼中，當需要呼叫伺服器相關資訊時，全部透過SAPI介面中對應方法呼叫實現， 而這對應的方法在各個伺服器抽象層實現時都會有各自的實現。

下面是為SAPI的簡單示意圖：

以cgi模式和apache2伺服器為例，它們的啟動方法如下：

<code>cgi_sapi_module.startup(&cgi_sapi_module)   //  cgi模式 cgi/cgi_main.c文件

apache2_sapi_module.startup(&apache2_sapi_module);
 //  apache2服务器  apache2handler/sapi_apache2.c文件
</code>

這裡的cgi_sapi_module是靜態變數的變數。 它的startup方法指向php_cgi_startup函數指標。在這個結構體中除了startup函數指針，還有許多其它方法或字段。 其部分定義如下：

<code>struct _sapi_module_struct {
    char *name;         //  名字（标识用）
    char *pretty_name;  //  更好理解的名字（自己翻译的）

    int (*startup)(struct _sapi_module_struct *sapi_module);    //  启动函数
    int (*shutdown)(struct _sapi_module_struct *sapi_module);   //  关闭方法

    int (*activate)(TSRMLS_D);  // 激活
    int (*deactivate)(TSRMLS_D);    //  停用

    int (*ub_write)(const char *str, unsigned int str_length TSRMLS_DC);
     //  不缓存的写操作(unbuffered write)
    void (*flush)(void *server_context);    //  flush
    struct stat *(*get_stat)(TSRMLS_D);     //  get uid
    char *(*getenv)(char *name, size_t name_len TSRMLS_DC); //  getenv

    void (*sapi_error)(int type, const char *error_msg, ...);   /* error handler */

    int (*header_handler)(sapi_header_struct *sapi_header, sapi_header_op_enum op,
        sapi_headers_struct *sapi_headers TSRMLS_DC);   /* header handler */

     /* send headers handler */
    int (*send_headers)(sapi_headers_struct *sapi_headers TSRMLS_DC);

    void (*send_header)(sapi_header_struct *sapi_header,
            void *server_context TSRMLS_DC);   /* send header handler */

    int (*read_post)(char *buffer, uint count_bytes TSRMLS_DC); /* read POST data */
    char *(*read_cookies)(TSRMLS_D);    /* read Cookies */

    /* register server variables */
    void (*register_server_variables)(zval *track_vars_array TSRMLS_DC);

    void (*log_message)(char *message);     /* Log message */
    time_t (*get_request_time)(TSRMLS_D);   /* Request Time */
    void (*terminate_process)(TSRMLS_D);    /* Child Terminate */

    char *php_ini_path_override;    //  覆盖的ini路径

    ...
    ...
};
</code>

以上的這些結構在各伺服器的介面實作中都有定義。如Apache2的定義：

<code>static sapi_module_struct apache2_sapi_module = {
    "apache2handler",
    "Apache 2.0 Handler",

    php_apache2_startup,                /* startup */
    php_module_shutdown_wrapper,            /* shutdown */

    ...
}
</code>

目前PHP內建的許多SAPI實作都已不再維護或變的有些非主流了，PHP社群目前正在考慮將一些SAPI移出程式碼庫。 社群對許多功能的考慮是除非真的非常必要，或者某些功能已近非常通用了，否則就在PECL庫中， 例如非常流行的APC快取擴充將進入核心程式碼庫中。

整個SAPI類似於一個物件導向中的模板方法模式的應用。 SAPI.c和SAPI.h檔案所包含的一些函數就是模板方法模式中的抽像模板， 各個伺服器對於sapi_module的定義及相關實作則是一個個具體的模板。

這樣的結構在PHP的原始碼中有多處使用， 例如在PHP擴充開發中，每個擴充都需要定義一個zend_module_entry結構體。 這個結構體的作用與sapi_module_struct結構體類似，都是類似模板方法模式的應用。 在PHP的生命週期中如果需要呼叫某個擴展，其呼叫的方法都是zend_module_entry結構體中指定的方法， 如在上一小節中提到的在執行各個擴展的請求初始化時，都是統一調用request_startup_func方法， 而在每個擴充的定義時，都透過巨集PHP_RINIT指定request_startup_func對應的函數。 以VLD擴展為例：其請求初始化為PHP_RINIT(vld),與之對應在擴展中需要有這個函數的實現：

<code>PHP_RINIT_FUNCTION(vld) {
}
</code>

所以， 我們在寫擴展時也需要實現擴展的這些接口，同樣，當實現各伺服器介面時也需要實現其對應的SAPI。

')​​.addClass('pre-numbering').hide(); $(this).addClass('has-numbering').parent().append($numbering); for (i = 1; i ').text(i)); }; $numbering.fadeIn(1700); }); });

以上就介紹了07-再次探討SAPI，包含了api,sap方面的內容，希望對PHP教學有興趣的朋友有所幫助。