umlaut-press/README.md

Umlaut Press

Static site plus legacy PHP archive (preservation), served by Nginx and PHP 7.4-FPM in a single Docker container.

---

Architecture (refresher)

• One container: Nginx (port 80) + PHP 7.4-FPM (localhost:9000). The image is built from the root Dockerfile and used for production.
• Web root: Everything under src/ is copied into the image at /usr/share/nginx/html/. Nginx serves static files and proxies *.php to PHP-FPM.
• Static: HTML, CSS, JS, images, fonts — served by Nginx with cache rules (short cache for HTML, long for assets).
• PHP: Used for the legacy archive under src/site_archive/ (sites unchanged since ~2010). PHP runs in a compatibility-oriented mode (see below); apps that need a database (e.g. old WordPress/phpBB in the archive) will not work fully, but simple PHP pages do.
• Production base: php:7.4-fpm-alpine (Alpine, minimal). Dev container: php:7.4-fpm (Debian) so Cursor/VS Code have bash; see .devcontainer/README.md.

Request flow

1. Request hits Nginx (port 80).
2. Static file (e.g. .html, .css, .js, images) → Nginx serves from /usr/share/nginx/html/ with the appropriate cache headers.
3. *.php → Nginx passes to PHP-FPM on 127.0.0.1:9000; PHP runs the script and returns the response.

Startup (inside container)

entrypoint.sh runs when the container starts:

1. Start PHP-FPM in the background (php-fpm -D).
2. Start Nginx in the foreground (nginx -g 'daemon off;') so the container stays up.

---

Directory layout

Path	Purpose
src/	Web root: static site + site_archive/ (legacy PHP). Deploy = copy this into the image.
nginx/conf.d/	Nginx server config: default.conf (vhost, cache rules, PHP location).
php/conf.d/	PHP overrides: 99-legacy.ini (error_reporting, short_open_tag, limits for old code).
entrypoint.sh	Starts PHP-FPM then Nginx.
Dockerfile	Production image: Alpine + Nginx + PHP 7.4-FPM, configs and src/ copied in.
.devcontainer/	Dev container (Debian-based) for local testing; mounts src/ for live edits.
.woodpecker/	CI (lint, etc.) and build/deploy (Docker build, push, Portainer).

---

Run locally

Option A: Docker (no dev container)

docker build -t umlaut-press .
docker run -p 8080:80 umlaut-press

Then open http://localhost:8080 (and e.g. http://localhost:8080/site_archive/2004/ for the archive).

Option B: Dev container (recommended for editing)

1. Open repo in Cursor/VS Code.
2. Command Palette → “Dev Containers: Reopen in Container”.
3. When the container is up, open http://localhost (port 80 is forwarded). Edits under src/ are reflected on refresh.

Details and troubleshooting (e.g. “bash not found” / old container reuse): .devcontainer/README.md.

---

Build and deploy

• Scripts (see package.json): docker:build, docker:push (image tag: git.mifi.dev/mifi/umlaut-press:latest).
• CI: .woodpecker/ci.yml (e.g. format/lint). Build/deploy: .woodpecker/build.yml and .woodpecker/deploy.yml — on push/tag to main, build the image, push to the registry, and trigger the Portainer stack redeploy.

---

PHP legacy / compatibility

• Version: PHP 7.4 (EOL) chosen so pre-2010 archive code runs without changes.
• Config: php/conf.d/99-legacy.ini — suppresses deprecation/strict notices, enables short_open_tag, raises limits. Keeps the archive viewable; not for running DB-backed apps (WordPress, phpBB, etc.) unless you add a DB and config.

---

Quick reference

I want to…	Do this
Test the site locally	Use the dev container (Reopen in Container) and open http://localhost.
Change Nginx (cache, vhost)	Edit nginx/conf.d/default.conf, rebuild image.
Change PHP behavior	Edit php/conf.d/99-legacy.ini, rebuild image.
Add or change static/PHP content	Edit or add files under src/. In dev container, just refresh the browser.
Build the production image	pnpm run docker:build or docker build -t umlaut-press .
Deploy	Push to main (Woodpecker builds and deploys) or run docker:push and update the stack yourself.