docs: document environment variable config limitation

[Jonas Elfering (keulinho)]

Summary

• document how to display the complete Shopware configuration reference
• explain why runtime environment variable placeholders cannot be used with positive-minimum configuration options
• list all currently affected Shopware options

Related links

• Shopware cart.expire_days cannot be set through environment variables shopware#18256

Checklist

• I reviewed affected links, code samples, and cross-references, including PageRef references where relevant.
• I added or updated redirects in .gitbook.yaml if pages were moved, renamed, or deleted.
• I updated .wordlist.txt (and sorted it) if spellcheck flags new legitimate terms.
• Any required dependent changes in downstream modules have already been merged and published.
• This pull request is ready for review.

Notes

The affected option list is based on the positive minimum-value constraints in Shopware's current Configuration.php.

[shopware-dev-docs-connector]

Developer Docs healthcheck

Status: Completed with success.
Repository: shopware/docs
Commit: ccf615b
Preview: https://developer-documentation-8z2ymzoit-shopware-frontends.vercel.app
Workflow run: #4482

[Copilot]

Pull request overview

This PR updates the Shopware hosting configuration guide to document a Symfony/Shopware limitation where %env(...)% runtime placeholders cannot be used for certain Shopware configuration options that enforce a positive minimum during container compilation.

Changes:

• Add a command (bin/console config:dump-reference shopware) to display the full Shopware configuration reference for the installed version.
• Document why runtime %env(int:...)% placeholders fail for positive-minimum constrained config nodes.
• Provide a list of configuration keys currently impacted by this limitation.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Michael Telgmann (mitelg)]

aren't all configs affected, that have any validation? or is it really just the validation case of checking values bigger than zero? 🤔

[Jonas Elfering (keulinho)]

closing as it is fixed in newer symfony version, it's fixed with newer symfony config versions here: symfony/symfony#64045