dl
(PHP 4, PHP 5, PHP 7, PHP 8)
dl — 執行時載入一個 PHP 擴充套件
說明
dl(string
$extension_filename): bool
載入指定參數 extension_filename 的 PHP 擴充套件。
使用 extension_loaded() 來測試指定的擴充套件是否已經啟用。 這既能用於內建的擴充套件也可以用於動態載入的擴充套件（既可以通過 php.ini 也可以通過 dl()）。
警告
在 PHP 5.3 里，此函式被某些 SAPI 移除了。
參數
-
extension_filename -
此參數僅僅是要載入的擴充套件的檔名，依賴於你的平臺。 比如，sockets（作為共享模組編譯，而不是預設的！）在 Unix 平臺上稱為 sockets.so 而 在 Windows 平臺上是 php_sockets.dll。
擴充套件載入的目錄依賴於你的平臺：
Windows - 如果沒有在 php.ini 里明確設定，擴充套件預設會從 C:\php5\ 載入。
Unix - 如果沒有在 php.ini 里明確設定，預設的擴充套件目錄依賴於
-
PHP 是否通過
--enable-debug選項構建 - PHP 是否以（實驗性質的）ZTS （Zned 執行緒安全）支援構建
-
目前的內部
ZEND_MODULE_API_NO（Zend 內部模組 API 數字，基本上是主要模組修改時的日期）
<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。 -
PHP 是否通過
返回值
成功時返回 true， 或者在失敗時返回 false。 如果載入模組的功能是無效或者禁用的（可以關閉 enable_dl 設定）將導致一個 E_ERROR 並中斷執行。
如果因為指定的庫無法載入而導致 dl() 失敗，除了返回 false，還會產生一個 E_WARNING 的訊息。
範例
示例 #1 dl() 例子
<?php
// 載入一個擴充套件的例子，基於操作系統
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() 是大小寫敏感的。