# 4.2 動手編譯PHP
第一章我們曾介紹過,PHP編譯前的configure有兩個特殊的選項,打開它們對我們開發PHP擴展或者進行PHP嵌入式開發時非常有幫助。但是當我們正常使用PHP的時候,則不應該開啟這兩個選項。
### --enable-debug
顧名思義,它的作用是激活調試模式。它將激活PHP源碼中幾個非常關鍵的函數,最典型的功能便是在每一個請求結束后給出這一次請求中內存的泄漏情況。
回顧一下第三章《內存管理》部分,php內核中的ZendMM( Zend Memory Manager)將會在每一個請求結束后強制釋放在這個請求中申請的內存。By running a series of aggressive regression tests against newly developed code, leak points can be easily spotted and plugged prior to any public release. Take a look at the following code snippet:
````c
void show_value(int n)
{
char *message = emalloc(1024);
sprintf(message, "The value of n is %d\n", n);
php_printf("%s", message);
}
````
上面的代碼執行后,將會導致1024B的內存泄漏,但是在ZendMM的幫助下,在請求結束后會被PHP內核自動的釋放掉。
但是如果你開啟了--enable-debug選項,在請求結束后內核便會給出一條信息,告知我們程序猿這次請求的內存泄漏情況。
/cvs/php5/ext/sample/sample.c(33) :Freeing 0x084504B8 (1024 bytes), script=-<br />
=== Total 1 memory leaks detected ===
這條提示告知我們在這次請求結束后,ZendMM清理了泄漏的內存以及泄漏的內存位置。在它的幫助下,我們可以很快的定位到有問題的代碼,然后通過efree等函數修正這個bug。
其實,內存泄漏并不是我們在開發中碰到的唯一錯誤,還有很多其它的bug很難被檢測出來。有時候這些bug是致命的,但很難定位到出問題的代碼。很多時候我們忙活了大半個晚上,修改了很多文件,最后make,但是當我們運行腳本的時候卻得到下面的段錯誤。
````c
$ sapi/cli/php -r 'myext_samplefunc();'
Segmentation Fault
//如果中文環境,則顯示段錯誤
````
Orz...錯誤出在哪呢?我們遍歷myext_samplefuc的所有實現代碼也沒有發現問題,扔進gdb里也僅僅顯示幾行無關緊要的信息而已。這種情況下,enable-debug就能幫你大忙了,打開這個選項后,你編譯出來的php則會嵌入gdb或其它文件需要的所有調試信息。現在我們重新編譯這個擴展,再扔進gdb里調試,便會得到如下的信息:
````c
#0 0x1234567 php_myext_find_delimiter(str=0x1234567 "foo@#(FHVN)@\x98\xE0...",
strlen=3, tsrm_ls=0x1234567)
p = strchr(str, ',');
````
現在所有的問題都水落石出了,字符串變量str沒有以NULL結尾,而我們卻把它當作一個參數傳給了二進制不安全的字符串處理函數,str將會掃描str知道找到NULL為止,它的掃描肯定是越界了,然后引發了一個段錯誤。找到問題根源后,我們只要用memchr來替換strchr函數就能修復這個bug了。
### --enable-maintainer-zts
第二個重要的參數便是激活php的線程安全機制(Thread Safe Resource Manager(TSRM)/Zend Thread Safety(ZTS)),使我們開發出的程序是線程安全的。對于TSRM的介紹大家可以參考第一章的介紹,在平時的開發中,建議打開這個選項。
### --enable-embed
其實還有一個選項比較重要,那就是enable-embed,它主要用在你做php的嵌入式開發的場景中。平時我們把php作為apache的一個module進行編譯,得到libphp5.so,而這個選項便使php編譯后得到一個與我們設定的SAPI相對應的結果。
## links
* 4.1 [編譯前的準備](<4.1.md>)
* 4.3 [Unix/Linux平臺下的編譯](<4.3.md>)
- about
- 開始閱讀
- 目錄
- 1 PHP的生命周期
- 1.讓我們從SAPI開始
- 2.PHP的啟動與終止
- 3.PHP的生命周期
- 4.線程安全
- 5.小結
- 2 PHP變量在內核中的實現
- 1. 變量的類型
- 2. 變量的值
- 3. 創建PHP變量
- 4. 變量的存儲方式
- 5. 變量的檢索
- 6. 類型轉換
- 7. 小結
- 3 內存管理
- 1. 內存管理
- 2. 引用計數
- 3. 總結
- 4 動手編譯PHP
- 1. 編譯前的準備
- 2. PHP編譯前的config配置
- 3. Unix/Linux平臺下的編譯
- 4. 在Win32平臺上編譯PHP
- 5. 小結
- 5 Your First Extension
- 1. 一個擴展的基本結構
- 2. 編譯我們的擴展
- 3. 靜態編譯
- 4. 編寫函數
- 5. 小結
- 6 函數返回值
- 1. 一個特殊的參數:return_value
- 2. 引用與函數的執行結果
- 3. 小結
- 7 函數的參數
- 1. zend_parse_parameters
- 2. Arg Info 與類型綁定
- 3. 小結
- 8 使用HashTable與{數組}
- 1. 數組(C中的)與鏈表
- 2. 操作HashTable的API
- 3. 在內核中操作PHP語言中數組
- 4. 小結
- 9 PHP中的資源類型
- 1. 復合類型的數據——{資源}
- 2. Persistent Resources
- 3. {資源}自有的引用計數
- 4. 小結
- 10 PHP中的面向對象(一)
- 1. zend_class_entry
- 2. 定義一個類
- 3. 定義一個接口
- 4. 類的繼承與接口的實現
- 5. 小結
- 11 PHP中的面向對象(二)
- 1. 生成對象的實例與調用方法
- 2. 讀寫對象的屬性
- 3. 小結
- 12 啟動與終止的那點事
- 2. 小結
- 1. 關于生命周期
- 2. MINFO與phpinfo
- 3. 常量
- 4. PHP擴展中的全局變量
- 5. PHP語言中的超級全局變量
- 6. 小結
- 13 INI設置
- 1. 聲明和訪問ini設置
- 2. 小結
- 2. 小結
- 14 流式訪問
- 1. 概覽
- 2. 打開流
- 3. 訪問流
- 4. 靜態資源操作
- 5. 小結
- 15 流的實現
- 1. php流的表象之下
- 2. 包裝器操作
- 3. 實現一個包裝器
- 4. 操縱
- 5. 檢查
- 6. 小結
- 16 有趣的流
- 1. 上下文
- 2. 過濾器
- 3. 小結
- 17 配置和鏈接
- 1. autoconf
- 2. 庫的查找
- 3. 強制模塊依賴
- 4. Windows方言
- 5. 小結
- 18 擴展生成
- 1. ext_skel
- 2. PECL_Gen
- 3. 小結
- 19 設置宿主環境
- 1. 嵌入式SAPI
- 2. 構建并編譯一個宿主應用
- 3. 通過嵌入包裝重新創建cli
- 4. 老技術新用
- 5. 小結
- 20 高級嵌入式
- 1. 回調到php中
- 2. 錯誤處理
- 3. 初始化php
- 4. 覆寫INI_SYSTEM和INI_PERDIR選項
- 5. 捕獲輸出
- 6. 同時擴展和嵌入
- 7. 小結
- 約定