Skip to content

docs: add Fastly snippets and security features documentation; update…#2305

Open
Renaud Hager (renaudhager) wants to merge 14 commits into
mainfrom
chores/update-paas-native-docs
Open

docs: add Fastly snippets and security features documentation; update…#2305
Renaud Hager (renaudhager) wants to merge 14 commits into
mainfrom
chores/update-paas-native-docs

Conversation

@renaudhager
Copy link
Copy Markdown
Member

This pull request adds new documentation and updates existing docs for Shopware PaaS Native, focusing on Fastly CDN configuration, security features, and PHP settings. The changes introduce dedicated pages for Fastly snippet management and security features (WAF), clarify Fastly service configuration, and provide improved guidance for PHP configuration in the application YAML and environment variables.

Fastly CDN and Security Documentation:

  • Added a new page detailing Fastly snippet configuration for the storefront service, including installation instructions and current limitations.
  • Introduced a new security features page describing the default Web Application Firewall (WAF) powered by Fastly NGWAF, with notes on future enhancements.
  • Updated the main Fastly CDN documentation to reference the new snippet configuration page and clarified the distinction between the storefront and cdn Fastly services.

PHP Configuration Documentation:

  • Added a new page for PHP settings configuration, documenting environment variables that control PHP behavior and linking to the official Shopware Docker image.
  • Enhanced the application YAML documentation to show how to specify PHP extensions, including examples and a description of the installer used. [1] [2] [3]

Copilot AI review requested due to automatic review settings May 22, 2026 18:25
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR expands the Shopware PaaS Native documentation around Fastly (CDN snippets + security/WAF) and PHP configuration, and updates the application.yaml reference to include PHP extensions.

Changes:

  • Added new docs pages for Fastly snippet management and for default security features (WAF).
  • Updated Fastly CDN docs to link to the snippets page and clarify the two Fastly services (storefront vs cdn).
  • Added a new PHP settings page and extended the application.yaml documentation with an app.php.extensions field and examples.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 9 comments.

Show a summary per file
File Description
products/paas/shopware/fundamentals/php-settings.md New page documenting PHP configuration via environment variables.
products/paas/shopware/fundamentals/application-yaml.md Documents app.php.extensions and adds examples to the YAML reference.
products/paas/shopware/cdn/security-features.md New page describing the default WAF/security features.
products/paas/shopware/cdn/index.md Clarifies Fastly integration and introduces the two-service model.
products/paas/shopware/cdn/fastly-snippets.md New page describing how to deploy Fastly snippets for the storefront service.

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

Comment thread products/paas/shopware/fundamentals/application-yaml.md Outdated
Comment thread products/paas/shopware/fundamentals/php-settings.md
Comment thread products/paas/shopware/fundamentals/php-settings.md Outdated
Comment thread products/paas/shopware/cdn/fastly-snippets.md Outdated
Comment thread products/paas/shopware/cdn/fastly-snippets.md Outdated
Comment thread products/paas/shopware/cdn/security-features.md Outdated
Comment thread products/paas/shopware/cdn/security-features.md Outdated
Comment thread products/paas/shopware/cdn/index.md Outdated
Comment thread products/paas/shopware/cdn/fastly-snippets.md Outdated
@Isengo1989
Copy link
Copy Markdown
Contributor

Renaud Hager (@renaudhager) does this PR make this obsolete or should they be merged?

https://github.com/shopware/docs/pull/1964/changes

@renaudhager
Copy link
Copy Markdown
Member Author

Renaud Hager (Renaud Hager (@renaudhager)) does this PR make this obsolete or should they be merged?

https://github.com/shopware/docs/pull/1964/changes

Yes it does, thanks for flagging it.

Micha Hobert (Isengo1989) and others added 4 commits May 26, 2026 10:53
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 10 comments.

Comment thread products/paas/shopware/fundamentals/php-settings.md
Comment thread products/paas/shopware/fundamentals/php-settings.md Outdated
Comment thread products/paas/shopware/cdn/security-features.md Outdated
Comment thread products/paas/shopware/cdn/security-features.md Outdated
Comment thread products/paas/shopware/cdn/security-features.md
Comment thread products/paas/shopware/cdn/fastly-snippets.md Outdated
Comment thread products/paas/shopware/cdn/fastly-snippets.md Outdated
Comment thread products/paas/shopware/cdn/fastly-snippets.md Outdated
Comment thread products/paas/shopware/cdn/index.md Outdated
Comment thread products/paas/shopware/cdn/index.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@tombojer Tom Bojer (tombojer) self-requested a review May 28, 2026 11:00
@renaudhager
Copy link
Copy Markdown
Member Author

Micha Hobert (@Isengo1989) let me know if anything else is needed for this PR.

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.

4 participants