Trabalhando com Rotas no Laravel

Laravel � um framework PHP criado para o desenvolvimento de aplicaç�es web, possui uma documentaç�o simples e uma comunidade de desenvolvedores bem vasta e ativa. Atualmente est� na vers�o 10.0, onde trabalha com a arquitetura MVC (Model-Control-View), al�m de nos fornece todas as facilidades que esperamos de um bom framework, ou seja, n�o precisamos nos preocupar com a infraestrutura da nossa aplicaç�o, agilidade no desenvolvimento, reuso de c�digo entre outros.

Quem j� desenvolveu alguma coisa com o framework Ruby on Rails n�o ter� nenhuma dificuldade em se habituar com o Laravel, e nem os mais iniciantes, pois uma das suas principais vantagens � sua baixa curva de aprendizado.

Pr�-Requisitos

Para seguir sem nenhum problema esse artigo voc� dever� ter instalado o PHP, em qualquer vers�o a partir da 5.5, al�m das extens�es Open SSL PHP e PDO PHP, respectivamente, referentes a segurança e banco de dados. Tamb�m � necess�rio um servidor web, como o Apache e um editor de c�digo ou IDE. Por �ltimo, � necess�rio a instalaç�o do Composer, que mostraremos passo a passo como fazer.

Instalaç�o do Composer e o Laravel no Linux

O primeiro passo � abrir o terminal do seu computador e executar o seguinte comando:

curl -sS https://getcomposer.org/installer | php

Ap�s a execuç�o desse c�digo aguarde alguns minutos e o download do Composer dever� ter terminado.

Ap�s o download dever� ter sido baixado um arquivo chamado composer.phar, que iremos copi�-lo para um diret�rio bin�rio. Para isso execute o comando:

sudo mv composer.phar /usr/local/bin/composer

Por fim vamos testar se o composer est� funcionando, indo ao terminal e executando o comando:

composer

Dever� ser exibida uma tela parecida com a apresentada na Figura 1.

Figura 1. Sa�da da execuç�o do comando composer.

Agora que nosso Composer j� est� funcionando iremos fazer o download do Laravel. Podemos fazer isso de v�rias formas, mas aqui iremos fazer via Composer, que � a forma mais r�pida e pr�tica, j� que dessa forma, ao final do download, ele j� configura suas depend�ncias.

Novamente no terminal entre na pasta padr�o do seu servidor web, que geralmente � a /var/www/. Para isso, basta executar o comando:

cd /var/www/

Agora execute o comando a seguir, lembrado que voc� deve substituir a parte your-project-name pelo nome do seu projeto:

#Comando generico
  composer create-project laravel/laravel your-project-name �prefer-dist
  #Criando um projeto com o nome contato
  composer create-project laravel/laravel web-rotas --prefer-dist

Se voc� der uma olhada nas pastas do diret�rio /var/www/ ver� que existe uma nova pasta com o nome do seu projeto, para esse artigo o projeto teve o nome de web-rotas. Ao entrar nele voc� dever� ver uma s�rie de outras pastas, mas duas merecem atenç�o: public, que � a pasta do projeto onde o usu�rio ter� acesso, tornando assim o projeto mais seguro; e a storage, onde ser�o guardados os arquivos de exceç�o, log e v�rios outros arquivos utilizados pelo pr�prio framework, por isso o framework dever� possuir permiss�o total sobre essa pasta.

Para mudar a permiss�o dessa pasta, usamos o seguinte comando:

sudo chmod -R 777 /var/www/web-rotas/storage

Com isso o Laravel j� est� instalado e j� possu�mos nosso primeiro projeto criado, e para testar se tudo est� funcionando corretamente, entre em seu browser e digite o endereço de sua aplicaç�o, no caso � o http://localhost/web-rotas/public/.

Se tudo estiver funcionando corretamente voc� dever� ver a seguinte tela da Figura 2.

Figura 2. Tela inicial do nosso projeto.

Baixando e instalando o Composer e o Laravel no Windows

Para quem est� usando o sistema Windows, entre o no site do Composer (vide seç�o Links) e clique na aba Getting Started. Procure a sess�o Installation � Windows, onde voc� dever� ver um link para o download do Composer-Setup. Ap�s fazer o download clique no instalador e siga o processo de instalaç�o.

Para testar se o Composer foi instalado corretamente v� at� o prompt de comando e digite:

composer

A sa�da deve ser algo parecido com a j� foi apresentado na Figura 1.

Agora vamos instalar o Laravel, entrando no seu reposit�rio do Github (vide seç�o Links) e faça o download do projeto inteiro.

Em seguida descompacte o arquivo baixado e copie a pasta laravel-master para o seu servidor web, se voc� estiver utilizando o Wamp, a pasta padr�o ser� c:\wamp\www. Ap�s copiado renomeie a pasta para contato. N�o deixe de copiar o endereço da pasta do framework c:\wamp\www\contato. Ao voltar para o prompt de comando acesse essa pasta utilizando o comando:

cd c:\wamp\www\contato

Agora que estamos no prompt de comando dentro do diret�rio do nosso framework digite o comando:

composer install

Ap�s a execuç�o desse comando ele ir� buscar todas as depend�ncias do nosso framework e ir� efetuar sua instalaç�o.

Agora que j� estamos com nosso framework e todas as suas depend�ncias instaladas vamos testar se tudo est� funcionando corretamente, acessando pelo browser o endereço de seu projeto, que � o http://localhost/contato/public.

O resultado deve ser o mesmo da Figura 2.

Trabalhando com Rotas

Agora que j� instalamos o framework e temos nossa aplicaç�o criada, aprenderemos a configurar nossa aplicaç�o para dar respostas quando um usu�rio acessar determinadas URLs do nosso projeto, ou seja, iremos criar rotas.

Quando entramos na URL do nosso projeto somos direcionados para uma p�gina inicial padr�o, como mostrado na Figura 2. Quem diz qual � a p�gina padr�o que devemos acessar � o arquivo api.php que est� na pasta /routes.

Utilizando algum editor de c�digo ou o IDE de sua prefer�ncia abra esse arquivo, que ter� o mesmo conte�do presente na Listagem 1.

Listagem 1. Conte�do do api.php.


<?php 
   
  use Illuminate\Http\Request;

  /*
  |--------------------------------------------------------------------------
  | API Routes
  |--------------------------------------------------------------------------
  |
  | Here is where you can register API routes for your application. These
  | routes are loaded by the RouteServiceProvider within a group which
  | is assigned the "api" middleware group. Enjoy building your API!
  |
  */
   
  Route::get(�/�, function () { 
   
  return view(�welcome�); 
   
  });

Esse � o conte�do do arquivo api.php do Laravel 5.1, mas se voc� estiver utilizando uma vers�o anterior o conte�do pode ser algo como o da Listagem 2.

Listagem 2. Conte�do do arquivo routes.php em vers�es anteriores a 5.1 do Laravel.


  <?php 
  /*
  |--------------------------------------------------------------------------
  | Application Routes
  |--------------------------------------------------------------------------
  |
  | Here is where you can register all of the routes for an application.
  | It's a breeze. Simply tell Laravel the URIs it should respond to
  | and give it the controller to call when that URI is requested.
  |
  */
   
  Route::get(�/�, �WelcomeController@index�); 
   
  Route::get(�home�, �HomeController@index�); 
   
  Route::controllers([ 
  �auth� => �Auth\AuthController�, 
  �password� => �Auth\PasswordController�, 
   
  ]);

Na Listagem 1 vemos que j� existe uma rota configurada, ela diz respeito exatamente a p�gina inicial nosso projeto. Agora apague todo esse c�digo para que possamos criar nossa pr�pria rota.

Devemos utilizar o Route::get para que o arquivo de rotas fique com o c�digo da Listagem 3.

Listagem 3. Criando minha primeira rota.


  <?php
   
  Route::get('/', function () {
      return 'Minha Primeira rota com Laravel';
  });

Agora se voc� voltar ao browser e atualizar seu projeto ver� que sua p�gina inicial n�o � mais a mesma.

Isso acontece porque inicialmente estamos chamando o m�todo get da classe Route que est� recebendo dois par�metros: o primeiro � o caminho (ou rota, se preferir) que o navegador dever� acessar; e o segundo par�metro � uma funç�o que dar� alguma resposta ao browser.

Assim, estamos dizendo ao nosso servidor web que quando algu�m acessar a pasta '/', ou seja, a pasta raiz do nosso projeto, dever� ser executado uma funç�o que retorna o texto �Minha primeira rota com Laravel�.

Na nossa funç�o passamos um texto comum, mas podemos passar um conte�do HTML, por exemplo, como mostra o exemplo da Listagem 4.

Listagem 4. Rota com conte�do HTML.


  <?php 
  Route::get(�/�, function() 
  { 
  return �<h1>Minha Primeira rota com Laravel</h1�; 
  });

Podemos criar quantas rotas forem necess�rias para nossa aplicaç�o, no entanto, um problema muito comum � o conflito de rotas, por exemplo.

Vamos criarmos uma segunda rota como mostrado na Listagem 5.

Listagem 5. Exemplo de conflito de rotas.


  <?php 
   
  Route::get(�/�, function() 
  { 
  return �<h1>Minha Primeira rota com Laravel</h1�; 
  }); 
   
  Route::get(�/�, function() 
  { 
  return �<h1>Minha segunda rota com Laravel</h1�; 
  });

Nesse c�digo vemos que existe duas rotas, mas o problema � que ambas est�o apontando para o mesmo diret�rio o '/' e, dessa forma, se tentarmos acessar novamente nossa p�gina pelo navegador veremos que a segunda rota est� sobrescrevendo a primeira. Assim devemos tomar muito cuidado com o endereço que passamos para nossas rotas.

Criando uma P�gina de Contato

Como o Laravel � um framework que trabalha com MVC, mas se observarmos como estamos criando atualmente nossas rotas vemos que existe um problema nisso, pois ao passar uma funç�o como resposta n�o estamos utilizando de forma correta a orientaç�o a objetos, assim, a medida em que nosso projeto for crescendo poder� ser necess�ria a implementaç�o de um banco de dados, a criaç�o de nossas regras de neg�cio e etc. Se colocarmos tudo isso dentro do arquivo api.php tornaremos esse arquivo muito bagunçado e de dif�cil manutenç�o, em outras palavras, nosso projeto ir� virar uma bagunça, pois, teremos que misturar a conex�o com o banco com c�digo HTML e etc.

Aplicando o padr�o MVC

Ao inv�s de reunir toda a l�gica da nossa aplicaç�o em um �nico arquivo vamos dividir as responsabilidades como proposto no padr�o MVC. Para isso, cada funcionalidade do nosso projeto dever� possuir um Controller diferente.

Como queremos criar uma p�gina de contato, vamos criar um novo arquivo chamado ContatoController dentro do diret�rio app/Http/Controllers. Nosso controller dever� possuir um m�todo chamado lista que ir� pegar as informaç�es de contato como nome, e-mail e telefone e apresentar para o visitante do site. Nosso arquivo ContatoController.php dever� ficar como o da Listagem 6.

Listagem 6. C�digo do ContatoController.php


  <?php 
   
    namespace App\Http\Controllers;
   
  class ContatoController {
   
              public function lista(){ 
                          // c�digo do m�todo
              } 
  }

Veja que como nosso projeto possui uma hierarquia de diret�rios, por isso, na primeira linha do nosso arquivo precisamos definir um namespace com a localizaç�o do arquivo. Outra observaç�o importante � que qualquer controller do Laravel precisa herdar da classe Controller, que � fornecida pelo pr�prio framework. Para isso vamos editar nosso arquivo conforme a Listagem 7.

Listagem 7. Herdando da classe Controller.


  <?php 
   
  namespace App\Http\Controllers;
   
  class ContatoController extends Controller { 
   
              public function lista(){ 
                          // c�digo do m�todo
              } 
  }

Agora vamos começar a implementaç�o do nosso m�todo lista, que ir� retornar um HTML como nossas informaç�es de contato, como mostra a Listagem 8.

Listagem 8. Implementado o m�todo lista.


  <?php
   
  namespace App\Http\Controllers;
   
  class ContatoController extends Controller {
   
              public function lista(){
                          return '<h1>Informaç�es para Contato</h1>
                                     <b>Nome:</b> Luciano Alexandre <br />
                                     <b>Telefone:</b> (xx) xxxxx-xxxx <br />
                                     <b>e-mail:</b> luciano.cnrn@gmail.com <br />';
              }
  }

Agora que j� criamos o nosso controller vamos criar uma nova rota que ir� apontar para o m�todo que acabamos de implementar. A Listagem 9 mostra o nosso api.php.

Listagem 9. Criando nova rota.


  <?php
   
  // outras rotas
   
  Route::get('/contato', 'ContatoController@lista');

Como vemos, para apontar nossa rota para um m�todo passamos a classe seguido de um @ e logo ap�s o m�todo que queremos utilizar. Agora, se tentarmos acessar a p�gina http://localhost/web-rotas/public/contato veremos que o m�todo lista dever� ser executado e o navegador dever� exibir algo parecido com a Figura 3.

Figura 3. Tela de Contato.

Problema comum com Rotas

� comum, principalmente entre os usu�rios Linux, enfrentar alguns problemas ao tentar utilizar uma rota que n�o esteja apontando para o diret�rio '/'. No nosso c�digo direcionamos a rota para '/contato', assim, n�o se surpreenda se ao tentar acess�-la pelo navegador apareça a mensagem:

Not Found
  The requested URL /localhost/contato/public/contato was not found on this server.

Caso isso aconteça entre no arquivo /etc/apache2/httpd.conf e faça duas alteraç�es. Primeiro localize o trecho da Listagem 10.

Listagem 10. Trecho do arquivo httpd.conf.


  <Directory "/var/www/html">
      ...
      AllowOverride None
      ...
  </Directory>

E altere para que fique como na Listagem 11.

Listagem 11. Novo trecho do arquivo httpd.conf.


  <Directory "/var/www/html">
      ...
      AllowOverride All
      ...
  </Directory>

Pode ser que com a alteraç�o apresentada seu problema seja resolvido, mas caso ele continue altere novamente o arquivo httpd.conf adicionando um novo trecho de c�digo, mostrado na Listagem 12.

Listagem 12. Alterando o httpd.conf.


  <VirtualHost 127.0.0.1:80>
      DocumentRoot "/var/www/html/epigroove/public"
      
      <Directory "/var/www/html/epigroove/public">
          AllowOverride All
      </Directory>
  </VirtualHost>

Ap�s finalizar a ediç�o do arquivo reinicie o Apache, para isso, execute o comando:

/etc/init.d/apache2 restart

Agora seu problema dever� estar resolvido.

Usando o Banco de Dados

At� agora estamos trabalhando com as informaç�es de contato via texto, no entanto, em um cen�rio real, muitas vezes, ser� necess�rio pegar essa e outras informaç�es direto de um banco de dados. Agora vamos aprender a trabalhar com o MySQL junto com o Laravel. Primeiro vamos criar um novo banco de dados chamado contato_laravel. Isso pode ser feito executando o c�digo SQL no MySQL:

create database contato_laravel;

Para criar a nossa tabela que ir� salvar as nossas informaç�es de contato execute o c�digo da Listagem 13.

Listagem 13. SQL para criaç�o de tabela contato.


  DROP TABLE IF EXISTS `contato`;
   
  CREATE TABLE `contato` (
    `id` int(11) NOT NULL AUTO_INCREMENT,
    `nome` varchar(255) COLLATE utf8_unicode_ci DEFAULT NULL,
    `telefone` varchar(12) COLLATE utf8_unicode_ci DEFAULT NULL,
    `email` varchar(50) COLLATE utf8_unicode_ci DEFAULT NULL,
    PRIMARY KEY (`id`)
  )

Vamos adicionar um registro executando os c�digos SQL da Listagem 14.

Listagem 14. Inserindo dados no banco.


  INSERT INTO contato_laravel 
  (nome, telefone, email) 
   
  VALUES ('luciano',  '9999-9999', 'luciano.cnrn@gmail.com');

Com o database preparado vamos começar a configurar o nosso projeto Laravel para receber esses dados. Ao abrir o arquivo config/database.php voc� dever� enxergar uma seç�o com as configuraç�es padr�o do MySQL, como mostra a Listagem 15.

Listagem 15. Arquivo config/database.php.


  'mysql' => [
              'driver'    => 'mysql',
              'host'      => env('DB_HOST', 'localhost'),
              'database'  => env('DB_DATABASE', 'forge'),
              'username'  => env('DB_USERNAME', 'forge'),
              'password'  => env('DB_PASSWORD', ''),
              'charset'   => 'utf8',
              'collation' => 'utf8_unicode_ci',
              'prefix'    => '',
              'strict'    => false,
          ],

Agora vamos editar esse arquivo e deix�-lo com as configuraç�es do nosso banco de dados. No campo database colocaremos contato_laravel, o usu�rio ser� o root e a senha vazia, que � o padr�o do MySQL, mas caso voc� tenha alterado a senha coloque-a nesse campo. Com isso o arquivo ficar� com a mesma codificaç�o da Listagem 16.

Listagem 16. Arquivo ap�s ediç�o.


  'mysql' => [
              'driver'    => 'mysql',
              'host'      => env('DB_HOST', 'localhost'),
              'database'  => env('DB_DATABASE', 'contato_laravel'),
              'username'  => env('DB_USERNAME', 'root'),
              'password'  => env('DB_PASSWORD', ''),
              'charset'   => 'utf8',
              'collation' => 'utf8_unicode_ci',
              'prefix'    => '',
              'strict'    => false,
          ],

Para testar se tudo est� funcionando corretamente voc� pode executar um c�digo SQL pelo pr�prio Laravel utilizando a classe DB, que pode ser encontrada dentro do diret�rio vendor\laravel\framework\src\Illuminate\Support\Facades\DB.php. Essa classe nos fornece alguns m�todos para manipulaç�o do banco de dados, como o select, insert e etc.

Para realizarmos uma consulta na tabela contato e buscar os registros podemos utilizar o m�todo select dessa forma:

$contato = DB::select(�select * from contato�);

Ent�o nosso controller dever� ficar igual a Listagem 17.

Listagem 17. Classe ContatoController.


  <?php
   
  namespace App\Http\Controllers;
   
  use Illuminate\Support\Facades\DB;
   
  class ContatoController extends Controller {
   
      public function lista() {
          $contato = DB::select('select * from contato');
          return '<h1>Listagem de Contatos com Laravel</h1>';
      }
   
  }

Agora vamos alterar novamente nosso controller para imprimir todos os valores retornados do banco de dados. Para isso vamos alterar o m�todo lista para concatenar as informaç�es de contato, como mostra a Listagem 18.

Listagem 18. Imprimindo e formatando a resposta do nosso select.


  <?php
  namespace contato\Http\Controllers;
  use Illuminate\Support\Facades\DB;
  class ContatoController extends Controller {
      public function lista() {
          $html = '<h1>Listagem de contatos com Laravel</h1>';
          $html .= '<ul>';
          $contatos = DB::select('select * from contato');
          foreach ($contato as $c) {
              $html .= '<li> Nome: '. $c->nome .',
              telefone: '. $c->telefone .',
              email: '. $c->email . '</li>';
          }
   
          $html .= '</ul>';
          return $html;
      }
  }

Provavelmente um erro na conex�o com o banco de dados ser� retornado. Caso isso ocorra altere novamente o arquivo database.php para que ele fique como a Listagem 19.

Listagem 19. Conte�do do arquivo database.php.


   'mysql' => [
              'driver'    => 'mysql',
              'host'      => 'localhost',
              'database'  => 'tarefas',
              'username'  => 'root',
              'password'  => 'totustuus123',
              'charset'   => 'utf8',
              'collation' => 'utf8_unicode_ci',
              'prefix'    => '',
              'strict'    => false,
          ],

Repare que retiramos os campos env(), isso deve ser o suficiente para sua aplicaç�o funcionar, isso porque o seu banco n�o � local.

Espero que tenham gostado de mais esse artigo! Forte abraço e at� o pr�ximo.

Framework PHP Laravel: Trabalhando com Rotas

Veja nesse artigo como trabalhar com o Laravel para criar rotas.