Laravel Tutorial: Introdu��o ao Laravel Framework PHP

Laravel � um Framework PHP utilizado para o desenvolvimento web, que utiliza a arquitetura MVC e tem como principal caracter�stica ajudar a desenvolver aplicaç�es seguras e perform�ticas de forma r�pida, com c�digo limpo e simples, j� que ele incentiva o uso de boas pr�ticas de programaç�o e utiliza o padr�o PSR-2 como guia para estilo de escrita do c�digo.

Para a criaç�o de interface gr�fica, o Laravel utiliza uma Engine de template chamada Blade, que traz uma gama de ferramentas que ajudam a criar interfaces bonitas e funcionais de forma r�pida e evitar a duplicaç�o de c�digo.

Para se comunicar com um Banco de Dados o Laravel utiliza uma implementaç�o simples do ActiveRecord chamada de Eloquent ORM, que � uma ferramenta que traz v�rias funcionalidades para facilitar a inserç�o, atualizaç�o, busca e exclus�o de registros. Com configuraç�o simples e pequena e com pouco c�digo podemos configurar a conex�o com Banco de Dados e trabalhar com ele.

Relacionado: Curso de Laravel Completo

Atualmente o Framework est� em sua vers�o 5.1, e a primeira vers�o LTS lançada neste ano de 2015 ser� a vers�o que utilizaremos para criar nossa primeira aplicaç�o.

Para quem j� trabalhou com o Framework Ruby on Rails da linguagem Ruby n�o ter� nenhuma dificuldade de aprender a trabalhar com o Laravel, pois as semelhanças entre os dois s�o muito grandes e at� mesmo para quem nunca trabalhou com nenhum Framework, pois o Laravel possui uma �tima documentaç�o, uma comunidade muito ativa e uma curva de aprendizado bem menor do que outros Frameworks.

Requisitos

Para esse artigo voc� deve ter instalado em seu computador a vers�o 5.5.9 ou maior do PHP e as extens�es OpenSSL PHP, PDO PHP, Mbstring PHP, Tokenizer. Tamb�m precisar� ter instalado o Composer, um servidor como Apache/Nginx e um editor de c�digo ou IDE de sua prefer�ncia.

Al�m disso, utilizaremos o XAMPP que j� nos fornece o PHP, o servidor Apache e o banco de dados MySQL, o editor de c�digo Sublime Text 3 e o Cmder como terminal. Neste exemplo inicial n�o usaremos o banco de dados, mas � importante ter um instalado para futuras aplicaç�es.

Criaç�o do Projeto

Primeiramente criaremos um projeto Laravel em nossa m�quina. Abra o terminal do Windows e navegue at� a pasta htdocs do XAMPP e digite o comando a seguir:

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

Assim usamos o Composer para criar um novo projeto Laravel em nosso diret�rio htdocs chamado �aprendendo-laravel�. Espere alguns instantes at� serem baixados todos os arquivos, pois o processo pode demorar dependendo da conex�o.

Criando nosso Virtual Host

Com nosso projeto criado, agora precisamos criar e configurar nosso host virtual. Primeiramente abra o arquivo httpd-vhosts.conf, que se encontra no diret�rio do XAMPP: <DIRET�RIO XAMPP>\apache\conf\extra. No final do arquivo insira o c�digo da Listagem 1.


    <VirtualHost *:80>
      ServerName aprendendoLaravel
      DocumentRoot "<DIRET�RIO XAMPP>\htdocs\aprendendo-laravel\public"
      <Directory "<DIRET�RIO XAMPP>\htdocs\aprendendo-laravel\public">
        AllowOverride all
      </Directory>
    </VirtualHost>

Listagem 1. C�digo para criar Virtual Host

Depois de alterar o arquivo, salve-o e feche-o. Abra o arquivo hosts no diret�rio C:\Windows\System32\drivers\etc e no final do arquivo insira esse c�digo:

127.0.0.1 aprendendoLaravel

Salve e feche o arquivo. Depois dessas alteraç�es j� temos nosso Virtual Host configurado.

Agora vamos ver se nossa aplicaç�o est� funcionando. Se o XAMPP n�o estiver ativo, ative-o e v� at� o browser e digite na barra de endereços: �http://aprendendoLaravel�. Se tudo estiver configurado corretamente voc� ver� uma tela como a da Figura 1.

Figura 1. Tela inicial do Laravel 5.1

Quando criamos nosso projeto, temos uma estrutura igual a da Figura 2.

Figura 2. Estrutura padr�o de um projeto Laravel

No diret�rio raiz podemos ver que temos v�rios arquivos e outros diret�rios:

Diret�rio �app� - nele temos todos arquivos de nossa aplicaç�o, podemos ver v�rios outros diret�rios, mas iremos focar no diret�rio Http, pois nele temos o nosso arquivo routes.php, que � onde definimos todas as rotas de nossa aplicaç�o. Temos tamb�m v�rios diret�rios, entre eles, o �Controllers�, que � onde ficam todos os controllers de nossa aplicaç�o.
Diret�rio config - onde configuramos todo nosso projeto. Nele temos o arquivo app.php, que � onde podemos configurar v�rias vari�veis de nossa aplicaç�o como local, fuso-hor�rio, os providers e definir os aliases de nossa aplicaç�o. Ainda no diret�rio config temos o arquivo database.php que � onde definimos todas as configuraç�es sobre a conex�o com o Banco de Dados. Ainda temos v�rios outros arquivos como o mail.php para definir configuraç�es de e-mail de nossa aplicaç�o;
Diret�rio database - onde definimos tr�s tipos de arquivos importantes:
o Migrations: uma das ferramentas mais poderosas do Laravel para definir, atrav�s de arquivos PHP, como nosso Banco de Dados deve ser criado. Atrav�s do Artisan, que � a interface de linha de comando do Laravel, criamos, alteramos e exclu�mos tabelas do nosso Banco de Dados de forma f�cil, r�pida e intuitiva;
o Seeds: com esses arquivos podemos popular as tabelas do Banco de Dados com os dados que queremos para testes de forma f�cil e r�pida;
o Factories: essa ferramenta foi introduzida na vers�o 5.1 do Framework, para popular as tabelas do Banco de Dados com dados criados de forma autom�tica e rand�mica, permitindo incluir uma grande massa de dados de forma bem r�pida para criaç�o de testes;
Diret�rio �public� - possui os arquivos .htaccess e index.php, que � o roteador de nossa aplicaç�o. Ele recebe as requisiç�es, as trata atrav�s do kernel e retorna para os usu�rios as respostas.
Diret�rio �resources� - nele temos tr�s diret�rios importantes:
o Assets: usado para armazenarmos todos arquivos de estilo (CSS, LESS, SASS, etc.), scripts (JavaScript, etc.), imagens e outros recursos necess�rios para nossa aplicaç�o
o Lang: usado para armazenarmos os arquivos de traduç�o para nossa aplicaç�o;
o Views: usado para armazenar os arquivos de nossa camada de visualizaç�o;
Diret�rio �tests� - nele salvamos todos os testes de nossa aplicaç�o;
Diret�rio �vendor� - nele temos todos os arquivos de terceiros utilizados em nosso projeto, ou seja, bibliotecas, plugins, etc;
Arquivo �.env� - nele definimos v�rias configuraç�es de nossa aplicaç�o, como os dados de configuraç�o da conex�o do banco de dados e a configuraç�o de e-mails.
Arquivo gulpfile.js - nele temos acesso a API do Elixir, que � usado para definir tarefas do Gulp para nossa aplicaç�o.

O Fluxo de nossa Aplicaç�o

As aplicaç�es criadas com o Framework Laravel seguem um fluxo baseado na arquitetura MVC. Primeiramente devemos definir as rotas para que nossos usu�rios possam fazer requisiç�es e criar os Controllers necess�rios para tratar as requisiç�es de nossos usu�rios.

Vamos fazer um exemplo b�sico abrindo o arquivo routes.php dentro do diret�rio app\Http. Nele podemos ver um c�digo padr�o, que podemos apagar e digitar o c�digo a seguir no lugar:

<?php
      Route::get('/', 'PagesController@index');

Assim definimos que quando nosso usu�rio acessar a rota /, ou seja, a rota inicial de nossa aplicaç�o, o Controller chamado PagesController.php ficar� respons�vel por tratar a requisiç�o de nosso usu�rio e retornar uma resposta a ele.

Vamos agora utilizar o Artisan, abrindo o terminal e navegando at� o diret�rio raiz de nosso projeto, onde digitaremos:

php artisan make:controller PagesController

Depois de executar o c�digo, abra o diret�rio Controllers em app\Http e veja que um novo arquivo foi criado: o PagesController.php. Como padr�o do Framework, quando criamos um novo Controller, damos um nome a ele e logo � frente colocamos a palavra �Controller�.

Abra o arquivo que foi criado e ver� que o Laravel j� cria, por padr�o, v�rios m�todos em nosso Controller, que voc� pode apagar, com exceç�o do m�todo index().

At� agora j� temos configurado a rota, o Controller e o m�todo que ir� cuidar da requisiç�o de nosso usu�rio.

Relacionado: Curso de PHP B�sico

Quando o Controller acessa no browser �http://aprendendoLaravel�, o m�todo index() do controller ser� executado.

O que falta para que o fluxo de nossa aplicaç�o se complete � que devemos criar a camada de visualizaç�o de nossa aplicaç�o. Para isso abra o arquivo welcome.blade.php em resources\views e apague todo o seu conte�do. Em seguida, digite o c�digo da Listagem 2.


    <! 
      DOCTYPE html>
      <html>
          <head>
              <meta charset="UTF-8">
              <title>Minha Primeira Aplicaç�o Laravel</title>
          </head>
          <body>
              <h1>Ol� Mundo!</h1>
          </body>
      </html>

Listagem 2. C�digo da p�gina inicial de nossa aplicaç�o

Depois de definirmos o conte�do da p�gina inicial da nossa aplicaç�o, precisamos fazer com que nosso Controller exiba nossa p�gina criada quando o usu�rio acessar a rota inicial de nossa aplicaç�o. Abra novamente o arquivo PagesController.php e edite o m�todo index() para que ele fique com o c�digo da Listagem 3.


    public function index()
    {
      return view('welcome');
    }

Listagem 3. C�digo para Controller chamar p�gina welcome.blade.php

Assim definimos que quando o usu�rio acessar a rota / de nossa aplicaç�o o m�todo index() ir� retornar ao usu�rio a p�gina welcome.blade.php que criamos. Quando definimos qual p�gina devemos retornar, n�o precisamos colocar .blade.php, o Laravel consegue entender qual a p�gina que estamos referenciando.

Dessa maneira criamos um fluxo completo de uma aplicaç�o Laravel, onde o usu�rio acessa uma rota definida em nossa aplicaç�o, o m�todo definido � chamado, processa a requisiç�o e devolve ao nosso usu�rio uma resposta, nesse caso uma p�gina.

Pronto para aplicaç�es RESTful

O Laravel j� foi feito pensado para facilitar a criaç�o de serviços RESTful, portanto, quando devolvemos alguma vari�vel, objeto, array ou qualquer outro dado em nossos Controllers, eles j� s�o convertidos automaticamente para formato JSON. Para exemplificar vamos criar mais uma rota em nosso arquivo routes.php:

Route::get(�/amigos�, �PagesController@amigos�);

Agora vamos criar mais um m�todo em nosso arquivo PagesController.php para tratar a requisiç�o de nossa nova rota, como mostra a Listagem 4.


    /**
      * Retorna JSON com lista de amigos
      *
      * @return Response
    */
    public function amigos()
     {
      $amigos = [
        ['nome' => 'Jos� Silva', 'idade' => 22],
        ['nome' => 'Maria Jos�', 'idade' => 20],
        ['nome' => 'Jo�o Pinheiro', 'idade' => 35]
      ];
      return $amigos;
    }

Listagem 4. M�todo que cria array e o retorna em formato JSON

No m�todo apenas criamos um array com tr�s posiç�es e o retornamos. Quando fazemos isso, o Framework j� o converte para o formato JSON automaticamente e o retorna para o usu�rio, como podemos ver na Figura 3.

Figura 3. Array transformado em JSON pelo Laravel

Passando Informaç�es para a Camada de Visualizaç�o

Al�m de retornar os dados como JSON para nossos usu�rios, podemos tamb�m retornar uma p�gina com os dados de nossas vari�veis. Vamos criar mais uma rota para nossa aplicaç�o com o seguinte c�digo:

Route::get(�/sobre�, �PagesController@sobre�);

Agora vamos criar um m�todo em nosso arquivo PagesController.php para tratar as requisiç�es de nossa nova rota, como mostra a Listagem 5.


    /**
     * Retorna p�gina com informaç�es pessoais
     *
     * @return Response
    */
    public function sobre()
    {
      $eu = [
       'nome' => 'Wendell Adriel',
       'idade' => 23
      ];
      return view('sobre', compact('eu'));
    }

Listagem 5. M�todo que retorna tela ao usu�rio com dados passados pelo Controller

Criamos um array com nome e idade e passamos ao nosso arquivo sobre.blade.php. Poder�amos tamb�m passar as informaç�es sem utilizar a funç�o compact(), ficando � escolha de cada um.

Agora vamos criar nosso arquivo sobre.blade.php no diret�rio resources/views, como mostra a Listagem 6.


    <!DOCTYPE html>
    <html>
      <head>
        <meta charset="UTF-8">
        <title>Sobre mim</title>
      </head>
      <body>
        <h1>Meu nome � {{ $eu['nome'] }}</h1>
        <h2>Tenho {{ $eu['idade'] }} anos</h2>
      </body>
    </html>

Listagem 6. P�gina com as informaç�es recebidas pelo Controller

Podemos ver que para imprimir vari�veis na nossa p�gina devemos utilizar os valores passados dentro de dois pares de chaves �{{ vari�vel }}�.

Criando e Utilizando Layouts com Blade

Pensando no reaproveitamento de c�digo, o Blade permite criar �p�ginas mestres� para que outras p�ginas possam utiliz�-las como padr�o e mudar apenas o conte�do vari�vel de cada p�gina espec�fica. Para exemplificar vamos criar um arquivo que ir� servir como template para todas as nossas outras p�ginas e depois mud�-las.

Crie o arquivo app.blade.php no diret�rio resources/views com o conte�do da Listagem 7.


    <!DOCTYPE html>
    <html>
      <head>
        <meta charset="UTF-8">
        <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
        <title>@yield('titulo')</title>
      </head>
      <body>
        <div class="container">
          @yield('conteudo')
        </div>
        <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
      </body>
    </html>

Listagem 7. P�gina-mestre de nossa aplicaç�o

Definimos um layout padr�o para nossas p�ginas com a importaç�o do Framework Bootstrap para podermos criar nossas p�ginas.

Definimos tamb�m duas seç�es diferentes na p�gina. Para isso utilizamos o @yield e definimos um nome para a seç�o, dessa maneira, outras p�ginas podem utilizar o layout padr�o e aproveitar toda a parte est�tica de nosso layout sem ter que duplicar o c�digo e apenas definir o conte�do particular de cada p�gina.

Vamos agora voltar ao nosso arquivo welcome.blade.php e fazer as alteraç�es necess�rias para que ele utilize o layout padr�o, como na Listagem 8.


    @extends('app')
    @section('titulo')
     SEJA BEM VINDO
    @stop
       
    @section('conteudo')
      <h1>Ol� Mundo</h1>
    @stop

Listagem 8. Atualizando nossa p�gina para utilizar layout padr�o

No c�digo vimos que a definiç�o da nossa p�gina fica bem mais limpa e r�pida de se fazer, pois como estamos utilizando o layout padr�o, agora definimos apenas o conte�do que � particular de cada p�gina.

Primeiramente utilizamos o @extends com o nome de nosso arquivo (nesse caso utilizamos �app�, que aponta para o nosso arquivo app.blade.php) de layout padr�o para indicar ao framework que o estamos utilizando, al�m da definiç�o das seç�es desse arquivo.

Em segundo lugar declaramos as duas seç�es do layout: �titulo� e �conteudo�, e definimos o conte�do de cada uma. Dessa maneira poderemos personalizar nossas p�ginas de forma r�pida e sem duplicaç�o de c�digo.

Agora abra o arquivo sobre.blade.php e altere o seu conte�do conforme a Listagem 9.


    @extends('app')
    @section('titulo')
      SOBRE MIM
    @stop
    @section('conteudo')
      <h1>Meu nome � {{ $eu['nome'] }}</h1>
      <h2>Tenho {{ $eu['idade'] }} anos</h2>
    @stop

Listagem 9. C�digo atualizado do arquivo sobre.blade.php

Aumentando a produtividade

Al�m de todas funcionalidades apresentadas at� agora, o Laravel fornece diversas ferramentas para aumentar nossa produtividade e evitar que gastemos tempo com certas tarefas, permitindo assim que o nosso foco seja o desenvolvimento de soluç�es para nossas aplicaç�es e cuidando da parte �chata� do trabalho para n�s. Algumas dessas ferramentas s�o o Elixir (automatizador de tarefas), o SwiftMailer (Biblioteca para envio de e-mails) e o Artisan (Interface de Linha de Comando).

Elixir

Esse nos d� suporte para utilizar diversos pr�-processadores CSS e JavaScript, al�m de fornecer uma API simples e pr�tica para definir tarefas simples do Gulp, que � um automatizador de tarefas que realiza para n�s tarefas como concatenaç�o, minificaç�o e testes de scripts. O Gulp utiliza um arquivo de configuraç�o (Gulpfile) com uma sintaxe de c�digo bem simples.

SwiftMailer

O Laravel oferece uma API simples que utiliza a biblioteca SwiftMailer para envio de e-mails utilizando serviços locais ou serviços na nuvem. Al�m disso, ele nos oferece drivers para SMTP, Mailgun, Mandrill e Amazon SES e um serviço como o Mailtrap para testar se os e-mails est�o da forma que foram planejados. Dessa maneira podemos enviar e-mails com textos, imagens e anexos de forma r�pida e sem muito esforço.

Artisan CLI

� a interface de Linha de Comando do Laravel, que pode realizar diversas aç�es em nossas aplicaç�es como: configuraç�o de ambiente da nossa aplicaç�o, verificar rotas existentes, interagir com nossa aplicaç�o e criar diversos tipos de arquivos como: migrations, controllers, etc.

Al�m de todos os comandos j� oferecidos, podemos criar nossos pr�prios comandos para agilizar e automatizar alguns processos durante o desenvolvimento de nossas aplicaç�es, permitindo personalizar o Framework �s nossas necessidades.

Testando as aplicaç�es

O Laravel j� oferece uma estrutura simples, pr�tica e s�lida para testes utilizando o PHPUnit. Basta voc� criar um arquivo de teste no diret�rio �tests� e deixar que o Framework cuide do restante, pois quando voc� roda seus testes com o comando �phpunit� ele j� muda automaticamente o ambiente de sua aplicaç�o para teste.

Homestead

�s vezes pode ser bem chato configurar um ambiente de desenvolvimento e isso pode gastar muito tempo dependendo do tipo, e pensando nisso, foi criado o Laravel Homestead, um box oficial com todo ambiente necess�rio para começarmos a desenvolver nossas aplicaç�es. Nele temos o PHP 5.6, banco de dados MySQL, PostgreSQL e Redis, NodeJS, servidor Nginx, HHVM e v�rias outras ferramentas rodando no Ubuntu 14.04 para auxiliar no desenvolvimento de nossas aplicaç�es. Com isso, podemos começar a desenvolver sem grandes esforços para montar o ambiente de desenvolvimento.

Vimos que o Framework Laravel oferece v�rias ferramentas para a criaç�o r�pida de aplicaç�es, focando apenas nas regras de neg�cios e sem c�digos repetitivos.

Conte�dos Recentes

Gest�o de projetos com MS Project:
Este artigo apresenta uma das ferramentas mais usadas pelo mercado, o MS Project, demonstrando como preparar a ferramenta para seu uso adequado, configurar calend�rios e principalmente compartilhar essas configuraç�es entre projetos.
Mestre Detalhe em detalhes:
Voc� provavelmente j� se deparou com um formul�rio do tipo mestre detalhe enquanto fazia compras, selecionava suas mat�rias do semestre, etc. Mas voc� conhece todas as pequenas armadilhas que a programaç�o dessa rotina esconde? Descubra neste DevCast.
ASP.NET Web API: Criando um web service com v�rias entidades:
Neste exemplo veremos como desenvolver um web service RESTful com ASP.NET Web API que contar� com as funç�es de CRUD com relacionamento 1:N. Al�m disso poderemos tamb�m efetuar filtros e ordenaç�o com OData.
Spring e JPA: Criando um Web Service RESTful 1:N:
Neste curso vamos trabalhar com sub-recursos em uma Web API RESTful desenvolvida com o Spring Framework. Um sub-recurso � formado por registros que est�o diretamente relacionados � exist�ncia de outros registros ou recursos.

Laravel Tutorial

Veja nesse artigo uma introdução ao Framework Laravel para criar nossas aplicações em PHP.