Jak buduję własny obraz PHP (dommin/php-8.4-fpm), publikuję go na Docker Hub i przebudowuję z GitHub Actions.
Dlaczego warto tworzyć własne obrazy Docker?
Trzymam własny obraz PHP z trzech powodów: każdy deweloper i każdy job CI dostaje te same wersje PHP i rozszerzeń, buildy nie instalują za każdym razem popularnych pakietów, a PHP ma wersję niezależną od kodu aplikacji.
To obraz dommin/php-8.4-fpm z poprzednich artykułów, z PHP 8.4, popularnymi rozszerzeniami, Node.js i Composerem.
Planowanie własnego obrazu PHP
Kluczowe aspekty do rozważenia:
Zacznij od opartego na Debianie php:8.4-fpm. Zdecyduj, jakich rozszerzeń PHP i pakietów systemowych potrzebują aplikacje, jakie narzędzia mają wejść do obrazu (Composer, Node.js, Git) i jak dopasować uprawnienia plików między hostem a kontenerem (USER_ID/GROUP_ID).
Przykład wymagań:
Dla Laravela potrzebuję:
- PHP 8.4 z FPM
- Rozszerzenia: PDO, MySQL, PostgreSQL, GD, Zip, BCMath, Redis, itp.
- Composer
- Node.js i NPM
- Git dla zależności Composera
Budowanie własnego obrazu PHP
Dockerfile:
FROM php:8.4-fpm
ARG USER_ID=1000
ARG GROUP_ID=1000
RUN apt-get update && apt-get install -y --no-install-recommends \
git curl unzip zip \
libpng-dev libjpeg-dev libwebp-dev libfreetype6-dev \
libonig-dev libxml2-dev libzip-dev \
imagemagick libmagick++-dev \
libpq-dev \
autoconf g++ make \
supervisor \
rsync \
wget gnupg2 \
&& mkdir -p /etc/apt/keyrings \
&& curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg \
&& echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_22.x nodistro main" > /etc/apt/sources.list.d/nodesource.list \
&& apt-get update \
&& apt-get install -y nodejs \
&& pecl install redis imagick xdebug \
&& docker-php-ext-enable redis imagick xdebug \
&& docker-php-ext-configure gd --with-freetype --with-jpeg --with-webp \
&& docker-php-ext-install -j$(nproc) \
pdo_mysql pdo_pgsql mysqli \
zip bcmath pcntl intl \
gd opcache \
&& wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | gpg --dearmor -o /etc/apt/keyrings/google-chrome.gpg \
&& echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/google-chrome.gpg] https://dl.google.com/linux/chrome/deb/ stable main" > /etc/apt/sources.list.d/google-chrome.list \
&& apt-get update \
&& apt-get install -y google-chrome-stable \
&& apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
RUN groupmod -g ${GROUP_ID} www-data \
&& usermod -u ${USER_ID} -g www-data www-data \
&& mkdir -p /var/www /var/log/supervisor /var/run/supervisor \
&& chown -R www-data:www-data /var/www /var/log/supervisor /var/run/supervisor
COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
WORKDIR /var/www
EXPOSE 9000
CMD ["php-fpm"]
Wyjaśnienie kluczowych komponentów:
Node.js 22.x pochodzi z NodeSource, Composer jest kopiowany z oficjalnego obrazu composer, a USER_ID/GROUP_ID przemapowują www-data na użytkownika hosta. Poza zwykłymi rozszerzeniami obraz instaluje też Xdebug, Imagick, supervisor i Google Chrome. Xdebug jest włączony domyślnie, co spowalnia każde żądanie PHP, więc używaj tego obrazu do developmentu i CI; na produkcję zbuduj odchudzony obraz bez Xdebuga i Chrome. Repozytorium Chrome jest dodane przez podpisany keyring (apt-key jest przestarzałe), a NodeSource tak samo, zamiast przekazywania skryptu do bash.
Publikowanie na Docker Hub
Obraz trafia na Docker Hub.
1. Utwórz konto na Docker Hub
Jeśli jeszcze go nie masz, zarejestruj się na Docker Hub.
2. Utwórz repozytorium
Kliknij "Create Repository" w panelu, nadaj nazwę (np. username/php) i ustaw widoczność: publiczne lub prywatne.
3. Zaloguj się do Docker Hub z CLI
docker login
Wprowadź nazwę użytkownika i osobisty token dostępu Docker Hub (Account settings, Security) po wyświetleniu monitu.
4. Zbuduj swój obraz
docker build -t username/php:8.4-fpm -f ./Dockerfile .
5. Wypchnij swój obraz na Docker Hub
docker push username/php:8.4-fpm
6. Zweryfikuj przesłanie
Odwiedź swoje repozytorium na Docker Hub i sprawdź, czy obraz się przesłał.
Automatyzacja budowania z GitHub Actions
Workflow GitHub Actions przebudowuje i wypycha obraz przy każdym pushu na main. Potrzebuje sekretów repozytorium DOCKER_USERNAME i DOCKER_PASSWORD (użyj tokenu dostępu Docker Hub, nie hasła do konta). Każdy build dostaje też tag z SHA commita, więc projekt możesz przypiąć do konkretnego obrazu zamiast latest:
name: Build images
on:
push:
branches:
- main
env:
PHP_IMAGE: dommin/php-8.4-fpm:latest
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: docker/login-action@v3
with:
username: ${{ secrets.DOCKER_USERNAME }}
password: ${{ secrets.DOCKER_PASSWORD }}
- name: Build images
run: docker build -t $PHP_IMAGE -t dommin/php-8.4-fpm:${{ github.sha }} -f ./8.4-fpm/Dockerfile .
- name: Push images
run: docker push --all-tags dommin/php-8.4-fpm
Podsumowanie
Obraz jest budowany z powyższego Dockerfile, publikowany jako dommin/php-8.4-fpm:latest i przebudowywany przez workflow przy każdym pushu na main.