Skip to main content

Requirements

  • PHP 8.2 or later, with the mbstring extension.
  • Composer.
  • Access to a Docker daemon with API v1.45 or later (Docker Engine 26.0 or later).
Docker PHP 4.0 is the last release line that supports PHP 8.1.

Stable installation

Composer also installs docker-php/docker-php-api, choosing the newest API line unless you require one. Requests negotiate with the daemon, so an older daemon still works. Require a specific line if your code depends on generated model names or fields.

Test the development version

For a disposable test application, explicitly allow both development packages:
Do not use these moving development versions for an unattended production upgrade. Commit your application’s composer.lock after testing. If you already use Docker PHP or Beluga, follow the migration guide instead of installing both package families together.