runtime.yml.example

# runtime.yml.example
# phpvm — per-project PHP runtime manifest
# Docs: https://github.com/yourname/phpvm/blob/main/docs/specs/MANIFEST_SPEC.md
#
# Copy this file to your project root as runtime.yml and customize.
# Commit runtime.yml to Git — it is the reproducibility contract for your project.

phpvm: "1"

# ── Runtime versions ──────────────────────────────────────────────────────────

runtime:
  php: "8.3"           # required — minor (8.3) or exact (8.3.14)
  # node: "20"         # optional — inject Node.js into environment
  # composer: "2"      # optional — Composer version (default: bundled with PHP)

# ── Database ──────────────────────────────────────────────────────────────────

database:
  engine: mysql        # mysql | mariadb | sqlite | none
  version: "8"         # required for mysql/mariadb

# ── PHP Extensions ────────────────────────────────────────────────────────────

extensions:
  - redis
  - imagick
  - intl
  # Core extensions (curl, mbstring, openssl, pdo, pdo_mysql) are always enabled.
  # Add only the extras your project needs.

# ── Web Server ────────────────────────────────────────────────────────────────

server:
  engine: nginx        # nginx | apache | none
  # port: 8080         # optional — auto-allocated if omitted
  root: public         # document root relative to project (default: public)

# ── Environment Variables ─────────────────────────────────────────────────────

environment:
  APP_ENV: local
  APP_DEBUG: "true"
  DB_HOST: 127.0.0.1
  # DB_PORT is set automatically from the allocated MySQL port

# ── Project Identity ──────────────────────────────────────────────────────────

project:
  name: my-app
  domain: myapp.local  # phpvm adds this to your hosts file