Skip to content

Improve Docker build times by compiling PHP extensions in parallel #315

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
clue merged 3 commits into from
Oct 29, 2026
Merged

Improve Docker build times by compiling PHP extensions in parallel #315

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b928a31
Avoid unneeded build dependencies to speed up Docker build
clue Oct 26, 2026
dbd41e3
Improve Docker build to compile PHP extensions in parallel stages
clue Oct 26, 2026
566961e
Improve Dockerfile structure to avoid unneeded instructions
clue Oct 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 23 additions & 13 deletions docs/best-practices/deployment.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -690,7 +690,6 @@ be achieved by using a `Dockerfile` with the following contents:
=== "Dockerfile basics for development"

```docker title="Dockerfile"
# syntax=docker/dockerfile:1
FROM php:8.5-cli

WORKDIR /app/
Expand All @@ -706,27 +705,38 @@ be achieved by using a `Dockerfile` with the following contents:
=== "Dockerfile for minimal production image"

```docker title="Dockerfile"
# syntax=docker/dockerfile:1
FROM composer:2 AS build
# base PHP version for the build and final project
FROM php:8.5-alpine AS php-version

WORKDIR /app/
# base composer stage to install dependencies in parallel
FROM composer:2 AS vendor
COPY composer.json composer.lock ./
RUN composer install --no-dev --ignore-platform-reqs --optimize-autoloader

FROM php:8.5-alpine
# base build stage with build tools to compile extensions in parallel
FROM php-version AS phpize
RUN apk --no-cache add --virtual .phpize-deps autoconf gcc libc-dev linux-headers make

FROM phpize AS ext-ev
RUN MAKEFLAGS="-j$(nproc)" pecl install ev && docker-php-ext-enable ev

FROM phpize AS ext-sockets
RUN docker-php-ext-install -j$(nproc) sockets

# recommended: install optional extensions ext-ev and ext-sockets
RUN apk --no-cache add ${PHPIZE_DEPS} libev linux-headers \
&& pecl install ev \
&& docker-php-ext-enable ev \
&& docker-php-ext-install sockets \
&& apk del ${PHPIZE_DEPS} linux-headers \
&& echo "memory_limit = -1" >> "$PHP_INI_DIR/conf.d/acme.ini"
# base os stage with recommended extensions ext-ev and ext-sockets
FROM php-version AS os
COPY --from=ext-ev /usr/local/lib/php/extensions/ /usr/local/lib/php/extensions/
COPY --from=ext-ev /usr/local/etc/php/conf.d/docker-php-ext-ev.ini /usr/local/etc/php/conf.d/
COPY --from=ext-sockets /usr/local/lib/php/extensions/ /usr/local/lib/php/extensions/
COPY --from=ext-sockets /usr/local/etc/php/conf.d/docker-php-ext-sockets.ini /usr/local/etc/php/conf.d/
RUN echo "memory_limit = -1" >> "$PHP_INI_DIR/conf.d/acme.ini"

# final project stage
FROM os
WORKDIR /app/
COPY public/ public/
# COPY src/ src/
COPY --from=build /app/vendor/ vendor/
COPY --from=vendor /app/vendor/ vendor/

ENV X_LISTEN=0.0.0.0:8080
EXPOSE 8080
Expand Down
1 change: 0 additions & 1 deletion tests/integration/Dockerfile-basics
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
# syntax=docker/dockerfile:1
FROM php:8.5-cli

WORKDIR /app/
Expand Down
35 changes: 23 additions & 12 deletions tests/integration/Dockerfile-production
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,27 +1,38 @@
# syntax=docker/dockerfile:1
FROM composer:2 AS build
# base PHP version for the build and final project
FROM php:8.5-alpine AS php-version

WORKDIR /app/
# base composer stage to install dependencies in parallel
FROM composer:2 AS vendor
COPY composer.json composer.lock ./
# production environment should install optimized dependencies:
# RUN composer install --no-dev --ignore-platform-reqs --optimize-autoloader
# dev environment already has dependencies installed:
COPY vendor/ vendor/

FROM php:8.5-alpine
# base build stage with build tools to compile extensions in parallel
FROM php-version AS phpize
RUN apk --no-cache add --virtual .phpize-deps autoconf gcc libc-dev linux-headers make

FROM phpize AS ext-ev
RUN MAKEFLAGS="-j$(nproc)" pecl install ev && docker-php-ext-enable ev

FROM phpize AS ext-sockets
RUN docker-php-ext-install -j$(nproc) sockets

# recommended: install optional extensions ext-ev and ext-sockets
RUN apk --no-cache add ${PHPIZE_DEPS} libev linux-headers \
&& pecl install ev \
&& docker-php-ext-enable ev \
&& docker-php-ext-install sockets \
&& apk del ${PHPIZE_DEPS} linux-headers \
&& echo "memory_limit = -1" >> "$PHP_INI_DIR/conf.d/acme.ini"
# base os stage with recommended extensions ext-ev and ext-sockets
FROM php-version AS os
COPY --from=ext-ev /usr/local/lib/php/extensions/ /usr/local/lib/php/extensions/
COPY --from=ext-ev /usr/local/etc/php/conf.d/docker-php-ext-ev.ini /usr/local/etc/php/conf.d/
COPY --from=ext-sockets /usr/local/lib/php/extensions/ /usr/local/lib/php/extensions/
COPY --from=ext-sockets /usr/local/etc/php/conf.d/docker-php-ext-sockets.ini /usr/local/etc/php/conf.d/
RUN echo "memory_limit = -1" >> "$PHP_INI_DIR/conf.d/acme.ini"

# final project stage
FROM os
WORKDIR /app/
COPY public/ public/
# COPY src/ src/
COPY --from=build /app/vendor/ vendor/
COPY --from=vendor /app/vendor/ vendor/

ENV X_LISTEN=0.0.0.0:8080
EXPOSE 8080
Expand Down