Skip to content

Commit 4417f66

Browse files
authored
Fix Docker quickstart: install intl before composer create-project (#8322)
The base composer image does not bundle the intl extension, so the documented 'docker run ... composer create-project' command failed with 'ext-intl is missing from your system' when resolving cakephp/cakephp. Run Composer inside a php:8.2-cli image with intl installed instead, matching the development-server step that follows.
1 parent 98b9cab commit 4417f66

1 file changed

Lines changed: 8 additions & 3 deletions

File tree

docs/en/installation.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -130,9 +130,14 @@ Check [DDEV Documentation](https://ddev.readthedocs.io/) for installation and ad
130130
For containerized development:
131131

132132
```bash
133-
# Create project using Composer in Docker
134-
docker run --rm -v $(pwd):/app composer create-project \
135-
--prefer-dist cakephp/app:~|cakeversion| my_app
133+
# Create project using Composer in Docker.
134+
# CakePHP requires the intl extension, which the base composer image does not
135+
# provide, so run Composer inside a PHP image with intl installed.
136+
docker run --rm -v $(pwd):/app -w /app php:8.2-cli bash -c \
137+
"apt-get update && apt-get install -y libicu-dev git unzip curl \
138+
&& docker-php-ext-install intl \
139+
&& curl -sS https://getcomposer.org/installer | php \
140+
&& php composer.phar create-project --prefer-dist cakephp/app:~|cakeversion| my_app"
136141

137142
# Start PHP development server (install required extensions first)
138143
cd my_app

0 commit comments

Comments
 (0)