(PHP 4, PHP 5, PHP 7, PHP 8)
dl — 運行時(shí)載入一個(gè) PHP 擴展
$extension_filename
): bool
載入指定參數 extension_filename
的 PHP 擴展。
使用 extension_loaded() 來(lái)測試指定的擴展是否已經(jīng)激活。 這既能用于內建的擴展也可以用于動(dòng)態(tài)加載的擴展(既可以通過(guò) php.ini 也可以通過(guò) dl())。
在 PHP 5.3 里,此函數被某些 SAPI 移除了。
extension_filename
此參數僅僅是要加載的擴展的文件名,依賴(lài)于你的平臺。 比如,sockets(作為共享模塊編譯,而不是默認的?。┰?Unix 平臺上稱(chēng)為 sockets.so 而 在 Windows 平臺上是 php_sockets.dll。
擴展加載的目錄依賴(lài)于你的平臺:
Windows - 如果沒(méi)有在 php.ini 里明確設置,擴展默認會(huì )從 C:\php5\ 加載。
Unix - 如果沒(méi)有在 php.ini 里明確設置,默認的擴展目錄依賴(lài)于
--enable-debug
選項構建
ZEND_MODULE_API_NO
(Zend 內部模塊 API 數字,基本上是主要模塊修改時(shí)的日期)
<install-dir>/lib/php/extensions/ <debug-or-not>-<zts-or-not>-ZEND_MODULE_API_NO
,例如
/usr/local/php/lib/php/extensions/debug-non-zts-20010901
或
/usr/local/php/lib/php/extensions/no-debug-zts-20010901。
成功時(shí)返回 true
, 或者在失敗時(shí)返回 false
。 如果加載模塊的功能是無(wú)效或者禁用的(可以關(guān)閉 enable_dl 設置)將導致一個(gè) E_ERROR
并中斷執行。
如果因為指定的庫無(wú)法加載而導致 dl() 失敗,除了返回 false
,還會(huì )產(chǎn)生一個(gè) E_WARNING
的消息。
示例 #1 dl() 例子
<?php
// 加載一個(gè)擴展的例子,基于操作系統
if (!extension_loaded('sqlite')) {
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
dl('php_sqlite.dll');
} else {
dl('sqlite.so');
}
}
// 或者,使用常量 PHP_SHLIB_SUFFIX
if (!extension_loaded('sqlite')) {
$prefix = (PHP_SHLIB_SUFFIX === 'dll') ? 'php_' : '';
dl($prefix . 'sqlite.' . PHP_SHLIB_SUFFIX);
}
?>
注意:
在某些 Unix 平臺上,dl() 是大小寫(xiě)敏感的。