symfony-skeleton's Introduction

Project skeleton

What's included

This is our day-to-day backend dev stack

Pre-configured PHP 7.2 FPM and CLI
Pre-configured Nginx 1.11
PostgreSQL 9.6
Symfony 4.1
Doctrine ORM 2.5
Codeception as testing frameworks

Required software

Docker 1.9+
Docker-compose 1.6+
Docker-machine 0.6+

Docker

All environment isolated from host system via Docker containers.

For understanding of how Docker works please read this articles:

Shortcuts

To simplify your life, you can use shortcuts available in docker/shortcuts shell script. To make it even more easy to use, just add path to this directory in your PATH env variable (in .bashrc or .bash_profile):

export PATH=./docker/shortcuts:$PATH

By doing this, you will be able to use short versions of commands:

apidoc                      # run command to generate api doc from raml file
php                         # run command in php container
console                     # symfony console running via docker container
psql                        # connects psql to your database using containers
composer                    # shortcut for running composer (with php7 in separate docker container)
php_stan                    # shortcut for running PHPstan (Static Analysis Tool)
run_tests                   # shortcut for running tests

Development

To start dev environment, just run docker-compose up and you are ready to go.

API Documentation

In order to modify the documentation, you need to make changes to the app/resources/docs/api.raml file and regenerate the documentation using apidoc bash script.

You can see the documentation for api by ${TARGET_HOST}/api.html.

Testing

To run test suites you can use docker/shortcuts/run_tests script

Usage: test [suite] [option]

Examples:

run_tests - starts all tests suites
run_tests unit - starts unit test suite
run_tests api - starts api test suite
run_tests u - you may run suite for part of tests

XDebug

This projects template also includes xdebug extensions for remote debugging. To debug your application in PhpStorm you should configure remote server and set path mapping to /app directory.

In production environment xdebug is disabled.

symfony-skeleton's People

Contributors

Stargazers

Watchers

symfony-skeleton's Issues

Needs to add infrastructure for testing

Предложение по понижению связанности

Как я вижу используется src/Core/Http/BaseAction.php суто для того что бы flush делать. Можно сделать отдельный класс Flush

<?php

namespace App\Core\Http;


use Doctrine\ORM\EntityManagerInterface;

class Flush
{
    /**
     * @var EntityManagerInterface
     */
    private $em;

    public function __construct(EntityManagerInterface $em)
    {
        $this->em = $em;
    }

    public function __invoke():void
    {
        $this->em->flush();
    }

}

И инджектить его в action. Таким образом избавится от обязательного наследования.

Например

public function __invoke(CreateRequest $request, Service $service, Flush $flush)
    {
       $service->someCreate($request);
       $flush();
    }

Remove fesor/request-objects dependency

You can remove fesor/request-objects dependency by implementing own dto resolver as here https://kvashnin.github.io/blog/using-request-dto-in-symfony/

Needs to add maker-bundle with templates

Templates:

Action
Model
Value object
Request object

Recommend Projects

kruglikdenis / symfony-skeleton Goto Github PK