dl

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

dl — 运行时载入一个 PHP 扩展

说明

dl(string $library): bool

载入指定参数 library 的 PHP 扩展。

使用 extension_loaded() 来测试指定的扩展是否已经激活。   这既能用于内建的扩展也可以用于动态加载的扩展（既可以通过也可以通过 dl()）。

警告  

在 PHP 5.3 里，此函数被某些 SAPI 移除了。

参数

• library

• 此参数仅仅是要加载的扩展的文件名，依赖于你的平台。       比如，sockets（作为共享模块编译，而不是默认的！）在 Unix 平台上称为而 在 Windows 平台上是。

  扩展加载的目录依赖于你的平台：

  Windows - 如果没有在里明确设置，扩展默认会从加载。

  Unix - 如果没有在里明确设置，默认的扩展目录依赖于

  考虑到上述，目录默认为 <install-dir>/lib/php/extensions/ <debug-or-not>-<zts-or-not>-ZEND_MODULE_API_NO，例如或。

  
  

•  PHP 是否通过 --enable-debug 选项构建        

•  PHP 是否以（实验性质的）ZTS （Zned 线程安全）支持构建        

•  当前的内部 ZEND_MODULE_API_NO（Zend 内部模块 API 数字，基本上是主要模块修改时的日期）        

返回值

成功时返回 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);
}
?>

注释

注意:

当 PHP 以支持 ZTS 构建时，不支持 dl()。    使用 扩展加载指令 作为替代。

注意:

在某些 Unix 平台上，dl() 是大小写敏感的。

参见

• 扩展加载指令

• extension_loaded() - 检查一个扩展是否已经加载