add nginx + php-fpm deployment example

1 files changed, 34 insertions, 0 deletions

diff --git a/web/README.md b/web/README.md
index a82c492..e79abd4 100644
--- a/web/README.md
+++ b/web/README.md
@@ -50,6 +50,40 @@ dependency; the client is rustls-only.
 Cargo itself cannot produce these names: it always writes
 `target/<triple>/release/<bin>`. The script renames after each build.
 
+## nginx
+
+`web/nginx.conf.example` is a working server block for a subdomain with an
+existing certificate. On Arch-based systems:
+
+```sh
+sudo pacman -S nginx php-fpm
+sudo install -d -o "$USER" -g http -m 0755 /srv/zagan.bet
+sudo cp web/nginx.conf.example /etc/nginx/conf.d/zagan.bet.conf
+# edit server_name, root and the certificate paths, then:
+sudo nginx -t && sudo systemctl enable --now nginx php-fpm
+```
+
+The pool socket and user are Arch defaults (`http`,
+`/run/php-fpm/php-fpm.sock`). Check them and adjust `fastcgi_pass` if your
+distribution differs:
+
+```sh
+grep -E '^(user|group|listen)' /etc/php/php-fpm.d/www.conf
+```
+
+`rsync` publishes files as `0755`/`0644`, so the `http` worker and the php-fpm
+pool can read them without extra group juggling. `index.php` is the only
+script; any other `.php` request 404s instead of executing.
+
+PHP's opcache is enabled by default and revalidates timestamps every two
+seconds, so a deployed `index.php` takes effect without reloading php-fpm. If
+you ever set `opcache.validate_timestamps=0`, reload php-fpm after a deploy.
+
+The php-fpm unit on Arch uses `PrivateTmp=`, so the hash cache in `/tmp` lives
+in the service's private tmp. It still works; point `ZAGAN_HASH_CACHE` at a
+writable path such as `/var/cache/zagan-bet-hashes.json` if you want it to
+survive a service restart.
+
 ## Preview locally
 
 ```sh