Блог cyber01 IT, мануалы, инструкции и прочее
Похожие статьи
В начале декабря ко мне обратился мой знакомый с довольно нетривиальной задачей: у него имелся сервер на Ubuntu 16.04, с установленной на него панелью Webmin и модулем для нее Usermin, на данный сервер нужно было поставить PHP 7.4 и PHP 8.0. Вроде бы простая задача, подключай PPA ondrej/php и поставь нужные пакеты, но все оказалось сложнее.
Ни ondrej, ни sury, ни даже dotdeb уже не поддерживали 16.04, а сервер нельзя было тушить и обновлять, поэтому было принято решение собрать нужные версии PHP из исходников и подсунуть панельке. Заранее скажу, что идея сработала и без каких-либо нареканий прошла все тесты. Сборка PHP 7.4 практически ничем не отличается (кроме префикса и самой цифры в путях), поэтому опишу только сборку 7.4, а сборка 8.0 делается по аналогии, с небольшой оговоркой, о которой в конце
Исходные данные
- Сервер c Ubuntu 16.04
- Панель Webmin 1.932 c модулем Usermin 1.780
- На сервере стоит уже какая-либо версия PHP (у знакомого стояла 7.2)
- Root или sudo доступ к серверу (в моем случае sudo)
Установка необходимых компонентов для сборки
Сначала установим все необходимые компоненты для сборки, т.к. на сервере знакомого используется MySQL, то со стороны PHP будем ставить пакеты только под нее.
Обновим список пакетов
apt update
Установка инструментов для сборки
Помимо инструментов для сборки установим также зависимости для сборки PHP
apt install git build-essential autoconf re2c bison libxml2-dev libssl-dev pkg-config zlib1g-dev libsodium-dev libcurl4-openssl-dev libjpeg-turbo8-dev libbz2-dev libpng++-dev libfreetype6-dev libzip-dev libkrb5-dev libsqlite3-dev libwebp-dev libxpm-dev libc-client2007e-dev libonig-dev libreadline-dev libxslt-dev -y
Сборка и установка PHP 7.4.27
Загрузка исходных кодов PHP
Командами ниже, мы скачаем архив в /usr/src с исходными кодами с официального сайта, распакуем его и перейдем в распакованную директорию
wget https://www.php.net/distributions/php-7.4.27.tar.gz -O /usr/src/php-7.4.27.tar.gz cd /usr/src tar xfvz php-7.4.27.tar.gz cd php-7.4.27
Конфигурация PHP
Мы будем собирать и устанавливать PHP в директорию /usr/local/php7, этот путь указывается в префиксе и еще нескольких директивах. Будьте внимательны, если меняете директорию. В Webmin установленный MySQL имеет сокет в /var/run/mysqld/mysqld.sock, поэтому его же укажем и для своей версии.
./configure \ --prefix=/usr/local/php7 \ --with-config-file-path=/usr/local/php7/etc \ --with-config-file-scan-dir=/usr/local/php7/etc/conf.d \ --enable-bcmath \ --enable-calendar \ --with-bz2 \ --with-curl \ --enable-filter \ --enable-exif \ --enable-fpm \ --enable-ftp \ --enable-gd \ --with-webp \ --with-jpeg \ --with-xpm \ --with-freetype \ --with-gettext \ --with-kerberos \ --with-imap-ssl \ --enable-pcntl \ --with-imap \ --enable-intl \ --enable-mbstring \ --enable-mysqlnd \ --with-mysql-sock=/var/run/mysqld/mysqld.sock \ --with-mysqli=mysqlnd \ --with-pdo-mysql=mysqlnd \ --with-pdo-sqlite \ --with-readline \ --enable-shmop \ --with-sodium \ --enable-sysvmsg \ --enable-sysvsem \ --enable-sysvshm \ --enable-soap \ --enable-sockets \ --disable-phpdbg \ --disable-phpdbg-webhelper \ --enable-opcache \ --with-openssl \ --enable-simplexml \ --with-sqlite3 \ --enable-xmlreader \ --enable-xmlwriter \ --with-xmlrpc \ --with-xsl \ --with-zlib \ --with-fpm-user=www-data \ --with-fpm-group=www-data
После этапа конфигурации нам нужно собственно собрать сам PHP и установить его:
Сборка и установка PHP
Запустим сборку PHP с помощью команды make, я запускаю в 4 потока, замените это число на количество ядер вашего процессора. Больше потоков — быстрее сборка.
make -j 4
Сборка может занимать продолжительное время. В конце сборки вы увидите приблизительно такой вывод:
Теперь установим PHP, это можно сделать следующей командой:
make install
В результате вы увидите приблизительно следующий вывод:
На этом сам процесс сборки и установки PHP завершен. Теперь нужно «подсунуть» эту версию Webmin/Usermin, чтобы они ее увидели и смогли работать.
Подготовка PHP для работы с Webmin/Usermin
Размещение файлов конфигурации и симлинков
Первое, что нам нужно сделать после установки нашей версии PHP — разместить нужные файлы конфигурации и симлинки так, чтобы это выглядело, будто он установлен из репозиториев. Дело в том, что Webmin/Usermin ищут их по определенным путям и нам нужно соответствовать им.
Сначала разместим service файл PHP-FPM для systemd. С помощью любого удобного вам редактора создайте файл /lib/systemd/system/php7.4-fpm.service . Я буду использовать для этого nano
nano /lib/systemd/system/php7.4-fpm.service
После чего, вставьте в него следующее содержимое:
[Unit] Description=The PHP 7.4 FastCGI Process Manager Documentation=man:php-fpm7.4(8) After=network.target [Service] Type=simple PIDFile=/run/php-fpm/php7.4-fpm.pid ExecStart=/usr/sbin/php-fpm7.4 --nodaemonize --fpm-config /etc/php/7.4/fpm/php-fpm.conf ExecReload=/bin/kill -USR2 $MAINPID [Install] WantedBy=multi-user.target
Сохраните файл и закройте редактор. Далее займемся симлинками и файлами конфигурации.
Скопируем директорию с конфигурацией PHP 7.2 для нашей версии PHP 7.4. Это сделано для того, чтобы не заниматься правками нового php.ini, а подключить уже имеющийся с минимальными затратами. При этом из скопированной директории удаляем вложенную директорию conf.d и заменим ее на симлинки
cp -R /etc/php/7.2/ /etc/php/7.4
rm -rf /etc/php/7.4/{cli,cgi,fpm}/conf.d
mkdir /usr/local/php7/etc/conf.d
ln -s /usr/local/php7/etc/conf.d /etc/php/7.4/cgi/conf.d
ln -s /usr/local/php7/etc/conf.d /etc/php/7.4/cli/conf.d
ln -s /usr/local/php7/etc/conf.d /etc/php/7.4/fpm/conf.d
Теперь, подготовим сами файлы конфигурации. Нам не интересна стандартная конфигурация, поэтому мы удалим ее и заменим копией из скопированной ранее директории 7.2
rm -rf /usr/local/php7/etc/php-fpm.conf.default /usr/local/php7/etc/php-fpm.d/www.conf.default ln -s /etc/php/7.4/fpm/php.ini /usr/local/php7/etc/php.ini ln -s /etc/php/7.4/fpm/php-fpm.conf /usr/local/php7/etc/php-fpm.conf
Также поступим и с пулами FPM по умолчанию:
rm -rf /etc/php/7.4/fpm/pool.d/* cp /etc/php/7.2/fpm/pool.d/ /etc/php/7.4/fpm/pool.d/
Т.к. пулы и конфигурацию PHP-FPM мы скопировали с версии 7.2, внутри файлов конфигурации остались пути, ведущие на 7.2, заменим их на соответствующие:
sed -i 's/7.2/7.4/g' /etc/php/7.4/fpm/pool.d/www.conf sed -i 's/7.2/7.4/g' /etc/php/7.4/fpm/php-fpm.conf
Теперь очередь за симлинками на бинарные файлы PHP, чтобы их увидели Webmin/Usermin:
ln -s /usr/local/php7/sbin/php-fpm /usr/sbin/php-fpm7.4 ln -s /usr/local/php7/bin/php /usr/bin/php7.4 ln -s /usr/local/php7/bin/php-cgi /usr/bin/php-cgi7.4 ln -s /usr/local/php7/bin/php-config /usr/bin/php-config7.4 ln -s /usr/local/php7/bin/phpize /usr/bin/phpize7.4 ln -s /usr/local/php7/bin/phar.phar /usr/bin/phar.phar7.4 ln -s /usr/local/php7/bin/phar.phar /usr/bin/phar7.4
Проверим, что PHP 7.4 работает, для этого запросим показ версии:
php7.4 -v
Подключение к Webmin/Usermin
Теперь осталось проверить, а видит ли Webmin/Usermin нашу установленную версию PHP. Это можно сделать командой
virtualmin check-config
Если вам повезло и вы увидели в строках со скриншота вашу версию PHP, то считайте вам повезло. Но скорее всего вам не повезет также, как и мне, я не увидел свою версию ни в строке с CGI, ни в строке с FPM.
Этот факт меня немного расстроил, но я решил понять «а собственно почему так?». В итоге выяснил. Т.к. была установлена довольно старая версия Webmin, то доступных (и возможных) версий PHP там был зашит в коде. Зачем так сделали разработчики — не понятно, но этот список нужно было отредактировать.
Чтобы отредактировать список, нужно открыть любым удобным текстовым редактором файл /usr/share/webmin/virtual-server/virtual-server-lib.pl . Я для этих целей буду использовать nano
nano /usr/share/webmin/virtual-server/virtual-server-lib.pl
Далее, найдите в этом файле строку:
@all_possible_php_versions =
У меня она выглядела так:
@all_possible_php_versions = (5, 5.2, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 5.9,
"7.0", 7.1, 7.2, 7.3);
Как видно, Webmin/Usermin «не знает», что существуют версии PHP выше 7.3, а значит надо об этом ему «сказать». Нужно добавить соответствующие версии через запятую, при условии, что каждый мажорный релиз должен быть в двойных кавычках. Я привел строку к такому виду:
@all_possible_php_versions = (5, 5.2, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 5.9,
"7.0", 7.1, 7.2, 7.3, 7.4, "8.0", 8.1);
После правок я снова запустил virtualmin check-config и чудо свершилось, нужна версия появилась в списке. Но счастье мое было недолгим.. Нужная версия появилась только в режиме CGI, а не в FPM, который по умолчанию использует Usermin. Пришлось ковыряться дальше.
А дальше оказалось довольно неожиданное решение от разработчиков Webmin/Usermin. Вместо того, чтобы проверять конфигурационные файлы и наличие бинарных файлов PHP-FPM, они проверяют наличие установленного в системе пакета с php<тут версия>-fpm в имени. И если его нет — значит и поддержки FPM для этой версии нет, даже не смотря на то, что все бинарные файлы при этом существуют. Ну это не страшно, можно систему немного обмануть.
Создание и сборка пустого .deb пакета с нужным именем
Раз панель ищет именно установленный пакет, но ей все равно на бинарные файлы при этом, значит сделаем пакет-пустышку и установим. Этом можно сделать с помощью пакета equivs. Установим его в систему:
apt install equivs
Далее создадим заготовку под пакет php7.4-fpm:
equivs-control php7.4-fpm
В результате в текущей директории будет создан файл php7.4-fpm со следующим содержимым:
### Commented entries have reasonable defaults. ### Uncomment to edit them. # Source: <source package name; defaults to package name> Section: misc Priority: optional # Homepage: <enter URL here; no default> Standards-Version: 3.9.2 Package: <package name; defaults to equivs-dummy> # Version: <enter version here; defaults to 1.0> # Maintainer: Your Name <yourname@example.com> # Pre-Depends: <comma-separated list of packages> # Depends: <comma-separated list of packages> # Recommends: <comma-separated list of packages> # Suggests: <comma-separated list of packages> # Provides: <comma-separated list of packages> # Replaces: <comma-separated list of packages> # Architecture: all # Multi-Arch: <one of: foreign|same|allowed> # Copyright: <copyright file; defaults to GPL2> # Changelog: <changelog file; defaults to a generic changelog> # Readme: <README.Debian file; defaults to a generic one> # Extra-Files: <comma-separated list of additional files for the doc directory> # Files: <pair of space-separated paths; First is file to include, second is destination> # <more pairs, if there's more than one file to include. Notice the starting space> Description: <short description; defaults to some wise words>. long description and info . second paragraph
Приведем его к минимальному виду, указав версию PHP, для которой собрали и файл, который доставляется этим пакетом.
Section: misc Priority: optional Standards-Version: 3.9.2 Package: php7.4-fpm Version: 7.4.27+cyber01+virtual.package Maintainer: cyber01 <help@cyber01.ru> Architecture: all Files: test_php7.4-fpm.conf /etc/php7.4-fpm_virtual Description: Virtual package for webmin in ubuntu 16.04
Т.е. в файле выше мы указали, что:
- Имя нашего пакета: php7.4-fpm
- Версия пакета: 7.4.27+cyber01+virtual.package
- Сопровождает пакет: cyber01 help@cyber01.ru т.е. я
- Пакет доступен для всех архитектур
- Пакет предоставляет файл test_php7.4-fpm.conf, который будет будет помещен в директорию /etc/php7.4-fpm_virtual
- Ну и описание пакета
Также, нужно собственно создать файл test_php7.4-fpm.conf рядом с нашим php7.4-fpm. Содержимое файла не имеет значения.
Теперь, когда все подготовительные этапы готовы, можем собрать пакет и позже — установить его.
Сборка пакета довольно простая и выполняется командой:
equivs-build php7.4-fpm
В результате, в текущей директории будет создан .deb файл с именем: php7.4-fpm_7.4.27+cyber01+virtual.package_all.deb. Т.е. фактически: «имя пакета + версия + список архитектур».deb.
Теперь осталось дело за малым — установить его:
dpkg -i php7.4-fpm_7.4.27+cyber01+virtual.package_all.deb
Всё, теперь пакет установлен и virtualmin check-config должен увидеть FPM конфигурацию. Теперь можно запустить наш FPM сервис и добавить его в автозагрузку:
systemctl enable php7.4-fpm --now
А дальше уже продолжить использовать новую версию дальше, но я все же рекомендую обновиться до актуальных версий ОС т.к. использование неподдерживаемых версий небезопасно.
Также, если получилось так, что проверка конфигурации видит нужные версии PHP, а при этом сама панель нет — попробуйте сам webmin перезапустить. Это можно сделать как из консоли, так и из самой панели, пройдя по пути: Webmin — Webmin Configuration и внизу нажать кнопку Restart Webmin.
На этом всё, надеюсь кому-либо будет полезно.
