README

Volistx Framework For RESTful API Based on Laravel 11.x

This is a framework skeleton for Volistx API platform using Laravel PHP Framework.

Let's make some awesome thing together!

Requirements

• PHP 8.2 or Above
• All Required Extensions for Laravel 11.x
• Redis PHP Extension
• Swoole or OpenSwoole Extension
• MariaDB 11.1 or Above
• Flare Subscription for Error Monitoring (Optional) (https://flareapp.io/)

Installation

composer create-project --prefer-dist volistx/framework myproject

Usage

• Copy .env.example to .env.

• Get GeoPoint API key and put it to .env file. (Optional, only if you want to use country filter)

• Put Flare key to .env file. (Optional, only if you want to use Flare).

• Run following commands:

composer install
php artisan key:generate
php artisan migrate

Do not forget to set a cronjob for production (This is not required if you're using Swoole):

* * * * * php /path/to/artisan schedule:run

Generate an admin access key using this command:

php artisan access-key:generate

Swoole Setup

It uses Laravel Octane. You can use Swoole or OpenSwoole. You can find the installation guide here: https://laravel.com/docs/11.x/octane

Run Swoole using this command:

php artisan octane:start

If you want the Swoole server to run after reboot, add the following line to your crontab:

@reboot php artisan octane:start

For Supervisor, check following configuration:

[program:volistx-octane-worker]
directory=/path/to/
command=php artisan octane:start
numprocs=1
autostart=true
autorestart=true
startretries=3
user=www-data
redirect_stderr=true
stdout_logfile=/var/log/supervisor/%(program_name)s.log