alissonphp / lumen-api-skeleton by alissonphp

Lumen API skeleton with JWT to manager tokens, Socialite to OAuth Providers, MongoDB driver and Predis to Redis cache storage.

mongodb api oauth jwt socialite lumen

Github Link

Packagist Link

Package Data
Maintainer Username:	alissonphp
Package Create Date:	2017-08-10
Package Last Update:	2017-11-21
Home Page:	https://alissonphp.me
Language:	PHP
License:	MIT
Last Refreshed:	2024-12-15 15:13:27

Package Statistics
Total Downloads:	8
Monthly Downloads:	0
Daily Downloads:	0
Total Stars:	21
Total Watchers:	2
Total Forks:	5
Total Open Issues:	0

Rest API Lumen Skeleton

Basic structure for creating REST APIs using Lumen Framework and extra packages

System requirements

PHP >= 5.6.4
OpenSSL PHP Extension
PDO PHP Extension
Mbstring PHP Extension
Mongo DB drive
PHPUnit
Redis Drive

Installation

$ git clone https://github.com/alissonphp/lumen-api-skeleton
$ cd lumen-api-skeleton/

IMPORTANT: configure .env (copy .env.example) at the root of the application with the development variables: connections with MySQL and MongoDB, APP Ids of the authentication services (google, facebook).

$ composer install
$ php artisan jwt:secret
$ php artisan migrate
$ php artisan db:seed
$ php -S localhost:8000 -t public

Development server running in: http://localhost:8000

Packages Used

Lumen Micro Framework [https://lumen.laravel.com/docs/5.4/]
Socialite [https://github.com/laravel/socialite]
JWT Auth [https://github.com/tymondesigns/jwt-auth/]
Laravel MongoDB [https://github.com/jenssegers/laravel-mongodb]
Predis [https://github.com/nrk/predis]

Modularization

The application is architected in Modules. Each module has defined responsibility and Layers. The standard model of a module follows the following structure:

app
└───Modules
│   │   Controllers
│   │   Events
│   │   Listeners
│   │   Middlewares
│   │   Models
│   │   Supports
│   │   Tests
│   │   routes.php

To enable / disable the functionality of a module simply inform the Namespace in the array of the config / modules.php file Important to verify interoperability between modules before deactivating it.

Routes

Routes are defined in the routes.php files within the root directory of each module. The RouteServiceProvider is responsible for loading the routes of each module defined in config / modules.php. No need to instantiate new calls.

Endpoints composition

Model : localhost:8000 + api version + module namespace + action + parameters, for example: http://localhost:8000/v1/oauth/login/google or http://localhost:8000/v1/oauth/login/google/callback

Tests

There are two types of tests: Integration and Unit. The default directory where the cases should be is /Tests within the module under development. For integration tests use the "test + type + Test" naming standard, for example: LoginIntegrationTest (test: Login, type: Integration).

Run the tests using the command referencing the testsuite as 'unit' or 'integration':

$ phpunit --testsuite integration
$ phpunit --testsuite unit

Contributions

The purpose of this repository is to create a fast model for implementing REST APIs using the Lumen Framework. We still have enough to get close to an "ideal" model: rules for accessing endpoints, improving standards, writing tests, translations, etc.