Clarify DDEV extra packages for Debian Bookworm and older setups

[HimanshuRamavat07]

Problem

The TYPO3 Contribution Workflow documentation instructs users to configure
DDEV with:

--webimage-extra-packages='build-essential,locales-all'

Recent DDEV versions (≥ 1.24) use Debian 12 (Bookworm) as the base image.
On Debian Bookworm, the locales-all package has been removed, which causes
Docker build failures when following the documentation verbatim.

Older DDEV versions (based on earlier Debian releases) still support
locales-all, which can lead to confusion when contributors compare setups.

Solution

This change keeps compatibility with both environments by:

• Using locales as the default package in the example command
• Adding a short explanatory note describing the difference between
  newer (Bookworm-based) and older DDEV versions

Impact

• Prevents DDEV startup failures for new contributors
• Clarifies version-specific behavior without breaking older setups
• Improves onboarding experience for TYPO3 core contributors

References

• Debian Bookworm package status:
  https://packages.debian.org/bookworm/locales
• Removal of locales-all in Debian Bookworm:
  https://packages.debian.org/search?keywords=locales-all
• DDEV base image (Debian Bookworm):
  https://github.com/ddev/ddev/releases

[rfay]

This is not correct. locales-all is available in Debian Bookworm and Debian Trixie (which is the base in soon-to-be-released DDEV v1.25.0)

The link you give shows that the package is available: https://packages.debian.org/search?keywords=locales-all

You can easily demonstrate with ddev ssh and sudo apt update && sudo apt install locales-all

You can also run a debian:12 or debian:13 container and do the same thing.

The relevant code in DDEV that limits the number of locales is at https://github.com/ddev/ddev/blob/46d441cb1d40743d1666b4f095684e3e82c0b4bc/containers/ddev-webserver/Dockerfile#L87

If the TYPO3 community has other locales that are regularly needed, we'll sure consider a PR to include the list! The current list is at https://github.com/ddev/ddev/blob/46d441cb1d40743d1666b4f095684e3e82c0b4bc/containers/ddev-webserver/Dockerfile#L20

[HimanshuRamavat07]

@rfay Thanks for the detailed clarification, you’re absolutely right.
I initially misunderstood this as a Debian packaging issue, while the actual behavior comes from DDEV intentionally limiting the generated locales in the web image.

From the TYPO3 side, TYPO3 supports many backend languages at the application level (see the ISO language definitions in the core:
https://github.com/TYPO3/typo3/tree/main/typo3/sysext/core/Resources/Private/Language/Iso).

[linawolf]

So seems like we can close this

[HimanshuRamavat07]

Hello @linawolf,

Yes, that’s fine. Please note that in the latest DDEV setup, the parameter --webimage-extra-packages='build-essential,locales-all' breaks the TYPO3 setup.

[rfay]

@HimanshuRamavat07 if you can explain how that breaks the TYPO3 setup, it's actionable. The normal command would be ddev config --webimage-extra-packages=build-essential,locales-all (probably without single quotes).

Note that build-essential really isn't required for ordinary T3 dev, it would be used for developers of TYPO3.