https://github.com/pimcore/docker
https://github.com/pimcore/docker
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/pimcore/docker
- Owner: pimcore
- Created: 2019-12-09T10:28:44.000Z (over 6 years ago)
- Default Branch: 4.x
- Last Pushed: 2025-02-19T14:24:50.000Z (over 1 year ago)
- Last Synced: 2025-02-19T15:30:04.464Z (over 1 year ago)
- Language: Dockerfile
- Size: 385 KB
- Stars: 78
- Watchers: 21
- Forks: 51
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Pimcore PHP Docker Image
This is are customized PHP Docker images specifically optimized for running [Pimcore](https://github.com/pimcore/pimcore).
It doesn't include the Pimcore software itself, it just provides an environment that fulfills all system requirements
of Pimcore, so that you can leverage the full functionality.
You can either use this image directly by mounting Pimcore into the container, or as a template for your customized
ready-to-deploy images.
## Usage
As a starting point please see [example docker-compose configuration](https://github.com/pimcore/skeleton/blob/HEAD/docker-compose.yaml).
## Image flavors
We're providing different image flavors:
- [`min`] PHP image for FPM and CLI with minimum requirements (e.g. `php8.2-min-latest`)
- [`default`] PHP image for FPM and CLI incl. all optional dependencies (e.g. `php8.2-latest` or `php8.2-default-latest`)
- [`max`] PHP image for FPM and CLI incl. all optional dependencies and additional extensions and software (e.g. `php8.2-max-latest`)
- [`debug`] PHP debug image based on the `default` flavor, including preconfigured Xdebug for FPM and CLI (e.g. `php8.2-debug-latest`)
- [`supervisord`] Supervisord image based on PHP image above, for cron & queue processing (e.g. `php8.2-supervisord-latest`)
## Versioning
Our images are versioned using a version-suffix staring with `-v` following SemVer (e.g. `-v2.0`).
With that we're able to allow smooth upgrades, breaking changes are only delivered with major versions.
Additionally we're offering 2 special tag suffixes:
- `-latest` always points to the latest available tag (recommended for local development)
- `-dev` always points to the work in progress
We're also offering special tags for specific PHP versions, e.g. `php8.2.5-v2.0`.
### Pimcore version compatibility & recommendations
| Image / Pimcore | v10 | v11 | v2023.3 | v2024.4 |v2025.x
|-----------------|-----|--|---------|---------|-----|
| v1 | ✅ | ✅ | ✅ | ✅ |❌ |
| v2 | ❌ | ✅ | ✅ | ✅ |❌ |
| v3 | ❌ | ✅* | ✅* | ✅ |✅ |
| v4 | ❌ | ❌ | ❌ | ✅* |✅* |
> *) recommended version
## Examples
### PHP images
```text
php8.2-latest # always use the latest PHP 8.2 image
php8.2-v1 # always point to the latest minor version of v1
php8.2-v1.0 # pin to specific image version, always using the latest bugfixes from PHP 8.2
php8.2.5-v1.0 # pin to a specific PHP version & image version
php8.2-dev # development image (build from the default branch)
```
### PHP Debug images
Same as PHP images, but using `-debug` after the PHP version:
```text
php8.2-debug-latest
php8.2-debug-v3
...
```
#### Configure Xdebug in your IDE
The following configuration depends on the default [`docker-compose.yaml`](https://github.com/pimcore/skeleton/blob/11.x/docker-compose.yaml).
#### Use step-debugging
- **Browser**: Install "Xdebug helper" browser extension for [Chrome](https://chrome.google.com/webstore/detail/xdebug-helper/eadndfjplgieldjbigjakmdgkmoaaaoc) or [Firefox](https://addons.mozilla.org/en-GB/firefox/addon/xdebug-helper-for-firefox/) and start debugging session in your tab.
- **CLI**: Run your command like this: `docker compose exec -e XDEBUG_TRIGGER=PHPSTORM php bin/console`
### Supervisord
Same as PHP images, but using `-supervisor` after the PHP version:
```text
php8.2-supervisor-latest
php8.2-supervisor-v3
...
```