10 KiB
docker_php_base
Základní Docker image pro Laravel aplikace (PHP 8.4). Registr: git.steelants.cz/steelants/docker_php_base.
Všechny image se buildují pro linux/amd64 a linux/arm64 (multi-arch manifest) workflow .gitea/workflows/docker-build.yaml při push do main, každou noc v 1:00 a ručně.
Přehled image
| Tag | Zdrojová složka | Základ | Web server | Stav |
|---|---|---|---|---|
latest |
apache/ |
php:8.4-apache |
Apache (mod_rewrite) |
původní verze (v1), beze změny |
v2-latest |
v2-apache/ |
php:8.4-apache |
Apache (mod_rewrite) |
nová verze (v2) |
alpine-v2-latest |
v2-fmp-alpine/ |
php:8.4-fpm-alpine |
žádný (jen PHP-FPM) | nová verze (v2), v produkci se nepoužívá |
Společné pro všechny image:
- PHP rozšíření:
pdo_mysql,pgsql,pdo_pgsql,zip,opcache,pcntl,sockets,bcmath,soap,gd(freetype, jpeg, webp),intl,calendar,imagick(s rsvg). Build selže, kdyžimagicknebogdnemají podporu JPEG. - Nástroje:
composer,git,node+npm,supervisor, klientimysqlapsql. - Časová zóna
Europe/Prague,COMPOSER_ALLOW_SUPERUSER=1. - Kořen aplikace
APP_ROOT=/var/www/html. memory_limit=256M,upload_max_filesizeapost_max_size100M, opcache (PHP_OPCACHE_*).- Apache image: document root
APACHE_DOCUMENT_ROOT=${APP_ROOT}/public(jde přepsat přes-e).
v1: latest (složka apache/)
Původní chování, nic se nemění:
- Supervisor konfigurace je statická:
supervisor/supervisord.conf(nodaemon=true,include conf.d/*.conf) asupervisor/conf.d/laravel-queues.conf(queue workerydefault,importstatistics,statistics,detections). - Scheduler běží přes cron:
* * * * * www-data cd /var/www/html && php artisan schedule:run, cron se spouští vapache2-foreground. - Supervisor se sám nespouští. Aplikace ho spouští ze svého
start.sh(supervisord -n &). - Žádné skripty při startu. Veškeré nastavení (
.env, composer, migrace, cache) dělástart.shaplikace.
v2: v2-latest a alpine-v2-latest
V2 přesouvá obecné kroky ze start.sh aplikace do základního image. Obě v2 varianty mají stejnou strukturu i stejné skripty (entrypoint.d/, supervisor.d/).
Jak se spouští
- Původní příkaz kontejneru (
apache2-foreground, resp.docker-php-entrypoint php-fpm) je upravený: těsně předexecvoláentrypoint-runner.sh. - Runner spustí v abecedním pořadí všechny spustitelné
/etc/entrypoint.d/*.sh. Každý běží jako samostatný proces (proměnné se mezi skripty nepředávají). - Selže-li skript, start se zastaví (
entrypoint script failed: <skript>, kontejner skončí). Ostatní skripty ani web server se nespustí. - Zpětná kompatibilita: pokud v kořeni aplikace existuje
start.sh($APP_ROOT/start.sh), runner se přeskočí aentrypoint.dse nespustí. Image se starýmstart.shtak nedostane nové skripty. - Pro alpine image platí totéž, jen runner běží ze stock
docker-php-entrypoint, takže projde každý příkaz (idocker run image php -v). Skripty v kontejneru bez aplikace (bezartisan,composer.json) proto končí kódem 0.
Skripty v /etc/entrypoint.d/ (pořadí spouštění)
| Skript | Co dělá | Poznámka |
|---|---|---|
05-permissions.sh |
chown -R www-data:www-data na storage a bootstrap/cache, jen když je vlastník horní složky jiný |
namountované volume bývá root-owned |
10-opcache.sh |
APP_DEBUG=false → nastaví opcache.validate_timestamps=${PHP_OPCACHE_VALIDATE_TIMESTAMPS:-1}; jinak (i když APP_DEBUG není nastavené) → opcache.enable=0 |
upravuje *opcache.ini v $PHP_INI_DIR/conf.d |
15-composer.sh |
bez composer.json nic; jinak composer install --prefer-dist --optimize-autoloader (s dev závislostmi při APP_DEBUG=true), jinak s --no-dev |
běží při každém startu, vyžaduje síť. $init se nepředává, rozhoduje jen APP_DEBUG |
20-env.sh |
existuje /config/.env → zkopíruje ho do .env; jinak, chybí-li .env a je .env.example, vytvoří .env z příkladu a uloží do /config/.env |
jen s artisan, /config je vždy volume |
25-key.sh |
php artisan key:generate --force --no-interaction jen když APP_KEY není v prostředí ani v .env; vygenerovaný .env uloží do /config/.env |
existující klíč nikdy nepřepíše |
26-cache.sh |
cache:clear, config:clear, route:clear, view:clear |
jen s artisan. Při CACHE_STORE=database běží před migracemi |
27-sqlite.sh |
je-li sqlite (DB_CONNECTION=sqlite v .env i v prostředí, nebo DEPLOY_ENV=sqlite), vytvoří prázdný database/database.sqlite |
složka database/ musí existovat |
30-storage.sh |
php artisan storage:link |
jen s artisan |
35-migrate.sh |
php artisan migrate --force --no-interaction |
běží při každém startu každého kontejneru, tedy i workerů a replik |
90-supervisord.sh |
zapíše /etc/supervisor/supervisord.conf (nodaemon=true, include /etc/supervisor/conf.d/*.conf) a spustí supervisord na pozadí |
Vlastní skript aplikace přidáš do /etc/entrypoint.d/ s vhodným číslem (soubor musí končit .sh, být spustitelný a používat #!/bin/sh). Chceš-li skript vypnout, smaž ho (RUN rm /etc/entrypoint.d/35-migrate.sh).
Supervisor (/etc/supervisor/conf.d/)
Soubory ze složky supervisor.d/ se kopírují do /etc/supervisor/conf.d/ a supervisor načte všechny *.conf:
laravel-queues.conf: tři queue workery (default,importstatistics,statistics,detections),user=www-data,autorestart.laravel-scheduler.conf:php artisan schedule:work(vyžaduje Laravel 8+). Nahrazuje cron, ten v2 neobsahuje.reverb.conf.example: příklad programureverb:start --host=0.0.0.0 --no-interaction --debug. Nenačítá se (přípona.example). Zapneš ho tak, že ho zkopíruješ jakoreverb.conf.
Cesty ke artisan se berou z %(ENV_APP_ROOT)s. Programy lze přidat nebo přepsat vlastními soubory v conf.d.
Volume
/config: perzistentní.envaAPP_KEY(viz20-env.sh,25-key.sh). Bez připojeného volume se.enva vygenerovaný klíč ztratí při novém kontejneru. Spolehlivější je nastavitAPP_KEYjako proměnnou prostředí.storage/appvolume si deklaruje aplikace sama.
Proměnné prostředí
| Proměnná | Výchozí | Význam |
|---|---|---|
APP_ROOT |
/var/www/html |
kořen aplikace (skripty, cron/supervisor) |
APACHE_DOCUMENT_ROOT |
${APP_ROOT}/public |
document root (jen apache) |
APP_DEBUG |
nenastaveno (alpine: false) |
řídí opcache a typ composer install |
PHP_OPCACHE_VALIDATE_TIMESTAMPS |
apache 1, alpine 0 |
použije se při APP_DEBUG=false |
PHP_OPCACHE_* |
viz Dockerfile | velikosti opcache |
APP_KEY |
nenastaveno | je-li nastavená, klíč se negeneruje |
DB_CONNECTION, DEPLOY_ENV |
nenastaveno | spouští přípravu sqlite (27-sqlite.sh) |
APP_ENV |
alpine production |
Rozdíly mezi v2-latest (apache) a alpine-v2-latest
- Alpine je PHP-FPM bez web serveru, před něj musí přijít vlastní web server (např. nginx).
- Alpine nastavuje
APP_ENV=productionaAPP_DEBUG=false, takže10-opcache.shponechá opcache zapnutou a15-composer.shpoužije--no-dev. - Alpine používá
docker-php-entrypointa nemámod_rewrite. - Alpine image se v produkci nepoužívá, byl ověřen jen testy na atrapě
artisan.
Migrace aplikace na v2 (podklad pro AI)
Postup pro aplikaci, která dnes dědí z docker_php_base:latest a má vlastní start.sh s CMD ["/var/www/html/start.sh"]:
- V
DockerfilezměňFROMnagit.steelants.cz/steelants/docker_php_base:v2-latest. - Smaž
start.sha řádkyRUN chmod +x /var/www/html/start.shaCMD ["/var/www/html/start.sh"]. Výchozí příkazapache2-foregrounduž spouštíentrypoint.d. Dokudstart.shvAPP_ROOTexistuje, v2 skripty se nespustí. - Smaž z
Dockerfileto, co už je v základu:RUN mkdir -p /config,VOLUME /configadocker-php-ext-install calendar(calendarje v základu).VOLUMEprostorage/appnech v aplikaci. - Z původního
start.shuž jsou v základu: příprava.envz/config, generováníAPP_KEY, sqlite,composer install,storage:link,migrate,*:clear, úprava opcache a spuštění supervisoru. - V základu není:
config:cache,route:cache,view:cachepro produkci, ainit(rozlišení prvního startu pro composer). Pokud je aplikace potřebuje, přidej vlastní skript, např.entrypoint.d/50-optimize.sh(běží po26-cache.sh), a zkopíruj hoCOPY --chmod=755 entrypoint.d/ /etc/entrypoint.d/. - Reverb (
php artisan reverb:start ... &vstart.sh) nahraď souborem/etc/supervisor/conf.d/reverb.conf(zkopíruj zreverb.conf.example). Řádek se&zestart.shodstraň, jinak poběží dvakrát. - Odstraň ze
start.sh/Dockeru vlastní spouštěnísupervisord.90-supervisord.shho spouští sám, dva supervisory by znamenaly duplicitní workery i scheduler. - Cron už v základu není a scheduler běží přes supervisor (
schedule:work, Laravel 8+). Aplikace, která dřív spoléhala na cron zlatesta nespouštěla supervisor, scheduler při přechodu ztratí.
Na co si dát při migraci pozor:
- Skripty jsou fail-fast. Chyba migrace, composeru nebo
cache:clearzastaví start kontejneru. - Migrace běží při každém startu každého kontejneru. U více replik se mohou přetahovat o zámek.
composer installběží při každém startu a potřebuje síť. Pokud jevendorhotový v buildu, zvaž smazání15-composer.sh.10-opcache.shvypíná opcache i tehdy, kdyžAPP_DEBUGnení nastavené. NastavAPP_DEBUG=false, chceš-li opcache v produkci.- Skripty byly ověřeny na atrapě
artisana prázdném projektu, ne na plné Laravel aplikaci.
Ruční build
docker build --platform linux/arm/v7,linux/arm64/v8,linux/amd64 -t git.steelants.cz/steelants/docker_php_base:latest ./apache
docker build -t git.steelants.cz/steelants/docker_php_base:v2-latest ./v2-apache
docker build -t git.steelants.cz/steelants/docker_php_base:alpine-v2-latest ./v2-fmp-alpine
docker push git.steelants.cz/steelants/docker_php_base:latest