Skip to content

Fix |phpversion| rendering literally as **8.5** in Docker commands; update installation.md too - #8344

Merged
markstory merged 2 commits into
cakephp:5.xfrom
Nelwhix:fix/docker-quickstart-followup
Oct 2, 2026
Merged

markstory merged 2 commits into
cakephp:5.xfrom
Nelwhix:fix/docker-quickstart-followup

Conversation

@Nelwhix

@Nelwhix Nelwhix commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

Follow-up to #8343, addressing @LordSimal's two comments there:

Thanks, it looks better, but the version replacement has two ** in there.

Pinned the tag to 8.5 directly instead.

Also can you fix the docker part in
https://book.cakephp.org/5.x/installation.html#method-3-docker as well
and maybe other places, where the new image could be used?

Updated docs/en/installation.md's "Method 3: Docker" section to the same
ghcr.io/cakephp/cakephp image.

Follow-up to cakephp#8343. The |phpversion| substitution is configured with
format: 'bold', which wraps the value in markdown ** syntax. That's
fine in prose, but markdown-it doesn't process inline markdown inside
fenced code blocks, so readers saw the literal text
"ghcr.io/cakephp/cakephp:**8.5**" instead of a working image tag.

Pinned the tag to 8.5 directly in both Docker commands on the
homepage instead (same convention the Docker block already used
before, where the PHP version was hardcoded as php:8.2-cli).

Also updated the Docker section (Method 3) on the installation page
to the same ghcr.io/cakephp/cakephp image, since it had the identical
underlying bugs (missing intl/pdo_mysql, apt-get installing
extensions at runtime, "php bin/cake" instead of "php bin/cake.php").
Grepped the rest of docs/ for other docker run / php:8.x examples;
these two pages were the only ones referencing CakePHP's own Docker
setup.

Verified both updated commands end to end again with real
`docker run`: composer create-project and the dev server both work
against ghcr.io/cakephp/cakephp:8.5, welcome page returns HTTP 200.
Avoids hardcoding 8.5 directly in the Docker commands (which would
need manual updates across both pages every time the documented PHP
version bumps). Adds |phpdockerversion| as a plain, unformatted
substitution (same pattern as |cakeversion|) alongside the existing
bold-formatted |phpversion| used in prose, so the two don't conflict.
@markstory
markstory merged commit ec82017 into cakephp:5.x Oct 2, 2026
6 checks passed
@markstory markstory added this to the 5.x milestone Oct 2, 2026
@markstory

Copy link
Copy Markdown
Member

Thank you 🎉

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants