Гид по технологиям

Сборка PHP 5.5 (PHP-FPM и FastCGI) с ionCube Loader, Zend OPcache и APCu для ISPConfig 3 (Debian Wheezy)

• 7 min read • Серверы • Обновлено 27 Nov 2025
PHP 5.5 с ionCube, Zend OPcache и APCu для ISPConfig 3
PHP 5.5 с ionCube, Zend OPcache и APCu для ISPConfig 3

Коротко: пошаговая инструкция по сборке PHP 5.5.7 на Debian Wheezy как в вариантах PHP-FPM и FastCGI, с подключением ionCube Loader, Zend OPcache и APCu. Подходит для добавления версии PHP в ISPConfig 3 и выбора её для сайтов. Пройдите перечень предварительных шагов, соберите PHP из исходников и установите дополнительные расширения через PECL/pear.

Важно: следуйте командам с правами root или через sudo. Тщательно проверьте используемые пути (в примерах используется /opt/php-5.5.7) и порты (например, 8999 для PHP-FPM).

Оглавление

  • Введение и общая идея
  • Требования и предварительные заметки
  • Сборка PHP 5.5.7 для PHP-FPM — пошагово
  • Установка Zend OPcache, APCu, memcache, memcached и ionCube
  • Как добавить версию в ISPConfig 3
  • Чеклист: что проверить после установки
  • Частые ошибки и пути их устранения
  • Альтернативы и когда этот способ не подходит
  • Совместимость, миграция и примечания по безопасности
  • Критерии приёмки
  • Мини-методология и рекомендации по сопровождению
  • Краткий глоссарий

Введение и общая идея

С ISPConfig 3.0.5 появилась возможность использовать несколько версий PHP на одном сервере и выбирать оптимальную версию для каждого сайта. Для этого поддерживаются два режима: PHP-FPM (начиная с PHP 5.3) и FastCGI (все версии PHP 5.x для Apache). Это руководство показывает, как собрать PHP 5.5 (версию 5.5.7 в примерах) и подключить распространённые расширения: ionCube Loader, Zend OPcache, APCu, memcache и memcached.

Краткое определение терминов:

  • PHP-FPM — FastCGI Process Manager, современный менеджер процессов PHP, рекомендован для высокой нагрузки.
  • FastCGI — устаревший, но совместимый метод запуска PHP через Apache.
  • ionCube Loader — проприетарный загрузчик зашифрованных PHP-скриптов.
  • Zend OPcache — встроенный в PHP кэш байт-кода для ускорения исполнения.
  • APCu — пользовательский кэш объектов в памяти (APC для PHP 5.x модернизированный).

Требования и предварительные заметки

  • Тестовая система: Debian Wheezy (64-bit или 32-bit в примерах). Подойдёт любая стабильная Debian-подобная система, но пути и названия пакетов могут отличаться.
  • Привилегии root или sudo для установки пакетов и записи в системные директории.
  • Сетевой доступ для загрузки исходников и пакетов.

Замечания:

  • PHP-FPM и FastCGI в одном билде PHP в версии 5.5 конфликтуют. Чтобы получить оба режима, компилируйте PHP дважды с разными параметрами –enable-fpm и –enable-cgi в разные префиксы (/opt/php-5.5.7 и /opt/phpfcgi-5.5.7).
  • В примерах используется PHP 5.5.7 — замените на актуальную версию 5.5.x, если необходимо.

1. Подготовка окружения

Создайте целевые директории и скачайте исходники:

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

Перейдите в директорию с исходниками:

cd php-5.5.7/

Установите зависимости для сборки PHP и требуемые dev-пакеты:

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

Если вы планируете собирать с поддержкой IMAP, создайте ссылку на библиотеку c-client:

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

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

2. Конфигурация и сборка PHP 5.5.7 для PHP-FPM

Запустите конфигурацию. Команды ниже — пример; можно добавлять или убирать опции по необходимости (выполните “./configure –help” для полного списка):

./configure \
--prefix=/opt/php-5.5.7 \
--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-opcache \
--enable-fpm

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

make
make install

3. Настройка php.ini и php-fpm

Скопируйте образец php.ini-production и конфигурацию php-fpm:

cp /usr/local/src/php5-build/php-5.5.7/php.ini-production /opt/php-5.5.7/lib/php.ini
cp /opt/php-5.5.7/etc/php-fpm.conf.default /opt/php-5.5.7/etc/php-fpm.conf

Откройте /opt/php-5.5.7/etc/php-fpm.conf и отредактируйте основные настройки. В параметре listen укажите свободный порт (пример: 127.0.0.1:8999). Добавьте в конце файла строку include=/opt/php-5.5.7/etc/pool.d/*.conf для подключения пулов процессов:

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

В конфигурационном файле должна быть строка вида:

pid = run/php-fpm.pid
user = www-data
group = www-data
listen = 127.0.0.1:8999
include=/opt/php-5.5.7/etc/pool.d/*.conf

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

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

4. Скрипт init для управления PHP-FPM

Создайте init-скрипт /etc/init.d/php-5.5.7-fpm со следующим содержимым:

#! /bin/sh
### BEGIN INIT INFO
# Provides:          php-5.5.7-fpm
# Required-Start:    $all
# Required-Stop:     $all
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: starts php-5.5.7-fpm
# Description:       starts the PHP FastCGI Process Manager daemon
### END INIT INFO
php_fpm_BIN=/opt/php-5.5.7/sbin/php-fpm
php_fpm_CONF=/opt/php-5.5.7/etc/php-fpm.conf
php_fpm_PID=/opt/php-5.5.7/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.5.7-fpm
insserv php-5.5.7-fpm

Запустите сервис:

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

Если пулов ещё нет в /opt/php-5.5.7/etc/pool.d, вы увидите предупреждение о пустом include — это нормально.

5. Включение Zend OPcache

Откройте /opt/php-5.5.7/lib/php.ini и добавьте в конец файла:

zend_extension=opcache.so

После этого перезагрузите или перегрузите php-fpm: 

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

6. Установка APCu, memcache и memcached (через PECL/pear)

Установите pear/pecl, затем инициализируйте каналы и установите расширения:

apt-get -y install php-pear
cd /opt/php-5.5.7/etc
pecl -C ./pear.conf update-channels

Установка APCu:

pecl -C ./pear.conf install channel://pecl.php.net/apcu-4.0.2

Добавьте в /opt/php-5.5.7/lib/php.ini:

extension=apcu.so
apc.enabled=1
apc.shm_size=128M
apc.ttl=0
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 (требует libmemcached-dev):

apt-get install libmemcached-dev
pecl -C ./pear.conf install memcached

В php.ini добавьте:

extension=memcached.so

Примечание: при установке PECL-расширений используйте локальную конфигурацию pear.conf в каталоге /opt/php-5.5.7/etc, чтобы пакеты ставились под этот билд PHP.

7. Установка ionCube Loader

ionCube Loader доступен для PHP 5.5. Скачайте соответствующий пакет для вашей архитектуры (x86_64 или x86) и распакуйте:

Для x86_64:

cd /tmp
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

Скопируйте подходящую библиотеку ionCube в директорию расширений вашего билда PHP и подключите в начале php.ini (до строки [PHP]):

cp ioncube/ioncube_loader_lin_5.5.so /opt/php-5.5.7/lib/php/extensions/no-debug-non-zts-20121212/ioncube.so
vi /opt/php-5.5.7/lib/php.ini

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

zend_extension = /opt/php-5.5.7/lib/php/extensions/no-debug-non-zts-20121212/ioncube.so
[PHP]
...

Перегрузите php-fpm:

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

8. Добавление версии PHP в ISPConfig 3

В ISPConfig 3 (начиная с версии 3.0.5) перейдите: System > Additional PHP Versions.

На вкладке “Name” задайте понятное имя, например “PHP 5.5.7” — это имя будет отображаться в настройках сайта.

Настройка новой версии PHP в ISPConfig — вкладка 'Имя'

На вкладке “PHP-FPM Settings” укажите настройки подключения к сокету/порту (например, 127.0.0.1:8999) и пути к php.ini, sbin/php-fpm и т.д. Вкладку “FastCGI Settings” можно оставить пустой, если вы используете только PHP-FPM.

Вкладка настроек PHP-FPM в ISPConfig для добавленной версии PHP

После добавления версии вы сможете выбрать её при создании или редактировании сайта в ISPConfig.

Чеклист: что проверить после установки

  • Сервис php-fpm запущен и слушает указанный порт: netstat -plnt | grep 8999.
  • В логах /opt/php-5.5.7/var/log/ (или по настроенному пути) нет ошибок при старте.
  • В phpinfo() отображается версия 5.5.7, включён OPcache и APCu, ionCube присутствует.
  • Расширения memcache/memcached успешно загружены (php -m | grep memcache).
  • ISPConfig корректно подключил новую версию и сайт использует её.

Частые ошибки и пути устранения

  1. Ошибка “Cannot find imap library (libc-client.a)”: проверьте наличие /usr/lib/x86_64-linux-gnu/libc-client.a или создайте символическую ссылку, как описано выше.

  2. ./configure не проходит зависимость: проверьте вывод ./configure --help и установите недостающие dev-пакеты.

  3. PECL ставит пакеты в системный PHP вместо вашего билда: используйте pecl -C ./pear.conf из директории /opt/php-5.5.7/etc, чтобы применялся локальный конфиг pear.

  4. ionCube не загружен: убедитесь, что путь к ioncube.so корректен и что zend_extension указан до секции [PHP] в php.ini.

  5. PHP-FPM не стартует: проверьте корректность портов (не конфликтует с системным PHP-FPM) и права на директории run/var.

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

  • Использовать пакеты дистрибутива (apt-get install php5) — проще и быстрее, но не всегда доступна желаемая версия PHP или конфигурация.
  • Использовать репозитории с готовыми билдами (Dotdeb, Sury) — сокращает количество ручной работы, но требует доверия стороннему репозиторию.
  • Контейнеризация (Docker) — хорошо для изоляции и воспроизводимости, особенно на новых системах; требует знаний Docker.

Когда не стоит собирать вручную:

  • Если требуется быстрая развертка и обновления безопасности важнее оптимальной настройки — выбирайте проверенные репозитории.
  • На продуктивных системах без тестовой среды ручная сборка повышает риск конфигурационных ошибок.

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

  • Убедитесь, что модули PHP собраны под правильную API-версию расширений (no-debug-non-zts-20121212 для PHP 5.5.7). Путь к директории extensions должен соответствовать output php -i | grep extension_dir.
  • При миграции сайтов проверьте совместимость кода с PHP 5.5 (устаревшие функции, изменённое поведение). Тестируйте на тестовой копии перед переносом.

Безопасность и эксплуатация

  • Обновляйте PHP (и сборку) при выходе критических исправлений безопасности; ручная сборка требует планирования обновлений.
  • Следите за правами директорий (особенно run, var, tmp) и используйте неперсистентные пользователи для php-fpm пулов.
  • Отключайте ненужные расширения и минимизируйте список загружаемых модулей.

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

  • PHP-FPM запущен и принимает соединения на указанном порту.
  • phpinfo() в браузере показывает: версия 5.5.7, OPcache активен, APCu активен, ionCube загружен.
  • Сайт в ISPConfig использует добавленную версию PHP и корректно обрабатывает запросы.

Мини-методология: как выстроить процесс сборки и тестирования

  1. Подготовьте тестовую VM, идентичную продакшну.
  2. Выполните полный цикл сборки и установки, интеграции с ISPConfig.
  3. Протестируйте все сервисы и регрессионно прогоните основные сценарии приложений.
  4. Зафиксируйте шаги и конфигурации в SOP/репозитории конфигураций.
  5. При успешных тестах примените изменения на продакшн по окному обслуживания.

Решающее дерево: выбирать PHP-FPM или FastCGI?

flowchart TD
  A[Нужен современный режим и лучшая производительность?] -->|Да| B[PHP-FPM]
  A -->|Нет, только Apache| C[FastCGI]
  B --> D[Используйте --enable-fpm]
  C --> E[Используйте --enable-cgi]
  D --> F[Настройте пула /opt/php-5.5.7/etc/pool.d]
  E --> G[Установите в отдельный префикс /opt/phpfcgi-5.5.7]

Роль-ориентированные чеклисты

Администратор:

  • Проверил зависимости и наличие dev-пакетов.
  • Собрал и установил PHP в изолированный префикс.
  • Настроил и запустил php-fpm init-скриптом.

Разработчик:

  • Запустил phpinfo(), проверил OPcache/APCu/ionCube.
  • Прогнал unit- и интеграционные тесты.

Оператор ISPConfig:

  • Добавил новую версию PHP в ISPConfig (System > Additional PHP Versions).
  • Привязал сайт к новой версии и протестировал в пользовательском сценарии.

Тесты / критерии приёмки

  • netstat показывает слушающий порт: netstat -plnt | grep 8999.
  • Веб-страница phpinfo() отображает ionCube и OPcache.
  • Приложение не выдаёт ошибок время выполнения, связанных с отсутствием расширений.

Краткий глоссарий

  • OPcache — кэш байт-кода PHP, уменьшающий время компиляции скриптов.
  • APCu — кэш пользовательских данных в памяти для быстрого доступа.
  • ionCube — загрузчик для расшифрованных/зашифрованных приложений.

Итог (коротко)

Сборка PHP 5.5 из исходников даёт гибкость: вы контролируете опции, включаете нужные расширения и обеспечиваете совместимость с ISPConfig 3. В то же время ручная сборка требует дисциплины по обновлениям и тестированию. Взвесьте преимущества и риски и применяйте описанный SOP на тестовой среде перед применением в продакшне.

Поделиться: X/Twitter Facebook LinkedIn Telegram
Автор
Редакция

Похожие материалы

Несколько аккаунтов Skype: Multi Skype Launcher
Программное обеспечение

Несколько аккаунтов Skype: Multi Skype Launcher

Журнал для работы: повысить продуктивность
Productivity

Журнал для работы: повысить продуктивность

Персональные звуки уведомлений на Android
Android.

Персональные звуки уведомлений на Android

Скачивание шоу Hulu для офлайн‑просмотра
Стриминг

Скачивание шоу Hulu для офлайн‑просмотра

Microsoft Start: персонализированная новостная лента
Новости

Microsoft Start: персонализированная новостная лента

Как изменить имя в Epic Games быстро
Гайды

Как изменить имя в Epic Games быстро