运行时载入一个 PHP 扩展 dl

(PHP 4, PHP 5, PHP 7)

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

说明

dl(string $library): bool

载入指定参数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里明确设置,默认的扩展目录依赖于

  • 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

返回值

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

淘宝 adsense 商品推荐

谷歌 admob Adsense 代收Pin码 美国 香港 丰富地址代收 商务服务

价格:50元

范例

Example #1dl()例子

<?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);
}
?>

更新日志

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

注释

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

淘宝 云主机 商品推荐

远程电脑出租E3E5物理双路服务器租用云主机渲染模拟器虚拟机多开

价格:19元

参见

扩展加载指令

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