PHP dl 信息/选项函数



  • 定义和用法

    dl - 运行时载入一个 PHP 扩展
    注意:当 PHP 以支持 ZTS 构建时,不支持 dl。 使用 扩展加载指令 作为替代。
    注意:在某些 Unix 平台上,dl 是大小写敏感的。
    注意: 当 PHP 运行在安全模式时,不能使用此函数。
  • 版本支持

    PHP4 PHP5 PHP7
    支持 支持 支持
    7.0.0 PHP-FPM 模式下已禁用 dl()
    5.3.9 尽管不推荐,但 PHP-FPM 模式下启用了 dl()
    5.3.0 由于稳定性,dl() 在某些 SAPI 中被禁用。仅仅允许 dl() 的 SAPI 为 CLI 和 Embed。 使用 扩展加载指令作为替代。
  • 语法

    dl( string $library )
    
    dl() 载入指定参数 library 的 PHP 扩展。 使用 extension_loaded() 来测试指定的扩展是否已经激活。 这既能用于内建的扩展也可以用于动态加载的扩展(既可以通过 php.ini 也可以通过 dl() )。
    在 PHP 5.3 里,此函数被某些 SAPI 移除了。
  • 参数

    参数 必需的 描述
    library 此参数仅仅是要加载的扩展的文件名,依赖于你的平台。 比如,sockets(作为共享模块编译,而不是默认的!)在 Unix 平台上称为 sockets.so 而 在 Windows 平台上是 php_sockets.dll。 扩展加载的目录依赖于你的平台:
    • Windows - 如果没有在 php.ini 里明确设置,扩展默认会从 C:\php5\ 加载。
    • Unix - 如果没有在 php.ini 里明确设置,默认的扩展目录依赖于
    1 PHP 是否通过 --enable-debug 选项构建
    2 PHP 是否以(实验性质的)ZTS (Zned 线程安全)支持构建
    3 当前的内部 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。
  • 返回值

    成功时返回 TRUE, 或者在失败时返回 FALSE。 如果加载模块的功能是无效或者禁用的(既可以通过设置关闭 enable_dl 设置,也可以通过启用 php.ini 里的 安全模式)将导致一个 E_ERROR 并中断执行。 如果因为指定的库无法加载而导致 dl() 失败,除了返回 FALSE,还会产生一个 E_WARNING 的消息。
  • 示例

    // 加载一个扩展的例子,基于操作系统
    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);
    }
    
  • 相关页面

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