Skip to content

About

Official Docker images suitable for Yii 2.0

Topics

Resources

Code of conduct

Stars

399 stars

Watchers

37 watching

Forks

Repository files navigation

Yii2 PHP Docker Image


Build Status

This is the repo of the official Yii 2.0 Framework image on DockerHub for PHP.

About

These Docker images are built on top of the official PHP Docker image, they contain additional PHP extensions required to run Yii 2.0 framework, but no code of the framework itself. The Dockerfile(s) of this repository are designed to build from different PHP-versions by using build arguments.

Available versions for yiisoftware/yii2-php

The following images are built on a weekly basis for arm64 and amd64. For regular commits on master we only build images for amd64 suffixed with -latest/-latest-min.

Minimal images

8.5-apache-min, 8.5-fpm-min, 8.5-fpm-nginx-min
8.4-apache-min, 8.4-fpm-min, 8.4-fpm-nginx-min
8.3-apache-min, 8.3-fpm-min, 8.3-fpm-nginx-min
8.2-apache-min, 8.2-fpm-min, 8.2-fpm-nginx-min
8.1-apache-min, 8.1-fpm-min, 8.1-fpm-nginx-min

Development images

8.5-apache, 8.5-fpm, 8.5-fpm-nginx
8.4-apache, 8.4-fpm, 8.4-fpm-nginx
8.3-apache, 8.3-fpm, 8.3-fpm-nginx
8.2-apache, 8.2-fpm, 8.2-fpm-nginx
8.1-apache, 8.1-fpm, 8.1-fpm-nginx

Warning: PHP 8.1 is end of life and gets no security fixes from the PHP project anymore. The 8.1-* images are no longer rebuilt and remain affected by CVE-2026-109618 and CVE-2026-109619 (PHP2Shell). Do not expose them to untrusted traffic, upgrade to 8.2 or later.

Deprecated or EOL versions

No longer rebuilt, no security fixes from PHP (e.g. CVE-2026-109618, CVE-2026-109619).

8.0-*
7.4-*
7.3-*
7.2-*
7.1-*
7.0-*
5.6-*

Setup

cp .env-dist .env

Adjust the versions in .env if you want to build a specific version.

Note: Please make sure to use a matching combination of DOCKERFILE_FLAVOUR and PHP_BASE_IMAGE_VERSION

Configuration

  • GITHUB_API_TOKEN access key for repositories on GitHub
  • GITLAB_ACCESS_TOKEN access key for repositories in GitLab
  • PHP_ENABLE_XDEBUG whether to load an enable Xdebug, defaults to 0 (false) not available in -min images
  • PHP_USER_ID (Debian only) user ID, when running commands as webserver (www-data), see also #15

Upload limits

Breaking change: Previous images allowed request bodies up to 512M. Since the PHP2Shell update, they are limited to 64M as a mitigation for CVE-2026-109618. Larger uploads are rejected with HTTP 413 by Apache/nginx, or with UPLOAD_ERR_INI_SIZE by PHP.

Setting Value Where
post_max_size 64M /usr/local/etc/php/conf.d/base.ini
upload_max_filesize 60M /usr/local/etc/php/conf.d/base.ini
LimitRequestBody 67108864 /etc/apache2/sites-available/000-default.conf (-apache)
client_max_body_size 64M /etc/nginx/conf.d/default.conf (-fpm-nginx)

The advisory asks for a conservative post_max_size and an independent request size limit at the frontend, because a multipart request without a usable Content-Length can get past the post_max_size check. If your application needs larger uploads, raise the PHP and the web server limit together:

  • PHP (all images): add an ini file that sorts after base.ini, e.g. /usr/local/etc/php/conf.d/uploads.ini:
    post_max_size=512M
    upload_max_filesize=500M
  • -apache: /app/web has AllowOverride All, so one line in web/.htaccess is enough:
    LimitRequestBody 536870912
  • -fpm-nginx: client_max_body_size is set at server level, so an additional file in conf.d/ does not override it. Mount your own /etc/nginx/conf.d/default.conf.
  • -fpm behind your own web server: the ini file, plus the limit of that web server.

Building

docker-compose build

Testing

docker-compose run --rm php php /tests/requirements.php

Xdebug

To enable Xdebug, set PHP_ENABLE_XDEBUG=1 in .env file

Xdebug is configured to call ip xdebug.remote_host on 9005 port (not use standard port to avoid conflicts), so you have to configure your IDE to receive connections from that ip.

Documentation

More information can be found in the docs folder.

FAQ

  • We do not officially support Alpine images, due to numerous issues with PHP requirements and because framework tests are not passing.
  • Depending on the (Debian) base-image (usually PHP <7.4) you might need to set X_LEGACY_GD_LIB=1
  • test

About

Official Docker images suitable for Yii 2.0

Topics

Resources

Code of conduct

Stars

399 stars

Watchers

37 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages