inclued擴展 · PHP筆記

在運行時跟蹤并轉儲文件包含和類繼承的層次結構。可以使用[include](https://www.php.net/manual/en/function.include.php)，[include\_once](https://www.php.net/manual/en/function.include-once.php)，[require](https://www.php.net/manual/en/function.require.php)或[require\_once](https://www.php.net/manual/en/function.require-once.php)[包括](https://www.php.net/manual/en/function.include.php)文件。還報告了類繼承依賴性 ## 要求 PHP版本5.1.0或更高版本。5.4+不再維護隨附的gengraph.php文件使用[?graphviz](http://www.graphviz.org/)庫，但是，這不是必需的。 [https://pecl.php.net/package/inclued](https://pecl.php.net/package/inclued) 這些功能的行為受php.ini中的設置影響。 **包括配置選項** | 名稱 | 默認 | 可修改范圍 | 描述 | | --- | --- | --- | --- | |[inclued.enabled](https://www.php.net/manual/en/inclued.configuration.php#ini.inclued.enabled) | 關 | PHP\_INI\_SYSTEM | ?是否啟用包含。 | |[inclued.dumpdir](https://www.php.net/manual/en/inclued.configuration.php#ini.inclued.dumpdir) | **`NULL`** | PHP\_INI\_SYSTEM | ?存儲包含文件的目錄的位置（路徑）。如果設置，則每個PHP請求都將創建一個文件。這些文件是[inclued\_get\_data（）](https://www.php.net/manual/en/function.inclued-get-data.php)會生成的序列化版本，因此可以使用unserialize（）進行反序列化因為每個請求都會創建一個文件，所以該目錄可能會很快填滿！ | ## **inclued_get_data**(void)：數組 **示例** ``` include?'x.php'; $clue?=?inclued_get_data(); print_r($clue); ``` 上面的示例將輸出類似于以下內容的內容： ~~~ 數組（ [includes] =>數組（ [0] =>數組（ [操作] =>包含 [op_type] => 2 [文件名] => x.php [opened_pa??th] => /tmp/x.php [fromfile] => /tmp/z.php [fromline] => 2 ））） ~~~ 有關使用此數據創建圖形的方法，請參見下面的例子。 ## **實現包含在應用程序中的示例** 本示例演示了將其包含到現有應用程序中并查看結果的過程。 **Example＃1在PHP應用程序本身中獲取數據（函數）** ``` //?File?to?store?the?inclued?information $fp?=?fopen('/tmp/wp.ser',?'w'); if?($fp)?{ ????$clue?=?inclued_get_data(); ????if?($clue)?{ ????????fwrite($fp,?serialize($clue)); ????} ????fclose($fp); } ``` 現在已經存在一些數據，現在該以圖形的形式來理解它們了。包含的擴展名包括一個名為gengraph.php的PHP文件，該文件創建一個需要[?graphviz](http://www.graphviz.org/)庫的點文件。但是，此表格不是必需的。 **Example＃2 gengraph.php使用示例** 本示例創建一個名為inclued.png的圖像，其中顯示了包含的數據。 ~~~ ＃首先，創建點文件 $ php gengraph.php -i /tmp/wp.ser -o wp.dot ＃接下來，創建圖像 $ dot -Tpng -o inclued.png wp.dot ~~~ **Example＃3通過包含的轉儲列出數據（配置）** 當使用[inclued.dumpdir](https://www.php.net/manual/en/inclued.configuration.php#ini.inclued.dumpdir)指令時，每個請求都將轉儲文件（包括線索）。這是列出這些文件并反[序列化（）](https://www.php.net/manual/en/function.unserialize.php)的一種方法。 ``` $path?=?ini_get('inclued.dumpdir'); if?($path?&&?is_dir($path))?{ ????echo?"Path:?$path",?PHP_EOL; ????$inclues?=?new?GlobIterator($path?.?DIRECTORY_SEPARATOR?.?'inclued*'); ????if?($inclues->count()?===?0)?{ ????????echo?'No?clues?today',?PHP_EOL; ????????exit; ????} ????foreach?($inclues?as?$inclue)?{ ????????echo?'Inclued?file:?',?$inclue->getFilename(),?PHP_EOL; ????????$data?=?file_get_contents($inclue->getPathname()); ????????if?($data)?{ ????????????$inc?=?unserialize($data); ????????????echo?'?--?filename:?',?$inc['request']['SCRIPT_FILENAME'],?PHP_EOL; ????????????echo?'?--?number?of?includes:?',?count($inc['includes']),?PHP_EOL; ????????} ????????echo?PHP_EOL; ????} }?else?{ ????echo?'I?am?totally?clueless?today.',?PHP_EOL; } ``` 上面的示例將輸出類似于以下內容的內容： ~~~ 路徑：/ tmp /包含包含的文件：includ.56521.1 -文件名：/Users/philip/test.php -包含的數量：1 包含的文件：includ.56563.1 -文件名：/tmp/none.php -包含的數量：0 包含的文件：incleded.56636.1 -文件名：/tmp/three.php -數量包括：3 ~~~