Ошибка 'Unable to load dynamic library' в PHP: способы исправления

Подробные примеры и их результаты

Ниже приведены расширенные сценарии, иллюстрирующие диагностику и исправление ошибки загрузки динамических библиотек PHP.

Пример 1: Проверка и настройка extension_dir

Выполнить команду для определения текущего каталога расширений:

php -i | grep extension_dir

Возможный вывод:

extension_dir => /usr/lib/php/20200930 => /usr/lib/php/20200930

Проверить наличие файла расширения, например, mysqli.so:

ls -la /usr/lib/php/20200930/mysqli.so

Если файл отсутствует, вывод будет:

ls: cannot access '/usr/lib/php/20200930/mysqli.so': No such file or directory

Тогда установите пакет или скопируйте правильную версию в этот каталог.

Пример 2: Установка расширения через apt с указанием версии PHP

Предположим, используется PHP 8.2. Установить модуль pdo_mysql:

sudo apt install php8.2-mysql

После установки проверить, появился ли файл конфигурации:

ls /etc/php/8.2/cli/conf.d/ | grep mysql

Результат:

20-mysqli.ini
20-pdo_mysql.ini

Убедиться, что расширения загружаются:

php -m | grep -i mysql

Вывод:

mysqli
pdo_mysql

Пример 3: Компиляция простого расширения "hello"

Создадим минимальное расширение на C. Исходный код (файл hello.c):

#include <php.h>
#include <ext/standard/info.h>

PHP_FUNCTION(hello_world) {
    php_printf("Hello, World!\n");
}

const zend_function_entry hello_functions[] = {
    PHP_FE(hello_world, NULL)
    PHP_FE_END
};

zend_module_entry hello_module_entry = {
    STANDARD_MODULE_HEADER,
    "hello",
    hello_functions,
    NULL,
    NULL,
    NULL,
    NULL,
    PHP_MINFO(hello),
    PHP_HELLO_VERSION,
    STANDARD_MODULE_PROPERTIES
};

#ifdef COMPILE_DL_HELLO
    ZEND_GET_MODULE(hello)
#endif

Создайте файл config.m4:

PHP_ARG_ENABLE(hello, whether to enable hello, [ --enable-hello Enable hello support])

if test "$PHP_HELLO" != "no"; then
    PHP_NEW_EXTENSION(hello, hello.c, $ext_shared)
fi

Выполните:

phpize
./configure --enable-hello
make -j4
sudo make install

Результат make install поместит hello.so в extension_dir. Добавьте в php.ini:

extension=hello.so

Проверка:

php -r 'hello_world();'

Ожидаемый вывод:

Hello, World!

Пример 4: Проверка и выбор Thread Safety для Windows

На Windows PHP имеет две версии. Определите текущую:

php -i | findstr "Thread Safety"

Вывод:

Thread Safety => enabled

Скачайте расширение xdebug для PHP 8.2 TS x64. Пусть файл называется php_xdebug-3.3.1-8.2-ts-vs16-x64.dll. Скопируйте его в ext (обычно C:\php\ext). Добавьте в php.ini:

zend_extension=C:\php\ext\php_xdebug-3.3.1-8.2-ts-vs16-x64.dll

Проверьте загрузку:

php -v

Если версия несовместима, появится предупреждение об ошибке загрузки. В таком случае загрузите NTS-версию, если PHP без Thread Safety.

Пример 5: Отключение расширений для поиска конфликта

Предположим, после установки imagick возникает ошибка. Временно отключите все расширения, кроме core:

cd /etc/php/8.2/cli/conf.d/
sudo mkdir backup && sudo mv *.ini backup/

Затем включите только imagick:

sudo cp backup/20-imagick.ini .

Проверьте загрузку:

php -v

Если ошибка исчезла, конфликт с другим расширением. Включайте по одному.

Пример 6: Использование ldd для проверки зависимостей расширения

В Linux, если расширение загружается с ошибкой "undefined symbol", проверьте его зависимости:

ldd /usr/lib/php/20200930/imagick.so

Возможный вывод:

linux-vdso.so.1 (0x00007fffc4d5c000)
libMagickWand-7.Q16HDRI.so.7 => not found
libMagickCore-7.Q16HDRI.so.7 => /usr/lib/x86_64-linux-gnu/libMagickCore-7.Q16HDRI.so.7 (0x00007f...)

Если какая-то библиотека не найдена (not found), установите соответствующую версию (например, libmagickwand-dev).