abduqayum/laravel-starter-kit

A CMS like modular Laravel starter project.

1.0.0 2024-11-01 12:31 UTC

Requires

• php: ^8.2
• laravel/framework: ^11.9
• laravel/tinker: ^2.9

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pail: ^1.1
• laravel/pint: ^1.13
• laravel/sail: ^1.26
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.1
• phpunit/phpunit: ^11.0.1

MIT

• framework
• laravel

README

Starter kit for API with Laravel, Doctrine, Maker Bundle, Migrations Bundle, Api-Platform and JWT-auth.

Kit has also already created User entity with all crud routes

Kit has 3 docker containers: php, nginx and mysql

Installation

Download the project
composer create-project abduqayum/laravel-starter-kit:dev-master

Go to the project directory
cd laravel-starter-kit

Run docker containers
docker compose up -d

Install composer scripts:
docker compose exec php composer install

Give permission to bootstrap cache and storage
docker compose exec php php artisan project:install

To install project run command:
docker compose exec php php artisan key:generate

Run the migration
php artisan migrate

Done! You can open http://localhost:8052 via browser. By the way, you can change this port by changing DOCKER_NGINX_PORT variable in .env file.

Docker

For enter to php container run docker compose exec php bash

For enter to mysql container run docker compose exec mysql bash

For enter to nginx container run docker compose exec nginx bash

You can change containers prefix by changing DOCKER_PROJECT_NAME variable in .env file.

Also, you can change public ports of nginx and mysql by changing DOCKER_NGINX_PORT and DOCKER_DATABASE_PORT

Database allows connections only from localhost. Because of this when you use the project on production and want to connect to database from your computer you should connect via ssh bridge.

Cron

You can use docker/php/cron-file for cron jobs. After you must re-build php container by running command:
docker compose up -d --build

Swagger

You can change project name and description on swagger by editing file config/packages/api_platform.yaml

Git Hook

If you don't use any deploying system you can do
cp docker/other-files/git/hooks/post-merge .git/hooks

In this way git always executes command bin/console ask:deploy. You can change this command in the file src/Command/AskDeployCommand.php. This command will install requirements via composer, clear caches, change owner of ./var and ./public/media folders to www-data, will run migrations.

JWT keys

For use Json Web Token system you must create private and public keys. They are have already created when you install project. You can re-create them with:

bin/console ask:generate:jwtKeys