Laravel Controller . Desenvolvendo a lógica da sua aplicação

Nos primeiros artigos desta série trabalhei massivamente para aprender e desenvolver o máximo que pude no tratamento dos dados do banco de dados. Fui 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 desenvolver a lógica da aplicação com o Laravel Controller.

Partindo do ponto que 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.

Criando seu primeiro Laravel Controller

Para iniciar o trabalho primeiramente temos que criar o Controller que iremos trabalhar. Voltando ao nosso exemplo prático, vou montar o Controller para criar os endpoints dos nossos produtos. Para isto utilizarei o php artisan.

 php artisan make:controller ProductsController

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
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class ProductsController extends Controller
{
//
}

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.

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 meu caso serão 6 pois coloquei a adição de produtos junto com a listagem. Assim, nosso Laravel controller ficará como abaixo:

</p>
<p><?php</p>
<p>namespace App\Http\Controllers;</p>
<p>use Illuminate\Http\Request;<br />
use App\Product;<br />
use App\Product_line;</p>
<p>class ProductsController extends Controller<br />
{<br />
public function index(){<br />
return view('products');<br />
}</p>
<p>public function show(Product $product){<br />
return view('the_product');<br />
}</p>
<p>public function store(){<br />
//<br />
}</p>
<p>public function edit(Product $product){<br />
return view('product_edit');<br />
}</p>
<p>public function update(Product $product, Request $request){<br />
//<br />
}</p>
<p>public function destroy(Product $product){<br />
//<br />
}<br />
}<br />

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 registar as rotas para este controller.

Registrando as rotas

Agora que as funções estão estruturadas é hora de montar os endpoints. Para isto utilizarei 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 meu exemplo.

<br />
Route::get('products','ProductsController@index');<br />
Route::post('products','ProductsController@store');<br />
Route::get('products/{product}','ProductsController@show');<br />
Route::get('products/{product}/edit','ProductsController@edit');<br />
Route::patch('products/{product}','ProductsController@update');<br />
Route::delete('products/{product}','ProductsController@destroy');<br />

Aqui utilizei 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 vai 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. Assim, se você quiser 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.

<br />
public function destroy(Product $product){<br />
$product->delete();<br />
return redirect('products');<br />
}<br />

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.

Implementando os métodos de CRUD no Laravel Controller

Já que configuramos as rotas para cada método do controller e além disso implementamos o método DELETE vamos aos próximos métodos. Começarei 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.

<br />
public function index() {<br />
$products = Product::all();<br />
return view('products',compact('products','product_lines'));<br />
}</p>
<p>public function show(Product $product){<br />
return view('the_product',compact('product'));<br />
}</p>
<p>public function edit(Product $product){</p>
<p>$product_lines = Product_line::all();</p>
<p>return view('product_edit',compact('product','product_lines'));</p>
<p>}<br />

Vejam que em edit eu fiz também uma busca dentro da model Product_lines. Isto porque eu vou precisar 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

Salvando dados no Banco de dados

<br />
public function store(){<br />
$data = [<br />
'product_line_id' => request('product_line_id'),<br />
'description' => request('description'),<br />
'expiration_time' => request('expiration_time'),<br />
'price' => request('price')<br />
];<br />
Product::create($data);<br />
return redirect('product');<br />
}</p>
<p>public function update(Product $product, Request $request){<br />
$product->product_line_id = $request->product_line_id;<br />
$product->description = $request->description;<br />
$product->expiration_time = $request->expiration_time;<br />
$product->price = $request->price;<br />
$product->save();</p>
<p>return redirect('product');<br />
}</p>
<p>

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() eu fiz o mass assignment e na função update setei cada dado enviado pela Request na instância do model Product e então utilizei o save() para efetivar a mudança no banco de dados.

O código final ficou assim:

</p>
<p><?php</p>
<p>namespace App\Http\Controllers;</p>
<p>use Illuminate\Http\Request;<br />
use App\Product;<br />
use App\Product_line;</p>
<p>class ProductsController extends Controller<br />
{<br />
public function index(){<br />
$products = Product::all();<br />
return view('products',compact('products'));<br />
}</p>
<p>public function show(Product $product){<br />
return view('the_product',compact('product'));<br />
}</p>
<p>public function store(){<br />
$data = [<br />
'product_line_id' => request('product_line_id'),<br />
'description' => request('description'),<br />
'expiration_time' => request('expiration_time'),<br />
'price' => request('price')<br />
];</p>
<p>Product::create($data);</p>
<p>return back();<br />
}</p>
<p>public function edit(Product $product){<br />
$product_lines = Product_line::all();<br />
return view('product_edit',compact('product','product_lines'));<br />
}</p>
<p>public function update(Product $product, Request $request){</p>
<p>$product->product_line_id = $request->product_line_id;<br />
$product->description = $request->description;<br />
$product->expiration_time = $request->expiration_time;<br />
$product->price = $request->price;<br />
$product->save();</p>
<p>return redirect('products');<br />
}</p>
<p>public function delete(Product $product){<br />
$product->delete();<br />
return redirect('products');<br />
}<br />
}</p>
<p>

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. O Laravel Controller 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 para sobre Laravel controller nele ainda podemos implementar validações de dados e middlewares que garantirão segurança e estabilidade ao projeto.

Compartilhe