Primeiros Passos com Laravel

Fique por dentro

O Laravel � um framework de desenvolvimento com uma curva de aprendizado baixa, pois tem como objetivo facilitar as etapas de criaç�o e publicaç�o de uma aplicaç�o PHP. Para isso as tarefas mais comuns no desenvolvimento de uma aplicaç�o, que v�o desde consultas ao banco de dados, autenticaç�o, e-mail e cache s�o abstra�das pelos componentes que o framework fornece.

Este artigo � uma apresentaç�o ao framework PHP Laravel e aos seus componentes fundamentais. Primeiro falaremos sobre esses componentes com exemplos de uso. Depois criaremos uma aplicaç�o que calcula o combust�vel necess�rio para uma viajem como forma de praticar o que foi aprendido.

Laravel � um framework MVC

Uma aplicaç�o web tem como funç�o essencial receber requisiç�es de um cliente, trat�-las enviando alguma respostas de volta, geralmente utilizando o HTTP como protocolo de comunicaç�o.

No Laravel, essas funç�es s�o desempenhadas por componentes que seguem a arquitetura MVC, model-view-controller. Isso significa que para criar uma aplicaç�o web com esse framework precisamos definir as rotas, endereços para os recursos, bem como seus controllers e as views com as quais o usu�rio vai interagir.

Conhecendo os componentes do Laravel

Rotas

Rotas s�o endereços para recursos, que por sua vez podem ser qualquer coisa no servidor, desde de um PDF at� um ou mais dados armazenados em algum banco. Por exemplo, localhost/ � a rota para a p�gina inicial da aplicaç�o. J� localhost/pagina_2 � a rota para um outro recurso, provavelmente a segunda p�gina da aplicaç�o.

No que se refere a rotas, / corresponde a raiz do seu projeto.

No Laravel, iniciamos a declaraç�o de rotas utilizando o arquivo routes/web.php. Veja no C�digo 1 um exemplo de uma rota que cont�m uma funç�o que devolve para o cliente o texto "Hello World" quando executada.

Route::get('/', function(){

  return 'Hello World';

});

C�digo 1. Exemplo de rota

Nota: Os arquivos do diret�rio routes ser�o carregados automaticamente pelo Laravel.

Na Linha 1 acessamos o m�todo est�tico get do objeto Routes. Veremos mais � frente o motivo para a utilizaç�o de um verbo na definiç�o de uma rota. / � o endereço que acessaremos, referente a p�gina inicial da aplicaç�o. Podemos acessar essa rota pelos endereços localhost:8000, localhost:8000/ e http://127.0.0.1:8000/, note a aus�ncia e presença da barra /.
Ainda na Linha 1, function () � a declaraç�o de uma funç�o an�nima (sem nome).
Na Linha 3 return retornar� o texto "Hello World" quando a rota for acessada.

Agora que compreendemos as rotas vamos seguir com os conceitos de view, controller e model.

Views

As views s�o as respostas devolvidas para o cliente. Geralmente uma view � um documento, que pode ser do tipo texto puro, como vimos acima, JSON ou, mais comumente, HTML.

No Laravel o mais comum de in�cio � utilizamos uma engine de template como o Blade em nossas views, o que nos permitir� usar HTML/PHP no mesmo arquivo de forma mais organizada. Para isso os arquivos que conter�o as views devem possuir a extens�o [nome].blade.php para que o Blade faça a interpretaç�o do conte�do do mesmo. Do contr�rio, se salvarmos o arquivo com a extens�o [nome].php, o PHP cuidar� da renderizaç�o e ele n�o sabe interpretar a linguagem de template do Blade.

Depois de carregar uma view, uma rota pode retorn�-la e exibir assim seu conte�do, como vemos no C�digo 2 e C�digo 3 a view ola e a rota.

<!DOCTYPE html>
<html>
<head>
    <title>Ol� mundo</title>
</head>
<body>
    <h1>Ol� mundo</h1>
</body>
</html>

C�digo 2. Declaraç�o da view

� criada uma view chamada ola.blade.php no diret�rio view que ao ser acessada exibir� o seu conte�do

Route::get('/', function() {

  return view('ola');

});

C�digo 3. Retornando um view

Ao acessar a rota / ser� retornado o conte�do presente na view ola.

Controllers

Os controllers s�o essencialmente classes que cont�m a l�gica para o tratamento das requisiç�es. Eles t�m como tarefa principal receber a requisiç�o, transmitindo os dados contidos nela para a classe de modelo apropriada. Essa classe de modelo, por sua vez, cont�m alguma l�gica.

Para entendermos melhor vamos criar o nosso primeiro controller. Para isso usaremos o Artisan, que � uma ferramenta de linha de comando com a qual fazemos quase tudo em uma aplicaç�o Laravel, por exemplo, criar controllers.

Veja como criar um controller com o Artisan no C�digo 4.

php artisan make:controller PrimeiroController

C�digo 4. Criando o primeiro controller

Isso criar� um novo arquivo chamado PrimeiroController.php no app/Http/Controllers, como mostrando no C�digo 5.

namespace App \ Http \ Controllers; 
use Illuminate \ Http \ Request;
use App \ Http \ Requests;

class PrimeiroController extends Controller {

}

C�digo 5. Controller padr�o gerado

Por meio de uma rota conseguimos executar um m�todo de um controller, mas para isso precisamos configurar�-la. Veja no C�digo 6 a definiç�o do m�todo hello do controller, que passaremos a usar na p�gina inicial da aplicaç�o.

namespace App \ Http \ Controllers;
use Illuminate \ Http \ Request;
use App \ Http \ Controllers \ Controller;

class PrimeiroController extends Controller {

    public function hello () {
        return 'Ol�, mundo!';
    }
}

C�digo 6. Exemplo de controller simples

Agora, para executar esse m�todo do controller quando o usu�rio acessar uma rota vamos codificar uma nova rota (C�digo 7), onde n�o ser� necess�rio utilizar uma closure, mas sim indicar o controller a ser utilizado.

//rotas/web.php
Route::get ('/', 'PrimeiroController@hello');

C�digo 7. Rota para o controller simples

Acessando a rota / ser� retornado o texto Ol�, mundo!, resultado da execuç�o do m�todo hello do controller.

Esta rota possui uma estrutura diferente daquela vista no C�digo 1. A principal diferença � que n�o usamos uma closure para retornar um valor ou uma view, mas sim a refer�ncia para um controller. A refer�ncia � feita:

Declara-se o nome do controller, nesse caso PrimeiroController;
Utilizando o @ seguido do nome do m�todo do controller que ser� executado;

Com essa estrutura definida, sempre que a rota for acessada, o m�todo do controller definido ser� executado.

Model

O modelos s�o o coraç�o de uma aplicaç�o MVC. At� o que vimos foi como utilizar a infraestrutura do Laravel para fazer com a aplicaç�o funcione na web, mas nos modelos programamos as regras de neg�cio da aplicaç�o e que justificam a sua exist�ncia.

Podemos criar um modelo via Artisan, com o comando que vemos no C�digo 8.

php artisan make:model PrimeiroModel

C�digo 8. Criando o primeiro model

Ap�s a execuç�o do comando ser� inserido no diret�rio App/ o arquivo PrimeiroModel.php, com uma estrutura padr�o, que est� presente no C�digo 9.

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class PrimeiroModel extends Model
{
    //c�digo a ser definido
}

C�digo 9. Arquivo model padr�o

Como vimos foi criado um arquivo model com um estrutura padr�o automaticamente gerada pelo Laravel.

Agora que vimos o que s�o rotas, views, controllers e models, veremos o funcionamento de uma aplicaç�o Laravel de c�lculo de consumo de combust�vel, onde s�o feitas requisiç�es ao controller e por meio do model ser�o exibidas na view as informaç�es requisitadas.

Criando um projeto com o Laravel

O primeiro passo ser� a criaç�o de um projeto e como j� vimos no artigo de Hello World utilizaremos o C�digo 10.

composer create-project --prefer-dist laravel/laravel calculo_consumo

C�digo 10. Criaç�o do projeto calculo_consumo

Agora criaremos duas views para a aplicaç�o, que ser�o a forma de interaç�o do usu�rio com a aplicaç�o. A primeira delas ser� a p�gina principal que conter� um formul�rio onde o usu�rio poder� inserir a dist�ncia percorrida e qual � o consumo de combust�vel por um ve�culo. Enviaremos essas informaç�es para serem processadas no back-end e as retornaremos numa segunda p�gina.

Criando a rota

No arquivo routes/web.php criaremos duas rotas, que ser�o essenciais para o funcionamento da aplicaç�o: a rota / e /gastos. Veja no C�digo 11 sua declaraç�o.

Route::get('/', 'CombustivelController@index');

Route::get('/gasto', 'CombustivelController@gasto');

C�digo 11. Definiç�o das rotas

Definimos as duas rotas, que possuem o direcionamento para o controller Combustivel_Controller.

Criando as views

No diret�rio resource/views criaremos o arquivo consumo.blade.php contendo um formul�rio HTML, como mostrado no C�digo 12.

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">   
    <title>Calculo de Consumo de Combust�vel</title>
    <link rel="stylesheet" href="{{asset('css/style.css')}}" type="text/css">
</head>
<body>    
    <main>
        <div class="painel">
            <h2>Instruç�es</h2>
            <div class="conteudo-painel">
                <p>Esta aplicaç�o tem como finalidade demonstrar os valores que
                    ser�o gastos com combust�vel durante uma viagem, com base no
                consumo do seu ve�culo, e com a dist�ncia determinada por voc�!</p>
                <p>Os combust�veis dispon�veis para este c�lculo s�o:</p>
                <ul>
                    <li><b>Gasolina - R$ 4,80</b></li>
                </ul>
            </div>
        </div>
         
        <div class="painel">
            <h2>C�lculo do valor (R$) do consumo</h2>
            <div class="conteudo-painel">
                <form action="{{url('/gasto')}}" method="get">
                
                    <label for="distancia">Dist�ncia em Quil�metros a ser percorrida</label>
                    <input type="number" class="campoTexto"  name="distancia" required/>
 
                    <label for="autonomia">Consumo de combust�vel do ve�culo (Km/L)</label>
                    <input type="number" class="campoTexto" name="autonomia" required/>
 
                    <button class="botao" type="submit">Calcular</button>
                </form>               
            </div>
        </div>        
                 
    </main>   
</body>
</html>

C�digo 12. View - consumo.blade.php

Veja que mesmo sendo um arquivo .php ele possui toda a estrutura HTML para criaç�o de um formul�rio. Note que diferentemente de outros projetos em PHP, onde no form � inserido um arquivo .php ou um caminho para determinado arquivo, usamos uma nova sintaxe. Utilizamos o m�todo URL() do Laravel que ao ser enviado, o formul�rio apontar� a rota /gasto.

Nota: URL() � uma funç�o do Laravel usada para gerar URLs arbitr�rias para sua aplicaç�o. Ela faz parte de um conjunto chamado helpers.

A segunda view que criaremos ser� resultado.blade.php (o retorno do formul�rio), que exibir� o resultado do c�lculo realizado, como mostra o C�digo 13.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Calculo de Consumo de Combust�vel</title>
    <link rel="stylesheet" href="{{asset('css/style.css')}}" type="text/css">
</head>
<body>
    <div class="painel">
                <h2>Resultado do c�lculo de consumo</h2>
        <div class="conteudo-painel"> 
            <div class='sucesso'>
                <h3>O valor total gasto ser� de</h3>
                <ul>
                    <li><b>Gasolina:</b> R$ {{$valor}}</li>
                </ul>
            </div>
            <a class="botao" href="{{URL('/')}}" title="voltar">Voltar</a>
        </div>
    </div>    
</body>
</html>

C�digo 13. View - resultado.blade.php

Como no C�digo 13 criamos um view como a estrutura HTML, o resultado do consumo de gasolina ser� exibido por meio da vari�vel $valor. Note que no bot�o Voltar foi utilizado o helper url(), indicando a rota / para retornar a view consumo.blade.php.

Nota: A funç�o asset() � utilizada para referenciar o caminho do tema, que pode ser composto por arquivos CSS, JavaScript e imagens.

Na linha 8 � refenciado o arquivo style.css no diret�rio public\css por meio da funç�o asset() aplicando assim o estilo as views. Veremos no C�digo 14 seu conte�do.

.campoTexto {
    width: 100%;
    padding: 8px 8px;
    margin: 5px 0;
    box-sizing: border-box;
    border-color: #D9EDF7; 
    border-radius: 4px;  
}
 
h2 {
    background-color: #D9EDF7;  
    color: #286090;
    margin: 0;
    padding: 12px; 
    text-align: center;
    font-weight: bold;
    font-size: 16px;
}
 
.botao {
    background-color: #286090;
    color: #FFFEFA;
    text-align: center;
    border-radius: 4px;
    padding: 10px 20px;
    margin-top: 10px;
    margin-bottom: 10px;
    width: 100px;
    display: block;
}
 
.painel {
    margin-right: 10px;
    border-width: thin;
    border-style: solid;
    border-color: #D9EDF7;
    flex-grow: 1;
    border-radius: 8px;
    max-width: 500px;
}
 
.conteudo-painel {
    padding: 15px;
}
 
.sucesso {
    padding: 10px;
    border-collapse: collapse;
    border-color: #DFF0D8;
    background-color: #DFF0D8;
    color: #3C763D; 
}

C�digo 14. Criando o model da aplicaç�o

No C�digo 14 s�o declarados todos os estilos CSS que ser�o aplicados em ambas as views para torn�-las p�ginas mais amig�vel.

Criando o model

Criaremos agora o model do nosso projeto que conter� a l�gica para calcular o consumo de combust�vel de um determinado ve�culo. Dentro da pasta do nosso projeto utilizamos o comando do C�digo 15 para criar o arquivo CalculoDeCombustivel.php.

php artisan make:model CalculoDeCombustivel

C�digo 15. Criando o model da aplicaç�o

Ap�s a execuç�o deste comando o arquivo CalculoDeCombustivel.php ser� criado dentro da pasta app. Com nosso arquivo gerado vamos criar o m�todo que conter� a l�gica da nossa aplicaç�o, presente no C�digo 16.

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class CalculoDeCombustivel extends Model
{
    public function calcular(){
    
        $distancia = $_GET['distancia'];
        $autonomia = $_GET['autonomia'];
       
        $valorGasolina = 4.80;
       
        $consumoGasolina = ($distancia / $autonomia ) * $valorGasolina;
        
        return $consumoGasolina;
       
    }
}

C�digo 16. Criando o model da aplicaç�o

Como j� hav�amos visto na criaç�o de um model, apenas inserimos em sua estrutura o m�todo Calcular(),onde criamos as vari�veis que receber�o os dados vindos do formul�rio, uma vari�vel com um valor padr�o, a operaç�o que realiza o c�lculo do consumo e o retorno deste m�todo.

Criando o controller

Acessando a pasta do projeto utilizando o terminal, criaremos o controller da nossa aplicaç�o inserindo o comando do C�digo 17.

php artisan make:controller CombustivelController

C�digo 17. Criando o controller da aplicaç�o

No C�digo 15 o comando artisan criar� dentro do nosso projeto o arquivo CombustivelController.php com a estrutura padr�o de um controller em Laravel.

As rotas da aplicaç�o est�o direcionadas ao controller criado, referenciando dois m�todos: index() e gasto(). Veja no C�digo 18 a declaraç�o de ambos os m�todos.

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

use App\CalculoDeCombustivel;

class CombustivelController extends Controller
{
    public function index(){

        return view('consumo');
    }

    public function gasto(){

       $CalculoDeCombustivel = new CalculoDeCombustivel();

       $valor = $CalculoDeCombustivel->calcular();
        
        return view('resultado',['valor'=>$valor]);
    }
}

C�digo 18. Criando os m�todos do controller

Na linha 11 criamos o primeiro m�todo chamado index(), que apenas cont�m como retorno a view consumo.blade.php. Com isso podemos concluir que ao acessarmos a rota Route::get('/', 'Combustivel_Controller@index') o m�todo index() ser� executado e nos retornar� a view consumo.blade.php..

Na linha 15 definimos o segundo m�todo gasto() e nele criamos um objeto da classe CalculoDeCombustivel() referente ao model da aplicaç�o. A vari�vel $valor armazenar� o retorno da funç�o calcular() e como retorno do m�todo gasto() definiremos a view resultado.blade.php.

Note que diferentemente do retorno do m�todo index(), a vari�vel $valor � passada como par�metro deste retorno. Desta forma, quando a view for carregada $valor exibir� o retorno da funç�o calcular().

Agora com nossos arquivos criados, com as devidas declaraç�es e refer�ncias feitas, podemos executar nossa aplicaç�o com o comando via terminal:

php artisan serve

C�digo 19. Executando a aplicaç�o

Com a execuç�o do comando do C�digo 19 poderemos acessar o endereço localhost:8000 e testar nossa aplicaç�o, como vemos a seguir:

#PraCegoVer - Transcriç�o dos Slides P�gina principal da aplicaç�o, com as instruç�es no topo e abaixo os campos "Dist�ncias em Quil�metros a ser percorrida" e "Consumo de combust�vel do ve�culo", al�m do bot�o calcular
P�gina com o resultado do c�lculo de consumo, onde informa o valor total gasto

Conclus�o

Analisando a estrutura criada vemos a aplicaç�o do padr�o MVC onde ao acessarmos as rotas, que possuem o direcionamento para o controller, ser�o retornadas as views da aplicaç�o com dados vindos do model. Com isso vimos como criar uma aplicaç�o em Laravel e seus fundamentos para seu funcionamento.

Confira tamb�m

Introduç�o ao PHP

Curso

Curso de Laravel