- PHP 8.1
- MySQL/MariaDB
- Laravel 10
-
Copy
.env.sailto.env -
Check
APP_PORTto make sure it does not conflict with some local webserver instance on same port (80) -
Check
FORWARD_DB_PORTto make sure it does not conflict with some local MySQL instance on same port (3306) -
Check
PUNK_API_ENDPOINTin case it's now different from default (https://api.punkapi.com/v2) -
Install Laravel Sail with the following command (no need to have PHP 8.1 installed locally):
docker run --rm \ -u "$(id -u):$(id -g)" \ -v "$(pwd):/var/www/html" \ -w /var/www/html \ laravelsail/php81-composer:latest \ composer install --ignore-platform-reqs -
Bring containers up with:
./vendor/bin/sail up -d
-
Generate JWT secret with:
./vendor/bin/sail artisan jwt:secret
-
Run database migrations and seeds with:
./vendor/bin/sail artisan migrate:fresh --seed
- Run static analysis with:
./vendor/bin/sail php ./vendor/bin/phpstan analyze
- Run code linting with:
./vendor/bin/sail php ./vendor/bin/duster lint
- Fix lint errors with:
./vendor/bin/sail php ./vendor/bin/duster fix
-
Login with
rootas a username andpasswordas a password with (addAPP_PORTto base URL if different from 80):curl --location 'http://localhost/api/auth/login' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "username": "root", "password": "password" }'
-
Get
access_tokenfrom response, e.g.:{ "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vMTI3LjAuMC4xOjgwOC9hcGkvYXV0aC9sb2dpbiIsImlhdCI6MTY5NzY0NTYyNywiZXhwIjoxNjk3NjQ5MjI3LCJuYmYiOjE2OTc2NDU2MjcsImp0aSI6Im5pd1FWWHowSEIxc0Y2ZWwiLCJzdWIiOiIxIiwicHJ2IjoiMjNiZDVjODk0OWY2MDBhZGIzOWU3MDFjNDAwODcyZGI3YTU5NzZmNyJ9.O4AbOZwRrpwoMTBV82yeK-hEE3XPyZQLzqUgBBcYVRg", "token_type": "bearer", "expires_in": 3600 } -
After use is authenticated, fetch available beers from Punk API using JWT token from login response with (
pagedefaults to 1 andperPagedefaults to 20 if not specified):curl --location 'http://localhost/api/beers?page=1&perPage=5' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vMTI3LjAuMC4xOjgwOC9hcGkvYXV0aC9sb2dpbiIsImlhdCI6MTY5NzY0NTYyNywiZXhwIjoxNjk3NjQ5MjI3LCJuYmYiOjE2OTc2NDU2MjcsImp0aSI6Im5pd1FWWHowSEIxc0Y2ZWwiLCJzdWIiOiIxIiwicHJ2IjoiMjNiZDVjODk0OWY2MDBhZGIzOWU3MDFjNDAwODcyZGI3YTU5NzZmNyJ9.O4AbOZwRrpwoMTBV82yeK-hEE3XPyZQLzqUgBBcYVRg'
-
Logout user using JWT token from login response with:
curl --location --request POST 'http://localhost/api/auth/logout' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vMTI3LjAuMC4xOjgwOC9hcGkvYXV0aC9sb2dpbiIsImlhdCI6MTY5NzY0NTYyNywiZXhwIjoxNjk3NjQ5MjI3LCJuYmYiOjE2OTc2NDU2MjcsImp0aSI6Im5pd1FWWHowSEIxc0Y2ZWwiLCJzdWIiOiIxIiwicHJ2IjoiMjNiZDVjODk0OWY2MDBhZGIzOWU3MDFjNDAwODcyZGI3YTU5NzZmNyJ9.O4AbOZwRrpwoMTBV82yeK-hEE3XPyZQLzqUgBBcYVRg'
-
Refresh JWT token using current token from login response with:
curl --location --request POST 'http://localhost/api/auth/refresh' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOi8vMTI3LjAuMC4xOjgwOC9hcGkvYXV0aC9sb2dpbiIsImlhdCI6MTY5NzY0NTYyNywiZXhwIjoxNjk3NjQ5MjI3LCJuYmYiOjE2OTc2NDU2MjcsImp0aSI6Im5pd1FWWHowSEIxc0Y2ZWwiLCJzdWIiOiIxIiwicHJ2IjoiMjNiZDVjODk0OWY2MDBhZGIzOWU3MDFjNDAwODcyZGI3YTU5NzZmNyJ9.O4AbOZwRrpwoMTBV82yeK-hEE3XPyZQLzqUgBBcYVRg'
- Run tests and show code coverage with:
./vendor/bin/sail artisan test --coverage< 537D /div>