dl

(PHP 4, PHP 5, PHP 7)

dl — Загружает расширение PHP во время выполнения

Описание

dl ( string $extension_filename ) : bool

Загружает PHP-расширение заданное аргументом extension_filename.

Чтобы проверить, что заданное расширение уже загружено, используйте функцию extension_loaded(). Эта функция работает как для встроенных расширений, так и для динамически загруженных (т.е. загруженных как через php.ini, так и через dl()).

Внимание

Эта функция удалена из некоторых SAPI в PHP 5.3.0 и удалена из PHP-FPM в PHP 7.0.0.

Список параметров

extension_filename

Этот аргумент содержит только имя файла расширения, которое требуется загрузить. Это имя зависит от платформы. Например, расширение sockets (если скомпилировано, как загружаемый модуль, а не модуль по умолчанию!) будет называться sockets.so на Unix-платформах, и php_sockets.dll в среде Windows.

Директория, из которой расширение должно быть загружено также зависит от платформы:

Windows - Если явно не задано в php.ini, расширение будет грузиться из C:\php5\ по умолчанию.

Unix - Если явно не задано в php.ini, директория по умолчанию зависит от

PHP собран с настройкой --enable-debug или без нее
PHP собран с (экспериментальной) поддержкой ZTS (Zend Thread Safety) или нет
текущий внутренний номер ZEND_MODULE_API_NO (номер внутреннего модуля Zend API, который, как правило, является датой основного изменения API модуля, например 20010901)

Принимая во внимание вышесказанное, получаем следующие умолчания для директории расширения <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 в случае возникновения ошибки. Если механизм загрузки модулей недоступен или отключен (значение off настройки enable_dl в php.ini), будет выдана ошибка 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);
}
?>

Примечания

Замечание:
dl() не поддерживается в PHP собранных с поддержкой ZTS. Используйте директивы загрузки расширений вместо dl.

Замечание:
dl() чувствительна к регистру на Unix-платформах.

Смотрите также

Директивы загрузки расширений
extension_loaded() - Определить, загружено ли расширение