Deployment

In general, you can deploy Maravel the same way Maravelith is deployed. We will cover a few differences here, but you should refer to the full Maravelith documentation for additional details.

CRITICAL ARCHITECTURAL WARNING

Because Maravel’s high-performance router utilizes native strtok() loops to parse URI nodes with zero memory allocations, this framework is strictly designed for a stateless, isolated PHP-FPM execution architecture.

Do NOT run Maravel with long-running, multithreaded, or coroutine-based application servers (such as Laravel Octane, Swoole, OpenSwoole, or RoadRunner).

Because strtok() relies on a single global internal pointer within the PHP thread state, concurrent asynchronous requests sharing the same process worker will overwrite each other’s routing tokens mid-flight. This will result in critical security vulnerabilities, including routing desynchronization, cross-user data leaks, and authentication middleware bypasses.