Maravel Micro-Framework

If you like Lumen and you don’t want to refactor your project using other micro-frameworks, now you can.

Maravel Micro-Framework is an improvement from Lumen 10, actively maintained.

All you have to do to switch to Maravel is to compare the Maravel template with your project by using a folder comparison tool like Meld.

Start by runing:

composer create-project macropay-solutions/maravel

Then compare this new maravel folder with your project’s folder and add to your project the new files like app/Application, app/Router, app/Request, ConfigCacheCommand, RouteCacheCommant etc. and the changes to the common files like bootstrap/app.php etc. Don’t forget to compare the composer.json so that macropay-solutions/maravel-framework is required.

Then add to your deploy the following commands:

php artisan config:cache
php artisan route:cache

Note: Do not use env helper outside the config files if you cache the config!

The event:cache command is available only in Maravelith but you can read more about how to use observers in Maravel from this article.

You can read more about the new features and improvements that are not present in Lumen in my articles (example https://marius-ciclistu.medium.com/maravel-frameworks-got-new-speed-and-control-improvements-10-57-0-5430afaee690) and in the github wiki section of Maravel and Maravel-Framework.

See if you notice any speed improvements.

Any feedback is welcome.

UPDATE 2026.01.14
Do not forget to add to your queue:work command:

--fail-on-fatal --memory=256

The default memory is 128 MB and maravel-framework will impose that limit on the worker process. That is why if your php.ini has a different value than 128, you must add it to the work command.