Add minimal nginx reverse proxy configuration

Author: clue

.github/workflows/ci.yml

@@ -111,12 +111,15 @@ jobs:
         if: ${{ always() }}
 
   nginx-reverse-proxy:
-    name: nginx reverse proxy + X
+    name: nginx (${{ matrix.config.name }})
     runs-on: ubuntu-22.04
     strategy:
       matrix:
         config:
-          - nginx-reverse-proxy-public.conf
+          - name: reverse proxy with files
+            path: nginx-reverse-proxy-public.conf
+          - name: minimal reverse proxy
+            path: nginx-reverse-proxy-minimal.conf
     steps:
       - uses: actions/checkout@v4
       - uses: shivammathur/setup-php@v2
@@ -125,7 +128,7 @@ jobs:
       - run: composer install -d tests/integration/
       - run: docker build -f tests/integration/Dockerfile-basics tests/integration/
       - run: docker run -d -p 8080:8080 -v "$PWD/composer.json":/app/composer.json $(docker images -q | head -n1)
-      - run: docker run -d --net=host -v "$PWD/tests/integration/":/home/framework-x/ -v "$PWD"/tests/integration/${{ matrix.config }}:/etc/nginx/conf.d/default.conf nginx:stable-alpine
+      - run: docker run -d --net=host -v "$PWD/tests/integration/":/home/framework-x/ -v "$PWD"/tests/integration/${{ matrix.config.path }}:/etc/nginx/conf.d/default.conf nginx:stable-alpine
       - run: bash tests/await.sh http://localhost
       - run: bash tests/integration.bash http://localhost
       - run: docker stop $(docker ps -qn2)

docs/best-practices/deployment.md

@@ -421,29 +421,44 @@ all you need to do is to point the nginx' [`root`](http://nginx.org/en/docs/http
 to instruct nginx to process any dynamic requests through X. This can be
 achieved by using an nginx configuration with the following contents:
 
-```
-server {
-    # Serve static files from `public/`, proxy dynamic requests to Framework X
-    location / {
-        location ~* \.php$ {
+=== "nginx.conf (reverse proxy with static files)"
+
+    ```
+    server {
+        # Serve static files from `public/`, proxy dynamic requests to Framework X
+        location / {
+            location ~* \.php$ {
+                try_files /dev/null @x;
+            }
+            root /home/alice/projects/acme/public;
+            try_files $uri @x;
+        }
+
+        location @x {
+            proxy_pass http://localhost:8080;
+            proxy_set_header Host $host;
+            proxy_set_header Connection "";
+        }
+
+        # Optional: handle Apache config with Framework X if it exists in `public/`
+        location ~ \.htaccess$ {
             try_files /dev/null @x;
         }
-        root /home/alice/projects/acme/public;
-        try_files $uri @x;
     }
+    ```
 
-    location @x {
-        proxy_pass http://localhost:8080;
-        proxy_set_header Host $host;
-        proxy_set_header Connection "";
-    }
+=== "nginx.conf (minimal reverse proxy)"
 
-    # Optional: handle Apache config with Framework X if it exists in `public/`
-    location ~ \.htaccess$ {
-        try_files /dev/null @x;
+    ```
+    server {
+        # Proxy all requests to Framework X
+        location / {
+            proxy_pass http://localhost:8080;
+            proxy_set_header Host $host;
+            proxy_set_header Connection "";
+        }
     }
-}
-```
+    ```
 
 > ℹ️ **New to nginx?**
 >

tests/integration/nginx-reverse-proxy-minimal.conf

@@ -0,0 +1,8 @@
+server {
+    # Proxy all requests to Framework X
+    location / {
+        proxy_pass http://localhost:8080;
+        proxy_set_header Host $host;
+        proxy_set_header Connection "";
+    }
+}