Skip to content

Commit 7d5ca2f

Browse files
docs: mention request header filtering on migration
1 parent 7b4cfc8 commit 7d5ca2f

1 file changed

Lines changed: 2 additions & 1 deletion

File tree

docs/migrate.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ This guide covers a basic migration for a typical PHP application.
2323
## HTTP request filtering
2424

2525
When migrating from a stock Nginx or Apache package, check any request filtering that was done by the web server before PHP-FPM received the request.
26-
FrankenPHP is built on Caddy, so valid HTTP methods and headers are passed through Caddy's normal routing unless your `Caddyfile` rejects them first.
26+
FrankenPHP is built on Caddy, so valid HTTP methods and headers are passed through Caddy's normal routing unless your `Caddyfile` or another proxy rejects them first.
2727

2828
For example, some web servers reject `TRACE` requests by default.
2929
If your application should keep that behavior, add an explicit matcher before `php_server`:
@@ -39,6 +39,7 @@ example.com {
3939
```
4040

4141
Apply the same approach to any stricter method or header policy your previous front web server enforced.
42+
This is also relevant for request header names: some front web servers or proxies reject or drop valid-but-uncommon HTTP field names before PHP-FPM sees them, while FrankenPHP may pass them to the PHP application.
4243

4344
## Step 1: replace your web server config
4445

0 commit comments

Comments
 (0)