在php 5.1中, 擴(kuò)展之間的內(nèi)部依賴是可以強(qiáng)制性的. 由于擴(kuò)展可以靜態(tài)構(gòu)建到php中, 也可以構(gòu)建為共享對象動態(tài)加載, 因此強(qiáng)制依賴需要在兩個地方實現(xiàn).
第一個位置是你在本章課程中剛剛看到的config.m4文件中. 你可以使用PHP_ADD_EXTENSION_DEP(extname, depname[ , optional])宏標(biāo)識extname這個擴(kuò)展依賴于depname這個擴(kuò)展. 當(dāng)extname以靜態(tài)方式構(gòu)建到php中時, ./configure腳本將使用這一行代碼確認(rèn)depname必須首先初始化. optional參數(shù)是一個標(biāo)記, 用來標(biāo)識depname如果也是靜態(tài)構(gòu)建的, 應(yīng)該在extname之前加載, 不過它并不是必須的依賴.
這個宏的一個使用示例是pdo驅(qū)動, 比如pdo_mysql是可預(yù)知依賴于pdo擴(kuò)展的:
ifdef([PHP_ADD_EXTENDION_DEP],
[
PHP_ADD_EXTENSION_DEP(pdo_mysql, pdo)
])
要注意PHP_ADD_EXTENSION_DEP()宏被包裹到一個ifdef()結(jié)構(gòu)中. 這是因為pdo和它的驅(qū)動在編譯大于或等于5.0版本的php時都是存在的, 然而PHP_ADD_EXTENSION_DEP()宏是直到5.1.0版本才出現(xiàn)的.
另外一個你需要注冊依賴的地方是zend_module_entry結(jié)構(gòu)體中. 考慮下面第5章中你定義的zend_module_entry結(jié)構(gòu)體:
zend_module_entry sample_module_entry = {
#if ZEND_MODULE_API_NO >= 20010901
STANDARD_MODULE_HEADER,
#endif
PHP_SAMPLE_EXTNAME,
php_sample_functions,
NULL, /* MINIT */
NULL, /* MSHUTDOWN */
NULL, /* RINIT */
NULL, /* RSHUTDOWN */
NULL, /* MINFO */
#if ZEND_MODULE_API_NO >= 20010901
PHP_SAMPLE_EXTVER,
#endif
STANDARD_MODULE_PROPERTIES
};
增加運行時模塊依賴信息就需要對STANDARD_MOUDLE_HEADER部分進(jìn)行一些小修改:
zend_module_entry sample_module_entry = {
#if ZEND_MODULE_API_NO >= 220050617
STANDARD_MODULE_HEADER_EX, NULL,
php_sample_deps,
#elif ZEND_MODULE_API_NO >= 20010901
STANDARD_MODULE_HEADER,
#endif
PHP_SAMPLE_EXTNAME,
php_sample_functions,
NULL, /* MINIT */
NULL, /* MSHUTDOWN */
NULL, /* RINIT */
NULL, /* RSHUTDOWN */
NULL, /* MINFO */
#if ZEND_MODULE_API_NO >= 20010901
PHP_SAMPLE_EXTVER,
#endif
STANDARD_MODULE_PROPERTIES
};
現(xiàn)在, 如果ZEND_MODULE_API_NO高于php 5.1.0 beta發(fā)布版, 則STANDARD_MODULE_HEADER(譯注: 這里原著筆誤為STANDARD_MODULE_PROPERTIES)將被替換為略微復(fù)雜的結(jié)構(gòu), 它將包含一個指向模塊依賴信息的引用.
這個目標(biāo)結(jié)構(gòu)體可以在你的zend_module_entry結(jié)構(gòu)體上面定義如下:
#if ZEND_MODULE_API_NO >= 220050617
static zend_module_dep php_sample_deps[] = {
ZEND_MODULE_REQUIRED("zlib")
{NULL,NULL,NULL}
};
#endif
和zend_function_entry向量類似, 這個列表可以有多項依賴, 按照順序進(jìn)行檢查. 如果嘗試加載某個依賴模塊未滿足, Zend將會中斷加載, 報告不滿足依賴的名字, 這樣, 終端用戶就可以通過首先加載其他模塊來解決問題.