magebox-dev-environment

MageBox Dev Environment

MageBox runs Magento with native PHP-FPM + Nginx and Docker only for stateful services (MySQL, Redis, OpenSearch, Varnish, Mailpit). Drive it through the magebox CLI. Not for testing — magebox test … and PHPUnit/PHPStan/phpcs belong to the qoliber-magento-quality skills, not here.

Detect first

• A project is MageBox-managed if it has a .magebox.yaml at its root. If absent, this skill doesn't apply.
• Read .magebox.yaml and, if present, .magebox.local.yaml — the personal, gitignored override that merges over and wins for php, env, services, and shortcuts. Reason about the merged config, not just the committed file.
• Golden rule: never edit .magebox.yaml to apply a personal/local tweak. Put it in .magebox.local.yaml, or use magebox php … (which writes there for you).

Operate the project

• Status / health: magebox status, magebox check.
• Lifecycle: magebox start | stop | restart (add --all to act on every project).
• Custom commands: magebox run <name> runs an entry from the .magebox.yaml commands: block (e.g. magebox run setup). List them by reading that block.
• Shell & logs: magebox shell; magebox logs <nginx|php|mysql>.
• Database: magebox db shell | import <file> | export | snapshot create | snapshot restore <name>.

Onboard a project

• Team project: magebox clone <project> [--fetch]; then magebox fetch [--media] / magebox sync [--db|--media] to pull DB + media.
• Existing dir: magebox init. Brand-new store: magebox new <name> [-q] [--hyva].
• One-time host setup (rarely): magebox bootstrap.

Control PHP (per-project, isolated)

• Switch version: magebox php <ver> — writes .magebox.local.yaml; restart after.
• Isolation/settings: magebox php isolate, magebox php ini, magebox php opcache, magebox php system. Xdebug: magebox xdebug on|off (off = faster). Mode: magebox dev|prod.
• The php / composer wrappers auto-use the project's PHP version.

Full command matrix, config-merge example, and custom-command formats: references/commands.md.