cryental/volistx-skeleton

Volistx Framework For RESTful API Based on Laravel/Lumen

13.1.1 2024-05-06 10:03 UTC

Requires

• php: ^8.3
• ext-curl: *
• ext-json: *
• ext-pdo: *
• ext-zip: *
• guzzlehttp/guzzle: ^7.2
• interaction-design-foundation/laravel-geoip: ^3.3
• laravel/framework: ^11.0
• laravel/octane: ^2.3
• laravel/prompts: ^0.1.18
• laravel/tinker: ^2.9
• spatie/laravel-ignition: ^2.4
• volistx/framework-kernel: ^8.0

Requires (Dev)

• fakerphp/faker: ^1.23
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.0
• phpunit/phpunit: ^10.5
• spatie/ray: ^1.41

MIT

• Cryental
• Mostafa Samy

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