37 lines
2.1 KiB
Markdown
37 lines
2.1 KiB
Markdown
## Philosophy
|
|
Minimal PHP for modern conveniences. Prioritize longevity (decade-scale maintainability) by avoiding volatile dependencies. Strictly add only what's essential—readable, simple, and future-proof.
|
|
|
|
## Edit instructions
|
|
All edits to this AGENT.md file should be done in a compressed shortform for LLM consumption.
|
|
|
|
## Core Constraints
|
|
**Minimalism:** Only essential tech (HTML, PHP 8.4+, CSS). No JS, frameworks, build tools, or package managers. Comments only for major sections.
|
|
|
|
**Frontend:**
|
|
- Classless, semantic HTML5
|
|
- Modern CSS: nesting, `oklch()`, grid, `clamp()`, logical props
|
|
- Responsive via fluid typography + flexible layouts
|
|
|
|
**Security:**
|
|
- Path validation blocks traversal
|
|
- Files restricted to document root
|
|
- Strict MIME types + no direct user-input execution
|
|
|
|
## Code Style
|
|
**PHP:** Modern syntax (arrow functions, null coalescing, match). Type hints where practical. Ternary for simple conditionals. Single-purpose functions.
|
|
|
|
**CSS:** Variables, native nesting, grid layouts. `clamp()` over `@media`. Relative units > pixels.
|
|
|
|
**Templates:** Escape output (`htmlspecialchars()` for UGC). Short echo tags (`<?= $var ?>`).
|
|
|
|
## Development Environment and workflow
|
|
|
|
The host does not have PHP, always use `podman compose` with the `compose.yaml` configuration when interacting with the app through CLI. Check localhost:4040 when you need to look at the development site to check your changes.
|
|
|
|
**LLM Agent Testing Protocol:**
|
|
**Container isolation:** ALL test data (CSV, temp files, generated content) MUST remain inside container filesystem (not mounted volumes)
|
|
*Testing website:** `curl localhost:4040/path` to fetch pages, test forms with `curl -X POST -d "field=value" localhost:4040/path`
|
|
- **Test data paths:** Use `/tmp/` or `/var/test/` inside container—never write to `/var/www/html` or mounted dirs during tests
|
|
**Running tests:** `podman exec stopplidelsen.no php /path/to/test.php` or `podman-compose run --rm custom php /tmp/test-script.php`
|
|
**Syntax checks:** `podman exec stopplidelsen.no php -l /var/www/custom/file.php`
|
|
**Cleanup:** `podman-compose down && podman-compose up -d` between test runs
|