12.2 MINFO與phpinfo · phpbook-PHP擴展開發及內核應用

# 12.2 MINFO與phpinfo # 12.2 MINFO與phpinfo 如果你并不打算做出一個只有你自己使用的擴展，那么你可以需要告訴用戶一些關于你的擴展信息。比如：其環境和特定版本的可用功能、版本信息、作者信息以便你在發生問題的時候可以尋求幫助、甚至可以加上一個LOGO等等。如果你仔細看過phpinfo()或者 php -i 的輸出，相信你已經注意到，所有這些信息會組合成一個格式良好的、易于解析輸出。你的擴展可以輕松地通過 MINFO (模塊信息)來添加這些塊，看個例子： ``` PHP_MINFO_FUNCTION(sample4) { php_info_print_table_start(); php_info_print_table_row(2, "Sample4 Module", "enabled"); php_info_print_table_row(2, "version", PHP_SAMPLE4_EXTVER); php_info_print_table_end(); } ``` 通過使用這些包裝的功能，你的模塊的信息將被自動包裹在HTML標簽中從一個網絡服務器SAPI （如CGI時，IIS ， APACHE，等等）輸出，或格式化使用CLI使用時，輸出明文和換行符。下面我們來介紹一下php*info*\*()系列的函數： ``` char *php_info_html_esc(char *str TSRMLS_DC) ``` 這個函數是php\_escape\_html\_entities()的一個封裝，htmlentites() 函數的底層實現。該函數返回的字符串通過emalloc()創建，并在使用后必須使用 efree()函數釋放掉。 ``` void php_info_print_table_start(void) void php_info_print_table_end(void) ``` 輸出開/關表格式所需的標簽。HTML輸出是與CLI輸出一樣，表現為一個簡單的換行。 ``` void php_info_print_table_header(int cols, ...) void php_info_print_table_colspan_header(int cols, char *header) ``` 輸出表頭行。第一個函數在可變參數列表中的char \*元素外面的每一列都會輸出一對th標簽，第二個函數會在指定列數外面輸出一對th標簽。 ``` void php_info_print_table_row(int cols, ...) void php_info_print_table_row_ex(int cols, char *class, ...) ``` 第一個函數在可變參數列表中的char \*元素外面的每一行都會輸出一對td標簽，第二個函數會在指定列數外面輸出一對td標簽；前者會自動添加一個"class=v"屬性（到 td標簽），后者允許傳遞一個自定義類名。當不在HTML中輸出的時候，兩個函數將沒有任何差別。 ``` void php_info_print_hr(void) ``` 這種函數將在HTML中輸出一個br標簽，或者一個表示行開始和結束的水平線我們常用的PHPWRITE()和php\_printf()函數可以在在MINFO函數中使用，你應該注意正確的信息輸出取決于當前的SAPI判斷是用純文本還是HTML的方式輸出要做到這一點，只需要檢查sapi\_module結構中的phpinfo\_as\_text屬性，例子如下： ``` PHP_MINFO_FUNCTION(sample4) { php_info_print_table_start(); php_info_print_table_row(2, "Sample4 Module", "enabled"); php_info_print_table_row(2, "version", PHP_SAMPLE4_EXTVER); if (sapi_module.phpinfo_as_text) { /* No HTML for you */ php_info_print_table_row(2, "By", "Example Technologies\nhttp://www.example.com"); } else { /* HTMLified version */ php_printf("<tr>" "<td class=\"v\">By</td>" "<td class=\"v\">" "<a href=\"http://www.example.com\"" " alt=\"Example Technologies\">" "<img src=\"http://www.example.com/logo.png\" />" "</a></td></tr>"); } php_info_print_table_end(); } ``` ## links - [目錄](preface.md) - 12.1 [關于生命周期](12.1.html) - 12.3 [常量](12.3.html)