kadirov/api-starter-kit

v2.0.1 2025-06-07 14:36 UTC

Requires

• php: >=8.2
• ext-ctype: *
• ext-iconv: *
• api-platform/doctrine-orm: 4.1.*
• api-platform/symfony: 4.1.*
• doctrine/dbal: 3.9.*
• doctrine/doctrine-bundle: 2.14.*
• doctrine/doctrine-migrations-bundle: 3.4.*
• doctrine/orm: 3.3.*
• lexik/jwt-authentication-bundle: 3.1.*
• nelmio/cors-bundle: 2.5.*
• phpdocumentor/reflection-docblock: 5.6.*
• phpstan/phpdoc-parser: 2.1.*
• symfony/asset: 7.3.*
• symfony/console: 7.3.*
• symfony/dotenv: 7.3.*
• symfony/expression-language: 7.3.*
• symfony/flex: 2.7.*
• symfony/framework-bundle: 7.3.*
• symfony/property-access: 7.3.*
• symfony/property-info: 7.3.*
• symfony/runtime: 7.3.*
• symfony/security-bundle: 7.3.*
• symfony/serializer: 7.3.*
• symfony/twig-bundle: 7.3.*
• symfony/validator: 7.3.*
• symfony/yaml: 7.3.*

Requires (Dev)

• symfony/maker-bundle: ^1.63

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

Starter kit for API with Symfony Skeleton, Doctrine, Maker Bundle, Migrations Bundle, Api-Platform and Lexik 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 kadirov/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:8507/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_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