Tutorial instalação – Iniciando com o Laravel parte 1

Neste tutorial de instalação Laravel mostraremos como usar o Composer para instalar o esqueleto inicial deste framework.

Anteriormente publiquei um outro post que faz parte da série de tutorias iniciante com Laravel, nele vimos como instalar a máquina virtual Homestead que disponibiliza um ambiente de desenvolvimento completo do Laravel.

A diferença entre os dois posts é que neste aqui faremos somente a instalação do Laravel sem a instalação dos pré requisitos, e apenas citando quais são eles.

Após a instalação do Laravel, ainda neste tutorial, iniciaremos o desenvolvimento de um web site customizando o esqueleto padrão fornecido pelo framework.

No final partindo do site padrão fornecido pelo framework teremos desenvolvido um site customizado contendo três páginas: inicial, contato e about.



Pré requisitos mínimos Laravel

A versão do Laravel mais recente na época em que o artigo está sendo escrito necessita dos pré requisitos mínimos abaixo:

  • Servidor Web
  • PHP >= 7.2.0, com as seguintes extensões:
    • BCMath PHP
    • Ctype PHP
    • JSON PHP
    • Mbstring PHP
    • OpenSSL PHP
    • PDO PHP
    • Tokenizer PHP
    • XML PHP
  • Composer

Assim sendo, antes de seguir este tutorial instalação Laravel certifique-se de que o computador que vai usar como ambiente de desenvolvimento

Laravel e PHP compatibilidade de versões

Porém, caso seu site não satisfaça a todos os requisitos acima existe a possibilidade de instalar uma versão anterior do Laravel.

Como o requisito de compatibilidade mais comum de não ser atendido é a versão do PHP segue abaixo tabela de compatibilidade do Laravel / PHP:

Versão Laravel Compatível com PHP
4.2 >= 5.4
5.0 PHP >= 5.4, PHP < 7
5.1 PHP >= 5.5.9
5.2 PHP versões entre 5.5.9 – 7.1.*
5.3 PHP versões entre 5.6.4 e 7.1.*
5.4 PHP >= 5.6.4
5.5 PHP >= 7.0.0
5.6, 5.7 e 5.8 PHP >= 7.1.3
6.X PHP >= 7.2.0

Tabela 1: Tabela de compatibilidade entre versões do Laravel e PHP

Composer

O gerenciador de dependências utilizado pelo Laravel é o Composer, portanto, para instalar o framework é necessário que o Composer já esteja instalado.

Para instalar o Composer acesse o site (https://getcomposer.org/ ), nele existem instruções de como usar a linha de comando para instalar o programa e também um arquivo binário de instalação para sistemas Windows.

Caso o Composer já esteja instalado, para checar a versão do programa basta digitar o comando:

composer -V

ou

composer –version

Checando versão do Composer
Resultado do comando composer -V

Instalação do Laravel

Podemos instalar o Laravel usando o Laravel Installer ou o Create project do Composer.

Pelo Laravel Installer

  • composer global require laravel/installer
  • laravel new meu-site

O primeiro comando faz o download e a instalação global do Laravel Instaler; o segundo cria uma nova instalação do framework na pasta que for especificada, que neste caso é meu-site.

Pelo Composer create project

  • composer create-project –prefer-dist laravel/laravel meu-site

Ao usar este comando em vez dos anteriores será feita a instalação de um novo projeto com a versão mais recente do Laravel na pasta especificada, sem a necessidade de fazer o download do Laravel Installer.

Também é possível instalar uma versão diferente do framework Laravel especificando a versão desejada, para isto use o comando com a sintaxe abaixo:

  • composer create-project –prefer-dist laravel/laravel=5.7 meu-site

Nesta forma o comando especifica, além do pacote, qual a versão desejada, que no caso é a 5.7, consulte na tabela 1 as versões compatíveis de PHP e Laravel.

Testando a instalação

Para testar se a instalação foi bem sucedida, entre na pasta do projeto, e digite o comando:

  • php artisan serve

A saída do comando deve ser semelhante a figura abaixo:

Tutorial instalação Laravel
Resultado do comando php artisan serve

Em seguida use o browser para acessar o endereço:

No browser deverá aparecer a tela com o site da instalação padrão do Laravel, semelhante a figura abaixo:

Tela site padrão Laravel
Tela do site padrão do Laravel



Laravel – customização do esqueleto padrão

Vamos agora iniciar a criação de nosso site customizando a instalação padrão do Laravel. No site iremos ter a página inicial e mais duas páginas: contact e about. Para isto a primeira coisa que precisamos fazer é definir as rotas.

Criando as Rotas

Por padrão as rotas no Laravel são definidas no arquivo: routes\web.php, edite este arquivo e substitua o conteúdo que vem logo após os comentários pelo código abaixo:

Route::get('/', ['as' => 'root', function () {
return view('index');
}]);

Route::get('/contact', function () {
return view('contact');
});

Route::get('/about', function () {
return view('about');
});

Route::get('/welcome', function () {
return view('welcome');
});

Em seguida, para verificar se as rotas foram definidas corretamente digite o comando:

  • php artisan route:list

Serão listadas as rotas que estão configuradas atualmente, de forma semelhante à tela abaixo:

Listando as rotas no Laravel

Nesta imagem, para fins de comparação, foram ilustradas duas execuções do comando. A primeira foi feita antes das modificações no arquivo routes\web.php, a segunda foi feita após as alterações neste arquivo.

Criando as Páginas

O passo seguinte em nossa customização é criar o conteúdo das páginas que foram definidas nas rotas.

Iremos criar três páginas: index, about e contact, que serão, respectivamente: página inicial, página sobre nós, e página de contatos.

As páginas devem ser criadas na pasta: resources\views, assim, crie nesta pasta o arquivo index.blade.php, para ser nossa página inicial.

Nota: O nome do arquivo com extensão .blade.php indica ao Laravel que se trata de um arquivo de template do Blade, veremos mais deste mecanismo nos próximos tutoriais.

Página inicial

Digite o seguinte conteúdo:

<h2>
Minha página inicial
</h2>

Página About

Repetindo o processo, crie o arquivo: resources\views\about.blade.php, e nele digite o seguinte conteúdo:

<h2>
Sobre nós
</h2>

Página contact

Por último, crie o arquivo: resources\views\contact.blade.php, e nele digite o seguinte conteúdo:

<h2>
Entre em contato
</h2>

Pronto, agora temos em nosso site quatro páginas acessíveis pelos endereços abaixo:

Note que a última página é a padrão do esqueleto Laravel, ela foi mantida pois a usaremos nos próximos tutoriais para aprimorar a aparência das outras páginas de nosso site.

Por enquanto é só, espero que as informações deste post sejam úteis para você.

No próximo tutorial continuaremos a desenvolver este site e apresentaremos outros recursos do Laravel.

Conheça também:
eBook chatbot usando Laravel Botman e Dialogflow
Vue.js no Laravel

Inscreva-se no blog se gostou do conteúdo e quer ser avisado quando postarmos novos artigos.