Php/docs/function.dl
dl
(PHP 4, PHP 5, PHP 7)
dl — 运行时载入一个 PHP 扩展
说明
dl
( string $library
) : bool
载入指定参数 library
的 PHP 扩展。
使用 extension_loaded() 来测试指定的扩展是否已经激活。
这既能用于内建的扩展也可以用于动态加载的扩展(既可以通过 php.ini
也可以通过 dl())。
Warning 在 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
。-
PHP 是否通过
返回值
成功时返回 true
, 或者在失败时返回 false
。 如果加载模块的功能是无效或者禁用的(可以关闭 enable_dl 设置)将导致一个 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 if (!extension_loaded('sqlite')) { $prefix = (PHP_SHLIB_SUFFIX === 'dll') ? 'php_' : ; dl($prefix . 'sqlite.' . PHP_SHLIB_SUFFIX);}?>