Nos primeiros artigos desta série trabalhamos massivamente para aprender e desenvolver o máximo que pudéssemos no tratamento dos dados do banco de dados. Fomos desde a criação da estrutura do banco com as migrations até a criação de respostas RESTful através dos resources. Agora chegou a hora de desenvolvermos a lógica da aplicação com o Laravel Controller.
Se você já conhece sobre o MVC, fica claro que o Controller não se trata de uma exclusividade do Laravel. Mas, como todo framework, o Laravel Controller tem sua forma de trabalhar.
Em sua documentação, podemos ver que a função dos Controllers é organizar e agrupar requests relacionadas, manipulando sua lógica em uma única classe. O que eles querem dizer é que tiraremos toda a complexidade de código que inicialmente estaria na closure das rotas.
Tópicos
1 -Criando o seu primeiro Laravel Controller
Para iniciar o trabalho primeiramente você terá que criar o Controller que irá trabalhar. Voltando ao nosso exemplo prático, vou montar o Controller para criar os endpoints dos nossos produtos. Para isto utilizarei o php artisan.
[code] php artisan make:controller ProductsController [/code]
Este comando é o mais indicado pois você terá a estrutura e as dependências todas montadas pelo próprio Laravel. Isto pode evitar muita dor de cabeça. Bem, se tudo der certo você terá o seguinte arquivo dentro da sua pasta Http/Controllers.
[php] <?php namespace App\Http\Controllers; use Illuminate\Http\Request; class ProductsController extends Controller { // } [/php]
O Laravel Controller sempre extende a classe Controller padrão do Laravel. Assim, você já terá convenientemente métodos comuns como por exemplo o Middleware.
2 – Criando os métodos do Controller
Para todo CRUD básico nós teremos 7 funções que resolverão em 7 rotas diferentes. Criarei elas aqui dentro do padrão do Laravel com os nomes:
- index – Lista os dados da tabela
- show – Mostra um item específco
- create – Retorna a View para criar um item da tabela
- store – Salva o novo item na tabela
- edit – Retorna a View para edição do dado
- update – Salva a atualização do dado
- destroy – Remove o dado
Dependendo do seu projeto, você consegue economizar aqui a tela do create e do edit. No mais, o CRUD vai exigir pelo menos as 5 rotas de interação com a Model.
No nosso caso serão 6 pois colocamos a adição de produtos junto com a listagem. Assim, nosso Laravel Controller ficará como abaixo:
[php]
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Product;
use App\Product_line;
class ProductsController extends Controller
{
public function index(){
return view(‘products’);
}
public function show(Product $product){
return view(‘the_product’);
}
public function store(){
//
}
public function edit(Product $product){
return view(‘product_edit’);
}
public function update(Product $product, Request $request){
//
}
public function destroy(Product $product){
//
}
}
[/php]
Uma observação especial para os métodos show(), edit(), update() e delete(). Nestas funções você pode ver que temos parâmetros vinculados para repassarmos paras as views ou para salvar no banco de dados. O $product irá injetar a instância de Product com o dado que será passado na rota (GET) ou POST.
Para entender melhor vamos seguir e registrar as rotas para este controller.
3 – Registrando as rotas
Agora que as funções estão estruturadas é hora de montar os endpoints. Para isto utilizaremos o arquivo web.php que está na pasta routes. Este arquivo é responsável por rotear o caminho da request para a função correta no controller e retornar o resultado.
Abaixo segue o nosso exemplo.
[php]
Route::get(‘products’,’ProductsController@index’);
Route::post(‘products’,’ProductsController@store’);
Route::get(‘products/{product}’,’ProductsController@show’);
Route::get(‘products/{product}/edit’,’ProductsController@edit’);
Route::patch(‘products/{product}’,’ProductsController@update’);
Route::delete(‘products/{product}’,’ProductsController@destroy’);
[/php]
Aqui utilizamos 4 métodos de request para executar cada ação. GET e POST que são os mais comuns, e PATCH e DELETE que são respectivamente para atualização e remoção de dados.
Você também reparará que nas quatro últimas rotas temos a palavra { product }. Lembra-se da injeção automática da instância Product? Então… a instância de Product será o model referente ao id do produto que você passar nesta rota.
Isso é para o caso de você querer deletar o produto de id 1, basta passar pela URI ‘products/1’, com o método delete, e implementar a deleção no Laravel Controller.
[php]
public function destroy(Product $product){
$product->delete();
return redirect(‘products’);
}
[/php]
Veja acima como ficou simples deletar um produto.
A instância já possui todas as referências do model do produto 1. Assim, é só executar o comando delete do Eloquent que ele faz o resto sozinho.
4 – Implementando os métodos de CRUD no Laravel Controller
Começaremos pelos métodos de Visualização, pois eles são simples métodos que vão receber os dados dos models e repassar para as suas respectivas Views.
[php]
public function index() {
$products = Product::all();
return view(‘products’,compact(‘products’,’product_lines’));
}
public function show(Product $product){
return view(‘the_product’,compact(‘product’));
}
public function edit(Product $product){
$product_lines = Product_line::all();
return view(‘product_edit’,compact(‘product’,’product_lines’));
}
[/php]
Vejam que em edit fizemos também uma busca dentro da model Product_lines. Isto porque eu precisaremos de todas as linhas de produto caso eu queira mudar este produto de linha.
Por fim, vamos aos métodos de escrita, store e update
5 – Salvando dados no Banco de dados
[php]
public function store(){
$data = [
‘product_line_id’ => request(‘product_line_id’),
‘description’ => request(‘description’),
‘expiration_time’ => request(‘expiration_time’),
‘price’ => request(‘price’)
];
Product::create($data);
return redirect(‘product’);
}
public function update(Product $product, Request $request){
$product->product_line_id = $request->product_line_id;
$product->description = $request->description;
$product->expiration_time = $request->expiration_time;
$product->price = $request->price;
$product->save();
return redirect(‘product’);
}
[/php]
Se você leu esta série desde o começo, verá que esta parte já havia sido feita, em parte, no artigo Simplificando models no Laravel.
Na função store() fizemos o mass assignment e na função update setamos cada dado enviado pela Request na instância do model Product e então utilizamos o save() para efetivar a mudança no banco de dados.
Então código final ficou assim:
[php]
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Product;
use App\Product_line;
class ProductsController extends Controller
{
public function index(){
$products = Product::all();
return view(‘products’,compact(‘products’));
}
public function show(Product $product){
return view(‘the_product’,compact(‘product’));
}
public function store(){
$data = [
‘product_line_id’ => request(‘product_line_id’),
‘description’ => request(‘description’),
‘expiration_time’ => request(‘expiration_time’),
‘price’ => request(‘price’)
];
Product::create($data);
return back();
}
public function edit(Product $product){
$product_lines = Product_line::all();
return view(‘product_edit’,compact(‘product’,’product_lines’));
}
public function update(Product $product, Request $request){
$product->product_line_id = $request->product_line_id;
$product->description = $request->description;
$product->expiration_time = $request->expiration_time;
$product->price = $request->price;
$product->save();
return redirect(‘products’);
}
public function delete(Product $product){
$product->delete();
return redirect(‘products’);
}
}
[/php]
Conclusão
O Laravel Controller é onde manipulamos a lógica de tratamento das requisições recebendo os dados do model e transmitindo-os para a view. É ele que abstrairá toda a complexidade da rota que, como já diz o nome, apenas roteará a Request feita para sua devida lógica.
Este é apenas um artigo inicial sobre Laravel controller nele ainda podemos implementar validações de dados e middlewares que garantirão segurança e estabilidade ao projeto.
