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:9konté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-libgdpé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 scratchimage. 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 egyFROM scratchimage-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-datafelhaszná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).latesttag nincs.
Használat
Az FPM-image-ek a hivatalos php:*-fpm image-ekhez hasonlóan működnek:
- a
php-fpmaz előtérben fut, és a 9000-es porton szolgál ki FastCGI-t; - a workerek
www-datafelhaszná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 aphp-fpmaPATH-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,
latestpedig 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-datakapcsolót.