« cli\_set\_process\_titleextension\_loaded »PHP ManualОпції PHP/інформаційні функції

dl

(PHP 4, PHP 5, PHP 7, PHP 8)

dl — Завантажує PHP під час виконання

Опис

dl(string $extension_filename): bool

Завантажує модуль PHP, заданий аргументом extension_filename

Щоб перевірити, чи заданий модуль вже завантажений, використовуйте функцію extension_loaded(). Функція працює як для вбудованих модулів, так і для динамічно завантажених (тобто завантажених як через php.ini, так і через dl()

Увага

Функція доступна лише для CLI та вбудованого SAPI, а також для CGI SAPI під час запуску з командного рядка.

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

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()

Loading...

Примітки

Зауваження :

dl() чутлива до регістру на Unix-платформах.

Дивіться також