PHP擴展編寫點滴技巧收集

更新時間：2010年03月09日 21:34:20 作者：

PHP擴展好的資源不多，轉(zhuǎn)的這個朋友應該是個高手。他在實踐中摸索出來的這些經(jīng)驗和大家分享。

紅色部分是我的注釋。
更多信息參看：

1.常用的通用功能已經(jīng)封裝好了，在如zen_API.h 頭文件中，不用費力查看內(nèi)部細節(jié)，浪費時間。（參考：Extending and Embedding PHP 的附錄A）
2.在terminal中運行測試程序，可以看到擴展的內(nèi)部錯誤輸出，這一點對于解決內(nèi)存泄漏問題尤其重要。（編譯一個debug 的 lib）
3.開發(fā)過程中修改Makefile中的“CFLAGS = -g -O2”，去掉優(yōu)化選項，增加-Wall和-pedantic，便于調(diào)試和顯示編譯警告；
4.某zval*，但其strval非拷貝的，不可用zval_ptr_dtor(zval**)，要用efree(void*)。
5.terminal中的$_SERVER['PWD']有值，但是無法通過zend_getenv()取得，原因應該是該值無意義或不可靠。
6.調(diào)用“導出函數(shù)”，可利用INTERNAL_FUNCTION_PARAM_PASSTHRU傳參；聲明的非導出函數(shù)可通過INTERNAL_FUNCTION_PARAM使用“導出函數(shù)”的參數(shù)。
7.注意：RETURN_TYPE用在選擇分之和循環(huán)等處時，最好置于花括號中，
或者不用分號，因為：#define RETURN_BOOL(b) { RETVAL_BOOL(b); return; }。
8.如果函數(shù)的參數(shù)是引用的，且非標量，要先析構(gòu)，以防內(nèi)存泄露。
9.拋出異常前最好判斷EG(exception)中是否已經(jīng)存在異常，否則會造成內(nèi)存泄露。
10.當Web服務器API是ISAPI (IIS)的時候，zend_getenv函數(shù)是不起作用的。
11.向zend_stack_push()傳入數(shù)據(jù)指針，實際存儲(copy)的是該指針指向的數(shù)據(jù)，換句話說，傳入的應該是要存儲的數(shù)據(jù)的指針。
ZEND_API int zend_stack_push(zend_stack *stack, void *element, int size);
ZEND_API int zend_stack_top(zend_stack *stack, void **element);
其中，size == sizeof(*element);
類似地，zend_hash也是如此，比較zend_hash_update和zend_hash_find。
12.使用add_assoc_zval(HashTable*, const char*, zval*)存儲的是zval*，而非zval，因此，
存儲用戶傳入的參數(shù)時候，要先拷貝一份新的zval，否則會發(fā)生不可預料的事情。
13.zval_dtor(zval*)釋放變量及其內(nèi)部的引用內(nèi)存，zval_ptr_dtor(zval**)先檢查refcount
再決定是否調(diào)用zval_dtor(zval*)，zval_copy_dtor(zval*)僅執(zhí)行深層的拷貝，即只拷貝
起內(nèi)部引用的內(nèi)存，而不拷貝zval；

14.如使用VC編譯win的動態(tài)鏈接庫，而且代碼中調(diào)用了zend函數(shù)，如zend_getenv，在zend.h中定義為：

extern "C" {
extern ZEND_API char *(*zend_getenv)(char *name, size_t name_len TSRMLS_DC);
}
需要引入該函數(shù)，如要使用ZEND_API，需要事先取消LIBZEND_EXPORTS（包括VC“設置”中的預處理定義），或者使用ZEND_DLIMPORT，
ZEND_DLIMPORT char *(*zend_getenv)(char *name, size_t name_len TSRMLS_DC);
下面取自：zend_config.w32.h

復制代碼代碼如下:

 
#ifdef LIBZEND_EXPORTS 
# define ZEND_API __declspec(dllexport) 
#else 
# define ZEND_API __declspec(dllimport) 
#endif 
#define ZEND_DLEXPORT __declspec(dllexport) 
#define ZEND_DLIMPORT __declspec(dllimport) 

executor_globals_id也需要作如下聲明：
ZEND_DLIMPORT int executor_globals_id；
（這個比較有用，如果你要手工編譯某些擴展的時候，比如我在編譯sqlite3這個擴展的時候，就遇到這個問題。）