From 7588775f8ac426e80f73a2253f4e7fb65d8b7e6e Mon Sep 17 00:00:00 2001 From: Nelson Isioma Date: Thu, 24 Sep 2026 20:55:17 +0100 Subject: [PATCH] Fix Docker quickstart on homepage: intl, bin/cake, pdo_mysql The homepage Quick Start Docker snippet has the same ext-intl bug already fixed in installation.md (#8322), plus two more bugs: `php bin/cake server` silently no-ops instead of starting a server, and the missing pdo_mysql extension turns the welcome page's DB check into a hard 500 instead of a graceful checklist item. Co-Authored-By: Claude Sonnet 5 --- docs/en/index.md | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/docs/en/index.md b/docs/en/index.md index 45116e5c4e..598e29d262 100644 --- a/docs/en/index.md +++ b/docs/en/index.md @@ -58,13 +58,20 @@ ddev launch ``` ```bash [Docker] -# Using official PHP image -docker run -it --rm -v $(pwd):/app composer create-project \ - --prefer-dist cakephp/app:~|cakeversion| my_app - +# CakePHP requires the intl extension, which the official composer image +# does not provide, so Composer is run inside a PHP image with intl installed +docker run --rm -v $(pwd):/app -w /app php:8.2-cli bash -c \ + "apt-get update && apt-get install -y libicu-dev git unzip curl \ + && docker-php-ext-install intl \ + && curl -sS https://getcomposer.org/installer | php \ + && php composer.phar create-project --prefer-dist cakephp/app:~|cakeversion| my_app" + +# Start development server (install required extensions first) cd my_app -docker run -it --rm -p 8765:8765 -v $(pwd):/app \ - -w /app php:8.2-cli php bin/cake server -H 0.0.0.0 +docker run -it --rm -p 8765:8765 -v $(pwd):/app -w /app php:8.2-cli \ + bash -c "apt-get update && apt-get install -y libicu-dev \ + && docker-php-ext-install intl pdo_mysql \ + && php bin/cake.php server -H 0.0.0.0" ``` :::