Download the PHP package ftm-pm/symfony-api without Composer

SymfonyApi

The SymfonyApi is configured bundles for creating a REST API.

Russian documentation here.

Setup

The SymfonyApi is a symfony/skeleton application with bundles:

• api-platform
• gedmo
• jwt-authentication-bundle.
• All bundles

Installation

Run the Composer command to create a new project

Configuration

After installing, you need to set environment variables. You can see variables in the .env file.

Next step, run command to update database.

In SymfonyApi, authorization was developed using JWT. You can see documentation here.

For create a new user, you can use any REST client. You should send a new request to http://my-project/api/register with parameters:

or using curl

After the confirmation email, get token. Send a new request to http://my-project/api/token:

or using curl

The SymfonyApi returns two fields:

For authorization, you must send header for any request: Authorization: Bearer your_token.

Use

REST API on SymfonyApi developed with use api-platform bundle. You can see full documentation here.

For example:

• The Serialization Process
• The Event System
• Data Providers
• Security
• and other

Features SymfonyApi

SymfonyApi included:

• Authentication (login, register, getToken, refreshToken)
• Localization logic
• Integrated with media-server project

Authentication

For the organization of users on the application is not used FOSUserBundle. The necessary part related to the user has been ported, and all parts related to events, personal accounts, and other unnecessary information have been skipped.

If you want to use FOSUserBundle, you can delete all files associated with the user and include FOSUserBundle and configure security.yaml.

JWT is used for authentication. You can see documentation here.

Localization

Gedmo Translatable realizes localization on SymfonyApi. In order to the api-platform to return translations, the entity class must implement the Gedmo\Translatable\Translatable Interface.

The translation field will look like:

Similarly, to save translations, you must add the translations parameter to the query.

It should be noted that the Gedmo Translatable does not duplicate translations. If the application is set to English as the main language, the field translations English will not. For example:

This can be fixed by duplicate data into the App\Handler\Translation.

What's included

• api-platform/core
• doctrine/annotations
• gedmo/doctrine-extensions
• gesdinet/jwt-refresh-token-bundle
• gfreeau/get-jwt-bundle
• guzzlehttp/guzzle
• lexik/jwt-authentication-bundle
• nelmio/cors-bundle
• symfony/asset
• symfony/console
• symfony/expression-language
• symfony/flex
• symfony/framework-bundle
• symfony/lts
• symfony/maker-bundle,
• symfony/orm-pack
• symfony/swiftmailer-bundle
• symfony/twig-bundle
• symfony/validator
• symfony/yaml

Feedback

• Create a new issue
• Ask a question on сайте.
• Send a message to [email protected]

License MIT.