Сборка и настройка PHP 5.4.12 с PHP-FPM

Введение

Эта инструкция показывает, как собрать PHP 5.4.12 из исходников и запустить его как отдельный экземпляр PHP-FPM. Подходит для серверных окружений, где нужна конкретная версия PHP параллельно с системной. Краткое определение: PHP-FPM — менеджер процессов FastCGI для PHP, который обрабатывает PHP-вызовы отдельно от веб-сервера.

Требования и контекст

Подход предполагает Debian/Ubuntu-подобную систему. Будут использоваться стандартные пакеты сборки, библиотеки разработчика и инструменты пакетного менеджера. Вы действуете как системный администратор с правами root или через sudo.

Important: PHP 5.4 устарел и больше не получает обновлений безопасности. Используйте его только там, где это действительно необходимо и в изолированном окружении.

Загрузка и распаковка исходников

Создайте рабочие директории и скачайте исходники:

mkdir /opt/php-5.4.12
mkdir /usr/local/src/php5-build
cd /usr/local/src/php5-build
wget http://de.php.net/get/php-5.4.12.tar.bz2/from/this/mirror -O php-5.4.12.tar.bz2
tar jxf php-5.4.12.tar.bz2

Перейдите в каталог исходников:

cd php-5.4.12/

Установка зависимостей для сборки

Установите базовые инструменты сборки и зависимости:

apt-get install build-essential

apt-get build-dep php5

apt-get install libfcgi-dev libfcgi0ldbl libjpeg62-dbg libmcrypt-dev libssl-dev libc-client2007e libc-client2007e-dev

Если вы компилируете с опцией –with-imap, может потребоваться символическая ссылка на libc-client.a:

ln -s /usr/lib/libc-client.a /usr/lib/x86_64-linux-gnu/libc-client.a

Примечание: без этой ссылки ./configure может завершиться ошибкой: “Cannot find imap library (libc-client.a). Please check your c-client installation.”

Конфигурация и сборка PHP

Запустите ./configure с нужными опциями. Ниже приведён рекомендуемый набор опций; при необходимости измените и проверьте ./configure –help.

./configure \
--prefix=/opt/php-5.4.12 \
--with-pdo-pgsql \
--with-zlib-dir \
--with-freetype-dir \
--enable-mbstring \
--with-libxml-dir=/usr \
--enable-soap \
--enable-calendar \
--with-curl \
--with-mcrypt \
--with-zlib \
--with-gd \
--with-pgsql \
--disable-rpath \
--enable-inline-optimization \
--with-bz2 \
--with-zlib \
--enable-sockets \
--enable-sysvsem \
--enable-sysvshm \
--enable-pcntl \
--enable-mbregex \
--enable-exif \
--enable-bcmath \
--with-mhash \
--enable-zip \
--with-pcre-regex \
--with-mysql \
--with-pdo-mysql \
--with-mysqli \
--with-jpeg-dir=/usr \
--with-png-dir=/usr \
--enable-gd-native-ttf \
--with-openssl \
--with-fpm-user=www-data \
--with-fpm-group=www-data \
--with-libdir=/lib/x86_64-linux-gnu \
--enable-ftp \
--with-imap \
--with-imap-ssl \
--with-kerberos \
--with-gettext \
--with-xmlrpc \
--with-xsl \
--enable-fpm

Опция –enable-fpm включает сборку PHP-FPM.

Соберите и установите:

make
make install

Копирование php.ini и конфигурации PHP-FPM

Скопируйте пример php.ini и php-fpm.conf в целевые директории:

cp /usr/local/src/php5-build/php-5.4.12/php.ini-production /opt/php-5.4.12/lib/php.ini

cp /opt/php-5.4.12/etc/php-fpm.conf.default /opt/php-5.4.12/etc/php-fpm.conf

Откройте /opt/php-5.4.12/etc/php-fpm.conf и отредактируйте ключевые параметры. В строке listen укажите свободный порт (например, 127.0.0.1:8998), так как порт 9000 может быть занят системным PHP-FPM. В конце файла добавьте строку include, чтобы PHP-FPM подхватывал конфигурации пулов:

vi /opt/php-5.4.12/etc/php-fpm.conf

| [...] pid = run/php-fpm.pid [...] user = www-data group = www-data [...] listen = 127.0.0.1:8998 [...] include=/opt/php-5.4.12/etc/pool.d/*.conf |

Создайте директорию для пулов:

mkdir /opt/php-5.4.12/etc/pool.d

Создание init-скрипта для PHP-FPM

Создайте системный init-скрипт, чтобы управлять службой:

vi /etc/init.d/php-5.4.12-fpm

Вставьте следующий скрипт (сохраните как исполняемый):

| #! /bin/sh ### BEGIN INIT INFO # Provides: php-5.4.12-fpm # Required-Start: $all # Required-Stop: $all # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Short-Description: starts php-5.4.12-fpm # Description: starts the PHP FastCGI Process Manager daemon ### END INIT INFO php_fpm_BIN=/opt/php-5.4.12/sbin/php-fpm php_fpm_CONF=/opt/php-5.4.12/etc/php-fpm.conf php_fpm_PID=/opt/php-5.4.12/var/run/php-fpm.pid php_opts="--fpm-config $php_fpm_CONF" wait_for_pid () { try=0 while test $try -lt 35 ; do case "$1" in 'created') if [ -f "$2" ] ; then try='' break fi ;; 'removed') if [ ! -f "$2" ] ; then try='' break fi ;; esac echo -n . try=`expr $try + 1` sleep 1 done } case "$1" in start) echo -n "Starting php-fpm " $php_fpm_BIN $php_opts if [ "$?" != 0 ] ; then echo " failed" exit 1 fi wait_for_pid created $php_fpm_PID if [ -n "$try" ] ; then echo " failed" exit 1 else echo " done" fi ;; stop) echo -n "Gracefully shutting down php-fpm " if [ ! -r $php_fpm_PID ] ; then echo "warning, no pid file found - php-fpm is not running ?" exit 1 fi kill -QUIT `cat $php_fpm_PID` wait_for_pid removed $php_fpm_PID if [ -n "$try" ] ; then echo " failed. Use force-exit" exit 1 else echo " done" echo " done" fi ;; force-quit) echo -n "Terminating php-fpm " if [ ! -r $php_fpm_PID ] ; then echo "warning, no pid file found - php-fpm is not running ?" exit 1 fi kill -TERM `cat $php_fpm_PID` wait_for_pid removed $php_fpm_PID if [ -n "$try" ] ; then echo " failed" exit 1 else echo " done" fi ;; restart) $0 stop $0 start ;; reload) echo -n "Reload service php-fpm " if [ ! -r $php_fpm_PID ] ; then echo "warning, no pid file found - php-fpm is not running ?" exit 1 fi kill -USR2 `cat $php_fpm_PID` echo " done" ;; *) echo "Usage: $0 {start|stop|force-quit|restart|reload}" exit 1 ;; esac |

Сделайте скрипт исполняемым и добавьте его в автозагрузку:

chmod 755 /etc/init.d/php-5.4.12-fpm
insserv php-5.4.12-fpm

Запустите PHP-FPM:

/etc/init.d/php-5.4.12-fpm start

Если в /opt/php-5.4.12/etc/pool.d нет пулов, вы увидите предупреждение об отсутствии совпадающих файлов include — его можно игнорировать, пока пула нет.

Пример вывода при старте (предупреждение):

root@server1:/usr/local/src/php5-build/php-5.4.12# /etc/init.d/php-5.4.12-fpm start
Starting php-fpm [04-Mar-2013 16:03:35] WARNING: Nothing matches the include pattern ‘/opt/php-5.4.12/etc/pool.d/*.conf’ from /opt/php-5.4.12/etc/php-fpm.conf at line 512.
done
root@server1:/usr/local/src/php5-build/php-5.4.12#

Установка дополнительных расширений: APC, memcache, memcached

Для установки модулей используем PECL/PEAR. Сначала установите pear:

apt-get -y install php-pear

Перейдите в директорию конфигурации вашей собранной сборки и обновите каналы:

cd /opt/php-5.4.12/etc

pecl -C ./pear.conf update-channels

Установка APC через pecl:

pecl -C ./pear.conf install apc

Примите значения по умолчанию. Затем отредактируйте php.ini:

vi /opt/php-5.4.12/lib/php.ini

Добавьте в конец файла:

| [...] extension=apc.so apc.enabled=1 apc.shm_size=128M apc.ttl=0 apc.user_ttl=600 apc.gc_ttl=600 apc.enable_cli=1 apc.mmap_file_mask=/tmp/apc.XXXXXX ;apc.mmap_file_mask=/dev/zero ;apc.shm_segments = 5 |

Установка memcache:

pecl -C ./pear.conf install memcache

Добавьте в php.ini:

| [...] extension=memcache.so |

Установка memcached:

apt-get install libmemcached-dev

pecl -C ./pear.conf install memcached

Добавьте в php.ini:

| [...] extension=memcached.so |

Установка ionCube Loader

Переключитесь в /tmp и скачайте соответствующий пакет для архитектуры (x86_64 или x86):

Для x86_64:

wget http://downloads2.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz
tar xfvz ioncube_loaders_lin_x86-64.tar.gz

Для x86:

wget http://downloads2.ioncube.com/loader_downloads/ioncube_loaders_lin_x86.tar.gz
tar xfvz ioncube_loaders_lin_x86.tar.gz

Скопируйте нужный загрузчик и подключите в php.ini:

cp ioncube/ioncube_loader_lin_5.4.so /opt/php-5.4.12/lib/php/extensions/no-debug-non-zts-20100525/ioncube.so
vi /opt/php-5.4.12/lib/php.ini

Добавьте в начало файла (перед строкой [PHP]):

| zend_extension = /opt/php-5.4.12/lib/php/extensions/no-debug-non-zts-20100525/ioncube.so [PHP] [...] |

Перезагрузка PHP-FPM

После изменения php.ini и установки расширений перезагрузите службу:

/etc/init.d/php-5.4.12-fpm reload

Интеграция с ISPConfig

В ISPConfig 3.0.5 добавьте новую версию PHP в System > Additional PHP Versions. На вкладке Name укажите имя (например, “PHP 5.4.12”) — это имя будет отображаться в настройках сайтов.

На вкладке PHP-FPM Settings (вкладку FastCGI Settings можно оставить пустой) заполните поля, указав путь к php-fpm слушателю и прочие параметры:

Note: Убедитесь, что в настройках ISPConfig указан тот порт/Unix-сокет, который вы задали в файле php-fpm.conf.

Чек-лист администратора (быстрая проверка)

• Скачаны и распакованы исходники в /usr/local/src/php5-build
• Установлены build-essential и build-dep
• Установлены dev-библиотеки (libssl-dev, libmcrypt-dev и т. п.)
• Выполнен ./configure с нужными опциями и make && make install прошли без ошибок
• php.ini и php-fpm.conf скопированы в /opt/php-5.4.12
• В php-fpm.conf корректный listen и добавлен include для pool.d
• Создан init-скрипт и добавлен в автозагрузку
• PHP-FPM запущен и отвечает на указанном порту/сокете
• Установлены и подключены требуемые расширения (apc, memcache, memcached, ionCube)

Устранение неполадок — распространённые ошибки и решения

1. ./configure выдает ошибку о libc-client.a при –with-imap

   • Решение: создайте символическую ссылку: ln -s /usr/lib/libc-client.a /usr/lib/x86_64-linux-gnu/libc-client.a

2. make или make install падает с ошибками компоновки

   • Проверьте, установлены ли dev-пакеты для библиотек, перечисленных в опциях (libjpeg-dev, libpng-dev, libxml2-dev и т.п.).

3. PHP-FPM не запускается: нет pid-файла

   • Проверьте права и владельца директорий /opt/php-5.4.12/var/run. Убедитесь, что путь, указанный в php-fpm.conf для pid, существует.

4. Модуль не загружается (apc, memcache, memcached)

   • Убедитесь, что extension=*.so добавлена в тот php.ini, который используется собранным PHP (проверьте phpinfo() или /opt/php-5.4.12/bin/php -i).

5. ISPConfig не видит PHP-FPM

   • Проверьте, что в настройках дополнительной версии указан правильный путь к бинарнику PHP и correct FastCGI/Socket/Port. Перезапустите ISPConfig сервисы при необходимости.

Альтернативные подходы и когда их стоит использовать

• Использовать системные пакеты (apt) — быстрее и безопаснее, но может не дать нужной версии.
• Упаковка собственной сборки в .deb — упрощает управление версиями и обновлениями через стандартные инструменты.
• Docker-контейнер — изоляция среды, удобство тестирования и деплоя. Подходит, если возможно запускать приложения в контейнерах.
• Использовать phpbrew/pecl build tools — облегчают сборку нескольких параллельных версий для разработки.

Совместимость и советы по миграции

• PHP 5.4 несовместим с современными версиями многих фреймворков. Планируйте обновление приложений или использование совместимых веток.
• Запуск устаревшей версии следует ограничить внутренними сетями и надёжной системой брандмауэра.
• Для миграции: сначала разверните собранную версию на тестовом сервере, запустите интеграционные тесты и проверьте производительность под нагрузкой.

Безопасность и hardening (рекомендации)

• Отключите ненужные расширения в php.ini.
• Настройте open_basedir и disable_functions для сайтов, где это возможно.
• Убедитесь, что сокеты/порты PHP-FPM доступны только локально (127.0.0.1) или через защищённый прокси.
• Изолируйте процессы пулов по пользователям для сайтов с разными владельцами.

Роли и чек-листы

Для системного администратора:

• Проверить зависимости и собрать PHP.
• Настроить init-скрипт, автозагрузку и права.
• Обеспечить мониторинг процесса php-fpm (system checks, liveness probe).

Для разработчика:

• Проверить phpinfo() и список расширений.
• Запустить unit- и интеграционные тесты под новой версией PHP.
• Отметить несовместимости в кодовой базе (deprecated функции).

Критерии приёмки

• PHP-FPM стартует без фатальных ошибок.
• php -v показывает PHP 5.4.12 для сборки в /opt/php-5.4.12/bin/php.
• Расширения APC, memcache/memcached и ionCube загружены и видны в phpinfo().
• Сайты, использующие новую версию в ISPConfig, корректно выполняют запросы и проходят тесты.

Тесты и сценарии приёмки

• Запустить php -m и убедиться, что требуемые модули присутствуют.
• Выполнить скрипт с phpinfo() через веб-сервер, настроенный на использование сокета/порта PHP-FPM.
• Проверить время ответа и отсутствие ошибок в логах /opt/php-5.4.12/var/log.

Краткое резюме

Вы собрали PHP 5.4.12 и настроили его для работы через отдельный PHP-FPM-инстанс. Установлены популярные расширения и подключён ionCube Loader. Дальше — тестирование приложений и планирование постепенной миграции на поддерживаемую версию PHP.

Summary:

• Соберите только те расширения, которые необходимы.
• Изолируйте устаревшие версии от публичного доступа.
• Планируйте обновление кода для поддержки современных версий PHP.