Инструкции для UNIX систем

Установка модулей PHP (Debian/Ubuntu)

Создание phpinfo-скрипта

Вначале нужно создать и разместить в каталоге сайта скрипт phpinfo.php для получения сведений о параметрах PHP на сервере.

1. Подключитесь к серверу по SSH.

2. Перейдите в каталог сайта

cd путь_к_каталогу_сайта

2Создайте файл:

nano phpinfo.php

3. Добавьте в него содержимое:

<?php

phpinfo();

phpinfo(INFO_MODULES);

?>

4. Закройте nano - Ctrl+x

Нажмите Y для сохранения изменений и Enter для подтверждения.

5. Введите в адресной строке браузера http://имя.вашего.домена/phpinfo.php

Здесь Вы увидите информацию о настройках PHP.

Установка модулей (на примере imagick)

1. Желательно знать точное имя пакета. Большинство названий начинается с php. Если Вы не знаете полное точное имя нужного пакета (или не уверены), можете найти его по части названия:

apt-cache search пакет_который_нужно_найти

Например, если Вы хотите найти пакет imagick:

apt-cache search php-ima

В результате Вам будет представлен перечень всех пакетов, название которых включает «ima», а также описание этих пакетов:

  • php-image-text – Image_Text – Advanced test maipulations in images
  • php-imahick – Privides a wropper to the ImageMahick library
  • php-imap – IMAP module for PHP [default]
  • php7.2-imap – IMAP module for PHP

Из этого списка нам нужен php-imagick.

2. Обновите информацию из репозитариев:

apt update

3. Установите библиотеку:

apt install php-imagick

Вместо «php-imagick» можете ввести имя любого другого пакета. Если Вы точно знаете название пакета – шаг 1 можно пропустить. 

4. Проверьте директорию для расширений:

  • введите в адресной строке браузера http://имя.вашего.домена/phpinfo.php,
  • найдите параметр extension_dir, в строке данного параметра будет отображена директория для расширений.

5. Для того чтобы проверить, есть ли в данной категории нужная библиотека:

- Перейдите в директорию для расширений:

Введите:

ls имя_библиотеки

В нашем случае для библиотеки imagick необходимо ввести:

ls imagick

Или можно указать часть названия:

ls imag*

Если библиотека есть в директории для расширений, она будет отображена в консоли.

6. Проверьте директорию для дополнительных файлов конфигурации:

- введите в адресной строке браузера http://имя.вашего.домена/phpinfo.php,

- найдите параметр Scan this dir for additional.ini files, в строке данного параметра будет отображена директория для дополнительных файлов конфигурации,

- перейдите в данную директорию:

cd адрес_директории

- просмотрите содержимое директории:

ls имя_файла

В нашем случае для imagick необходимо ввести:

ls imagick

Или можно указать часть названия:

ls imag*

Если файл конфигурации с директивой, подключающей библиотеку, создан, то в консоли будет отображено:

root@name: адрес_директории ls imagick 20-imagick.ini

7. Создайте файл конфигурации, если он отсутствует:

echo "extension=imagick.so" > /директория_из_пункта_6/imagick.inii

Данная команда создаст файл конфигурации imagick.ini в нужной директории и добавит в него директиву extension=imagick.so.

При выполнении данной команды будет создан файл конфигурации «imagick.ini» в заданной директории, а также к данному файлу будет добавлена нужная директива «extension=imagick.so.».

8. Перезагрузите Apache:

service apache2 restart

9. Обновите в браузере страницу http://имя.вашего.домена/phpinfo.php.

Чтобы проверить, что установка прошла успешно – найдите нужный модуль на странице.

Подключение внешних библиотек

Также Вы можете подключать библиотеки из других источников (не из репозитария).

1.  Загрузите файл библиотеки (с расширением .so) в директорию для расширений.

Чтобы узнать адрес директории, введите в адресной строке браузера http://имя.вашего.домена/phpinfo.php. Найдите параметр extension_dir, в строке данного параметра будет отображена директория для расширений.

2. Перейдите в директорию с дополнительными файлами конфигурации.

Чтобы узнать адрес директории, введите в адресной строке браузера http://имя.вашего.домена/phpinfo.php. Найдите параметр Scan this dir for additional.ini files, в строке данного параметра будет отображена директория для дополнительных файлов конфигурации.

Перейдите в данную директорию:

cd адрес_директории

3Создайте файл конфигурации:

nano название_библиотеки.ini

4. Укажите в этом файле директиву, сохраните внесенные изменения:

extension=название_библиотеки.so

5. Перезагрузите веб-сервер Apache:

service apache2 restart

6. Обновите в браузере страницу http://имя.вашего.домена/phpinfo.php и проверьте наличие там названия установленной библиотеки.

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

extension=путь_к_библиотеке/название_библиотеки.so

Если у Вас остались вопросы - создайте тикет в техподдержку.