Este projeto tem como objetivo fornecer alguns comandos adicionais à interface de linha de comando do Laravel para manipular a estrutura das camadas de Serviço e Reopositório: Service Layer / Repository Pattern.
Laravel é um framework de aplicação web com sintaxe expressiva e elegante. Uma estrutura da web fornece uma estrutura e um ponto de partida para a criação de seu aplicativo, permitindo que você se concentre na criação de algo incrível enquanto suamos nos detalhes. Documentação do Laravel
"Artisan é a interface de linha de comando incluída no Laravel. O Artisan existe na raiz do seu aplicativo como o artisanscript e fornece uma série de comandos úteis que podem ajudá-lo enquanto você constrói seu aplicativo." Documentação do Laravel
Para ver uma lista de todos os comandos Artisan disponíveis, você pode usar o listcomando:
php artisan list
Reposittory Pattern é um padrão de projeto que visa adicionar uma camada de abstração entre a camada dos modelos (Models) e os controladores (Controllers) ou ainda da camada de serviço (Services). Dessa forma, cada Model possui uma classe Repository correspondente. Ademais, numa abordagem padrão essas classes ficam na pasta app/Repositories/Eloquent e são injetadas por meio de Interfaces, que se encontram em app/Repositories/Contracts.
A Camada de Serviço ou Service Layer é um padrão de projeto que visa abstrair a lógica ou regra de nogócio da aplicação, que normalmente se encontra na camado dos controladores, para uma nova camada: a Camada de Serviço. Nesse contexto, em uma abordagem padrão cada controlador possui sua classe de serviço para quem delega as funções que normalmente deveria exercer. Dessa forma, os controladores se limitam a gerenciar o que entra por meio das rotas (requests) e o que será retornado a partir de então (responses). Assim, além de o projeto ficar mais estruturado é garantido também um desacoplamento da regra de negócio e o framework em uso, pois a regra de negócio estará em uma camada criada exclusivamente pelo desenvolvedor.
Para utilizar esse litle package desenvolvido por um pocket edition developer basta clonar esse repositório em app/Console/Commands da sua aplicação Laravel. Você pode fazer isso executando as seguintes linhas de comando a partir da raiz do seu projeto:
git clone https://github.com/12161003677/Service-Repository-Artisan-Commands.git ./app/Console/Commands
rm -r ./app/Console/Commands/.git
rm .\app\Console\Commands\README.md
Uma vez devidamente instalado você terá acesso à dois comandos php artisan make:service e php artisan make:repository sendo que ambos servirão para acriação de uma nova classe de serviço e uma nova classe de repositório respectivamente.
As classes geradas como o comando make:service serão criadas no diretório app/Services, esse diretório não existe por padrão, dessa forma ele será criado a primeira vez que for rodado o comando.
Segue os detalhes do comando:
Descrição: Cria uma nova classe de serviço
Formato: make:service [options] [--]
Argumentos:
name O nome da Classe
Options:
-r, --resource Gera uma classe de serviço com métodos padrões.
-R, --repository[=Repository] Gera uma classe de serviço injetando uma classe de repositório.
As classes geradas como o comando make:repository serão criadas no diretório app/Repositories/Eloquent, esse diretório não existe por padrão, dessa forma ele será criado a primeira vez que for rodado o comando. Ainda assim, um outro diretório será criado app/Repositories/Contracts, esse diretório conterá as classes de interface das classes de repositório, pois estas nunca são injetadas diretamente.
Ademais, a primeira vez o o comando make:repository for rodado será feito um processo de scafolding onde, além de serem criados os diretórios supracitados, serão criadas as classes AbstractRepository (contendo todos os métodos padrões de uma classe de repositório a qual será estendida por todas as outras classes de repositório), a sua interface AbstractRepositoryInterface e finalmente a classe RepositoryServiceProvider, essa última será a classe responsável por informar à aplicação a relação entre as classes de repositório e suas interfaces, sendo que é por conta disso que será possível utilizar as classes por meio das suas interfaces.
Assim, toda vez que for criada uma nova classe de repositório será também criada a sua interfece e a relação entre as duas será provida à aplicação por meio da RepositoryServiceProvider, sendo que isto é feito varrendo o diretório app/Repositories/Eloquent e reescrevendo o arquivo com as classes presentes nesse diretório. Ademais, é importante frizar que a classe RepositoryServiceProvider é automaticamente inserida em config/app.php mas pode ser que isso não aconteça então é importante validar se ela se encontra no array de providers.
Segue os detalhes do comando:
Descrição: Cria uma nova classe repositório
Formato: make:repository [options] [--]
Argumentos:
name O nome da Classe
Options:
-m, --model[=Model] Gera uma classe de repositório para uma Model fornecida.
-p, --path[=Path] Gera uma classe de repositório em um diretório fornecido a partir de app/Repositories.