(PHP 4, PHP 5, PHP 7)
dl — 运行时载入一个 PHP 扩展
$library
)
载入指定参数 library
的 PHP 扩展。
使用 extension_loaded() 来测试指定的扩展是否已经激活。 这既能用于内建的扩展也可以用于动态加载的扩展(既可以通过 php.ini 也可以通过 dl())。
在 PHP 5.3 里,此函数被某些 SAPI 移除了。
library
此参数仅仅是要加载的扩展的文件名,依赖于你的平台。 比如,sockets(作为共享模块编译,而不是默认的!)在 Unix 平台上称为 sockets.so 而 在 Windows 平台上是 php_sockets.dll。
扩展加载的目录依赖于你的平台:
Windows - 如果没有在 php.ini 里明确设置,扩展默认会从 C:\php4\extensions\ (PHP 4) 或 C:\php5\ (PHP 5)加载。
Unix - 如果没有在 php.ini 里明确设置,默认的扩展目录依赖于
成功时返回 TRUE
, 或者在失败时返回 FALSE
。 如果加载模块的功能是无效或者禁用的(既可以通过设置关闭 enable_dl 设置,也可以通过启用 php.ini 里的 安全模式)将导致一个 E_ERROR
并中断执行。
如果因为指定的库无法加载而导致 dl() 失败,除了返回 FALSE
,还会产生一个 E_WARNING
的消息。
Example #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 常量在 PHP 4.3.0 后有效
if (!extension_loaded('sqlite')) {
$prefix = (PHP_SHLIB_SUFFIX === 'dll') ? 'php_' : '';
dl($prefix . 'sqlite.' . PHP_SHLIB_SUFFIX);
}
?>