dl

(PHP 4, PHP 5, PHP 7, PHP 8)

dl — 運(yùn)行時(shí)載入一個(gè) PHP 擴(kuò)展

說(shuō)明

dl(string $extension_filename): bool

載入指定參數(shù) extension_filename 的 PHP 擴(kuò)展。

使用 extension_loaded() 來(lái)測(cè)試指定的擴(kuò)展是否已經(jīng)激活。 這既能用于內(nèi)建的擴(kuò)展也可以用于動(dòng)態(tài)加載的擴(kuò)展（既可以通過(guò) php.ini 也可以通過(guò) dl()）。

警告

在 PHP 5.3 里，此函數(shù)被某些 SAPI 移除了。

參數(shù)

extension_filename

此參數(shù)僅僅是要加載的擴(kuò)展的文件名，依賴于你的平臺(tái)。 比如，sockets（作為共享模塊編譯，而不是默認(rèn)的?。┰?Unix 平臺(tái)上稱為 sockets.so 而 在 Windows 平臺(tái)上是 php_sockets.dll。

擴(kuò)展加載的目錄依賴于你的平臺(tái)：

Windows - 如果沒(méi)有在 php.ini 里明確設(shè)置，擴(kuò)展默認(rèn)會(huì)從 C:\php5\ 加載。

Unix - 如果沒(méi)有在 php.ini 里明確設(shè)置，默認(rèn)的擴(kuò)展目錄依賴于

  • PHP 是否通過(guò) --enable-debug 選項(xiàng)構(gòu)建
  • PHP 是否以（實(shí)驗(yàn)性質(zhì)的）ZTS （Zned 線程安全）支持構(gòu)建
  • 當(dāng)前的內(nèi)部 ZEND_MODULE_API_NO（Zend 內(nèi)部模塊 API 數(shù)字，基本上是主要模塊修改時(shí)的日期）
考慮到上述，目錄默認(rèn)為 <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 設(shè)置）將導(dǎo)致一個(gè) E_ERROR 并中斷執(zhí)行。 如果因?yàn)橹付ǖ膸?kù)無(wú)法加載而導(dǎo)致 dl() 失敗，除了返回 false，還會(huì)產(chǎn)生一個(gè) E_WARNING 的消息。

范例

示例 #1 dl() 例子

<?php
// 加載一個(gè)擴(kuò)展的例子，基于操作系統(tǒng)
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 平臺(tái)上，dl() 是大小寫敏感的。

參見(jiàn)