PHP EOL

Docker-image-ek régi PHP-verziókhoz

Régi PHP-alkalmazást kell futtatnod, amelyet nem lehet egyik napról a másikra átírni egy támogatott PHP-verzióra? A PHP-projekt az 5.x és 7.x ágakhoz, valamint a 8.0-hoz és 8.1-hez már nem ad ki javítást, a 8.2 támogatása pedig 2026. december 31-én jár le. Egy javítatlan PHP-verzió az ismert sebezhetőségeivel együtt fut tovább. A PHP EOL ezekhez a verziókhoz ad PHP-FPM és PHP CLI konténer-image-eket, amelyekbe a biztonsági javítások továbbra is bekerülnek.

A PHP a CloudLinux alt-php csomagjaiból származik. A CloudLinux ezekbe a régi verziókba is visszaportolja a biztonsági javításokat, a csomagok forrását (SRPM) pedig nyilvánosan közzéteszi. Mi ezekből a forráscsomagokból AlmaLinux 9 alapon építjük újra a PHP-t, és csak azt tesszük az image-be, ami a futtatáshoz kell. CloudLinux-licenc nem kell hozzá: a licenc csak a lefordított csomagok tárolóját védi, a forráscsomagok szabadon elérhetők. A projekt nem áll kapcsolatban a CloudLinuxszal.

Azoknak szól, akik régi PHP-alkalmazást szeretnének konténerben futtatni, amíg az átállás egy támogatott verzióra elkészül.

Támogatott verziók

PHP Szerver-image CLI image Szerver
8.2 8.2-fpm 8.2-cli PHP-FPM
8.1 8.1-fpm 8.1-cli PHP-FPM
8.0 8.0-fpm 8.0-cli PHP-FPM
7.4 7.4-fpm 7.4-cli PHP-FPM
7.3 7.3-fpm 7.3-cli PHP-FPM
7.2 7.2-fpm 7.2-cli PHP-FPM
7.1 7.1-fpm 7.1-cli PHP-FPM
7.0 7.0-fpm 7.0-cli PHP-FPM
5.6 5.6-fpm 5.6-cli PHP-FPM
5.5 5.5-fpm 5.5-cli PHP-FPM
5.4 5.4-fpm 5.4-cli PHP-FPM
5.3 5.3-fpm 5.3-cli PHP-FPM
5.2 5.2-cgi 5.2-cli php-cgi FastCGI módban (az 5.2-ben nincs FPM)

Az image-ek a registry.gitlab.com/csbitbt/php-eol címen érhetők el. A CLI image fájljai megegyeznek az azonos verziójú szerver-image fájljaival, csak az alapértelmezett parancs más (php -a).

Hogyan készülnek az image-ek

  • RPM-ek újraépítése. Egy almalinux:9 konténerben letöltjük a CloudLinux 9 nyilvános tárolójából az alt-php forráscsomagjait és a hozzájuk tartozó alt-* függőségeket (például saját ICU-, OpenSSL-, curl- és libxml2-változatokat), majd lefordítjuk őket. Minden csomag ugyanabban a tiszta build-környezetben készül.
  • Stubok. Néhány CloudLinux build-csomagnak nincs nyilvános forrása (alt-pkg-config, alt-build-macros, cl-MariaDB1011), egy pedig konténerben nem csinál semmit (cloudlinux-linksafe). Ezeket kis helyettesítő csomagok pótolják, amelyek az AlmaLinux saját megfelelőit húzzák be.
  • Spec-javítások. Ahol egy CloudLinux spec-fájl nem illik a konténeres buildhez, sed-szkripttel módosítjuk. Az alt-libgd például AVIF nélkül épül, mert az AVIF-kodekek kb. 35 MB-tal növelnék az image-et, a PHP 7.4 pedig nem is használja őket.
  • FROM scratch image. A lefordított RPM-ek egy üres gyökérkönyvtárba kerülnek, ahonnan eltávolítjuk a futáshoz felesleges csomagokat (systemd, Perl, Python stb.), a végeredmény pedig egy FROM scratch image-be kerül. Az RPM-adatbázis megmarad, így a sebezhetőség-szkennerek (Trivy, Grype, Docker Scout, GitLab container scanning) látják az AlmaLinux-csomagokat.
  • Smoke test. Minden image-et automatikus teszt ellenőriz: a bővítmények figyelmeztetés nélkül betöltődnek, nem hiányzik megosztott könyvtár, a szerver a 9000-es porton fogad kapcsolatot, a workerek www-data felhasználóként futnak; a CLI image-nél a szkriptek futtatását nézi.
  • CI. A GitLab pipeline csak azokat a csomagokat fordítja újra, amelyekből a CloudLinux új kiadást tett közzé, az image-eket viszont minden futáskor újraépíti, így az AlmaLinux-frissítések is bekerülnek. Az image-eket akkor építjük újra, amikor szükséges: ha a CloudLinux új javítást ad ki, vagy az AlmaLinux alap frissül.
  • Tagek. Minden image két taget kap: a rövidet (5.6-fpm) és a pontos CloudLinux-kiadást jelölőt (5.6.40-152-fpm). latest tag nincs.

Használat

Az FPM-image-ek a hivatalos php:*-fpm image-ekhez hasonlóan működnek:

  • a php-fpm az előtérben fut, és a 9000-es porton szolgál ki FastCGI-t;
  • a workerek www-data felhasználóként (uid/gid 33) futnak, a dokumentumgyökér /var/www/html;
  • a PHP és az FPM a standard hibakimenetre naplóz, így minden a konténer naplójában jelenik meg;
  • a php és a php-fpm a PATH-on van.
docker run -d --name php -v "$PWD:/var/www/html" registry.gitlab.com/csbitbt/php-eol:5.6-fpm

Elé egy nginx például így kapcsolható:

location ~ \.php$ {
    fastcgi_pass php:9000;
    fastcgi_param SCRIPT_FILENAME /var/www/html$fastcgi_script_name;
    include fastcgi_params;
}

A PHP fájljai az /opt/alt/phpNN/ alatt vannak (például /opt/alt/php56/), a PHP_INI_DIR ennek etc/ könyvtárára mutat. A saját beállításaidat (memory_limit, date.timezone stb.) egy .ini fájlba teheted a link/conf/ könyvtárban, az FPM-pool beállításait pedig az etc/php-fpm.d/ könyvtárba.

A -cli image-ek a php parancssort futtatják, például cron-feladatokhoz, sorkezelő workerekhez vagy szkriptekhez. Cron-démon nincs bennük, ezeket a gazdagép cronja vagy más ütemező indítja:

docker run --rm --user www-data -v "$PWD:/var/www/html" registry.gitlab.com/csbitbt/php-eol:5.6-cli php cron.php

PHP 5.2. Ez az image is a 9000-es porton szolgál ki FastCGI-t, így a webszerver beállítása ugyanaz. Az FPM helyett a php-cgi -b 0.0.0.0:9000 fut, az egész konténer www-data felhasználóként. A workerek száma rögzített: PHP_FCGI_CHILDREN (alapból 30), és mindegyik PHP_FCGI_MAX_REQUESTS kérés (alapból 2000) után újraindul.

Bővítmények

Minden image-ben be van kapcsolva: bcmath, calendar, curl, dom, exif, fileinfo, gd, gettext, igbinary, intl, json, mbstring, memcached, mysqli, mysqlnd, openssl, pcntl, pdo_mysql, pdo_sqlite, phar, posix, recode, xmlreader, xmlrpc, xmlwriter, zip és zlib. Az eltérések:

  • 8.0–8.2: nincs recode, a json beépített, az xmlrpc a PECL-csomagjából jön.
  • 7.4: nincs recode, mert a PHP 7.4-ből kikerült.
  • 5.2: nincs mysqlnd; a mysql, a mysqli és a pdo_mysql az AlmaLinux MariaDB Connector/C kliens-könyvtárát használja, amely MySQL-szerverhez is csatlakozik.

Néhány bővítmény benne van az image-ben, csak nincs bekapcsolva, például a sockets, az xsl, a pdo_dblib, az 5.x verziókban a régi mysql_* függvények, a 7.4-ben és a 8.x-ben az ffi. Ezeket a saját image-edben egy extension= sorral kapcsolhatod be. Az OPcache minden image-ben megvan, de alapból ki van kapcsolva; Zend-bővítményként a teljes útvonalával tölthető be:

FROM registry.gitlab.com/csbitbt/php-eol:5.6-fpm
RUN printf 'zend_extension=/opt/alt/php56/usr/lib64/php/modules/opcache.so\nopcache.memory_consumption=128\n' \
      > /opt/alt/php56/link/conf/20-opcache.ini

Más bővítményhez (például soap, ldap, pgsql, vagy PECL-ből redis, imagick) a CloudLinux-csomagja kell, ami csak az image építésekor kerülhet be. Ehhez a projektet magadnak kell lefordítanod; a README leírja a lépéseket.

Mire figyelj

  • Ezek EOL verziók. A visszaportolt javítások nem pótolják az átállást: a cél a migráció egy támogatott PHP-verzióra, az image erre ad időt.
  • A javítások a CloudLinuxtól jönnek. Saját PHP-javításokat nem írunk, a CloudLinux csomagjait építjük újra, így a javítások köre és üteme rajtuk múlik.
  • Nincs csomagkezelő és nincs docker-php-ext-install. Ami nincs az image-ben, azt csak saját build útján lehet hozzáadni. Az oci8 bővítmény nem készül el, mert az Oracle Instant Clientnek nincs nyilvános forrása.
  • Csak x86-64. Az RPM-ek és az image-ek amd64 architektúrára készülnek.
  • A tagek felülíródnak. Újraépítéskor a rövid és a pontos tag is az új buildre mutat, latest pedig nincs, ezért a verziót mindig írd ki.
  • PHP 5.3. Az FPM mindig törli a workerek környezetét, így a konténer környezeti változói nem jutnak el a PHP-hoz.
  • Alapbeállítások. Az alapértelmezett FPM-pool dinamikus, legfeljebb 70 workerrel; ezt a rendelkezésre álló memóriához érdemes igazítani. A CLI image-ek rootként futnak, a webalkalmazás fájljain dolgozó feladatokhoz add meg a --user www-data kapcsolót.