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

Внимание

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

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

library

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

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

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

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 (доступна с PHP 4.3.0)
if (!extension_loaded('sqlite')) {
    $prefix = (PHP_SHLIB_SUFFIX === 'dll') ? 'php_' : '';
    dl($prefix . 'sqlite.' . PHP_SHLIB_SUFFIX);
}
?>

Список изменений

Версия	Описание
5.3.0	dl() выключен в некоторых SAPI в связи с нестабильностью работы. Из SAPI, поддерживающих dl(), остались только CLI и Embed. Используйте вместо dl Директивы загрузки расширений.

Примечания

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

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

Замечание: Эта функция недоступна в безопасном режиме.

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

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

Вернуться к: PHP опции/Информационные Функции