zokirov/api-starter-kit

API starter kit for Symfony projects

1.8.0 2025-08-25 08:21 UTC

Requires

• php: >=8.2
• ext-ctype: *
• ext-iconv: *
• api-platform/doctrine-orm: ^4.1.21
• api-platform/symfony: ^4.1.21
• doctrine/dbal: ^3.10.1
• doctrine/doctrine-bundle: ^2.15.1
• doctrine/doctrine-migrations-bundle: ^3.4.2
• doctrine/orm: ^3.5.2
• lexik/jwt-authentication-bundle: ^3.1.1
• nelmio/cors-bundle: ^2.5
• phpdocumentor/reflection-docblock: ^5.6.3
• phpstan/phpdoc-parser: ^2.2
• symfony/asset: 7.2.*
• symfony/console: 7.2.*
• symfony/dotenv: 7.2.*
• symfony/expression-language: 7.2.*
• symfony/flex: ^2.8.2
• symfony/framework-bundle: 7.2.*
• symfony/property-access: 7.2.*
• symfony/property-info: 7.2.*
• symfony/runtime: 7.2.*
• symfony/security-bundle: 7.2.*
• symfony/serializer: 7.2.*
• symfony/twig-bundle: 7.2.*
• symfony/validator: 7.2.*
• symfony/yaml: 7.2.*

Requires (Dev)

• symfony/maker-bundle: ^1.64

Conflicts

• symfony/symfony: *

Replaces

• symfony/polyfill-ctype: *
• symfony/polyfill-iconv: *
• symfony/polyfill-php72: *
• symfony/polyfill-php73: *
• symfony/polyfill-php74: *
• symfony/polyfill-php80: *
• symfony/polyfill-php81: *
• symfony/polyfill-php82: *

GPL-3.0-or-later

README

[//]: <> ( todo udpate image and add new docker commands, tell about interfaces )

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

Kit has also already created a User entity with all crud routes

Kit has 3 docker containers: php, nginx and mysql

Installation

Download the project

composer create-project zokirov/api-starter-kit --ignore-platform-reqs --no-scripts

Go to the project directory

cd api-starter-kit

Run docker containers

docker compose up -d

Install composer scripts:

docker compose exec php composer install

To install project run command:

docker compose exec php bin/console ask:install

Done! You can open http://localhost:8508/api 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_PORTandDOCKER_DATABASE_PORT`

Database allows connections only from localhost. Because of this, when you use the project in production and want to connect to a 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 the 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

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

## JWT keys
To use the JSON Web Token system, you must create private and public keys. 
They have already created when you install a project. You can re-create them with:<br>  
```bin/console ask:generate:jwtKeys```