Laravel: Hello world usando o Composer

Fique por dentro

Este artigo � uma introduç�o ao Laravel e apresenta como instal�-lo atrav�s do composer, bem como a criaç�o de um primeiro c�digo que responde ao usu�rio apresentando a mensagem "Hello world" no navegador.

Laravel � um dos frameworks PHP mais utilizados atualmente. Possui uma baixa curva de aprendizado e � intuitivo, pois foi criado com foco na clareza do c�digo.

Requisitos

Para esse artigo voc� deve ter instalado em seu computador:

O PHP na vers�o 7.2 ou superior
O Composer
Um servidor como Apache/Nginx
E um editor de c�digo ou IDE de sua prefer�ncia

As extens�es BCMath, Ctype, JSON, XML, OpenSSL, PDO, Mbstring, Tokenizer precisam estar habilitadas. Para verificar ou habilit�-las � necess�rio editor o arquivo php.ini que se encontra na pasta de instalaç�o do PHP.

Com um editor de texto localize as extens�es e remova o ; no começo da linha. Pois isso far� com que o PHP as reconheça como habilitadas.

Figura 1. Extens�es do PHP

Com essas configuraç�es feitas, podemos partir para a instalaç�o do Laravel e uma das formas mais comuns para fazer isso � atrav�s do Composer.

Instalaç�o do Composer

O Composer � um gerenciador de depend�ncias para PHP que tem como objetivo simplificar a instalaç�o e atualizaç�o de bibliotecas externas. Ser� por meio dele que realizaremos a instalaç�o do Laravel em nosso computador. Ent�o � necess�rio t�-lo instalado em nosso ambiente de desenvolvimento.

Acessando sua p�gina oficial, vamos na opç�o Download e baixamos o arquivo Composer-Setup.exe referente a vers�o Windows.

Sua instalaç�o � um processo bem simples, veja o passo a passo abaixo de como realizar:

Figura 2. Instalaç�o Composer

#PraCegoVer - Transcriç�o dos Slides P�gina oficial do Composer, com v�rias opç�es. Escolha a opç�o download para baixar o arquivo de instalaç�o
Ao executar o programa baixado, clique em next at� chegar na opç�o install
Ap�s acompanhar o download e a instalaç�o do Composer, a mensagem de setup completo aparecer�. Clique em Finish para fechar o programa

Saiba mais sobre o Composer

Utilizaremos para criar nossa aplicaç�o o XAMPP, que j� nos fornece o PHP, o servidor Apache e e o banco de dados MySQL, o editor de c�digo Visual Studio Code e o terminal do sistema operacional. Neste exemplo inicial n�o usaremos o banco de dados, mas � importante ter um instalado para futuras aplicaç�es.

Instalaç�o do Laravel via Composer

Primeiramente instalaremos o Laravel e criaremos um projeto em nosso computador via composer.

Abra o terminal do Windows e navegue at� a pasta htdocs do XAMPP e digite o comando a seguir:

composer create-project --prefer-dist laravel/laravel hello-world

C�digo 1: Instalaç�o do Laravel e criaç�o do projeto hello-world

Assim usamos o Composer para criar um novo projeto Laravel em nosso diret�rio htdocs chamado hello-world. Espere alguns instantes at� serem baixados todos os arquivos, pois o processo pode demorar dependendo da sua velocidade de internet, como mostra as figuras a seguir:

Agora vamos ver se nossa aplicaç�o est� funcionando. Iniciaremos o servidor interno do PHP para que possamos acessar no navegador o projeto criado. Digite o comando dentro da pasta hello-world:

php artisan serve

C�digo 2: Inicia o servidor interno do PHP na pasta do projeto

O artisan � o nome da interface da linha de comando inclu�da no Laravel. Ela fornece um bom n�mero de comandos auxiliares para que voc� use durante o desenvolvimento de sua aplicaç�o.

Ap�s a execuç�o do comando ser� exibido no terminal o caminho http://127.0.0.1:8000. Atrav�s dele podemos acessar a aplicaç�o no navegador e assim verificar se ela est� em execuç�o e o laravel foi instalado corretamente. Na Figura 2, vemos a p�gina padr�o do Laravel aberta no navegador.

O acesso ao projeto poder� ser feito tanto por http://127.0.0.1:8000 ou http://localhost:8000.

Figura 3. Tela inicial do Laravel

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

Figura 4. Estrutura padr�o de um projeto Laravel

Diret�rios do projeto

Com o projeto criado vemos que alguns diret�rios e arquivos s�o criados automaticamente. Destes veremos abaixo os principais e suas caracteristicas:

App - cont�m o c�digo principal do seu aplicativo.
Bootstrap - cont�m o arquivo app.php que inicializa a estrutura.
Config - como o nome indica, cont�m todos os arquivos de configuraç�o do seu aplicativo..
Database - cont�m sua database migrations, model factories, and seeds.
Public - cont�m o arquivo index.php, que � o ponto de entrada para todas as solicitaç�es que entram no seu aplicativo e configura o carregamento autom�tico.
Resources - cont�m suas visualizaç�es e seus recursos brutos, n�o compilados, como LESS, SASS ou JavaScript.
Routes - cont�m todas as definiç�es de rota para seu aplicativo. Por padr�o, v�rios arquivos de rota est�o inclu�dos no Laravel: web.php, api.php, console.php and channels.php.
Storage -cont�m seus modelos Blade compilados, sess�es baseadas em arquivo, caches de arquivos e outros arquivos gerados pela estrutura.
Tests - cont�m seus testes automatizados.
Vendor - cont�m suas depend�ncias do Composer.

Hello World

Para darmos o primeiro Hello World com Laravel precisamos abrir a pasta do projeto num editor de c�digo, que no caso ser� o Visual Studio Code. Com o terminal aberto na pasta do projeto podemos digitar o comando:

code .

C�digo 3: Comando para abrir o projeto no VS Code

Abaixo na Figura 5 vemos o projeto aberto no Visual Studio Code.

Figura 6. Projeto aberto no Visual Studio Code

Com o projeto aberto vamos editar o arquivo web.php na pasta routes. Este arquivo cont�m uma rota do projeto, que responde no endereço localhost:8000/, perceba na C�digo 4 que informamos apenas a / como nome da rota. Estudaremos sobre rotas mais a frente. Veja a estrutura de uma rota abaixo:

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

C�digo 4: Arquivo web.php

Na linha 1 o Routes:: � parte inicial para se criar uma rota.
get � verbo HTTP definido para esta rota.
/ � rota que iremos acessar, que refere se a raiz do sitema, localhost:8000.
funcion () � declaraç�o de uma funç�o an�nima.
Na linha 2 return ir� retornar view('welcome') quando a rota for acessada.
view('welcome') � uma view que esta referenciando o arquivo welcome.blade.php na pasta resources/view. Quando a rota for acessada seu conte�do ser� exibido, que � mostrado na figura 2

Verbos HTTP

Na definiç�o de uma rota poderemos utilizar outros verbos HTTP al�m do GET usado no c�digo acima. Toda solicitaç�o HTTP possui um verbo, o Laravel permite definir suas rotas com base em qual verbo foi usado. Veja abaixo os mais comuns utilizados:

GET - solicita a representaç�o de um recurso espec�fico. Requisiç�es utilizando o m�todo GET devem retornar apenas dados.
POST - � utilizado para submeter uma entidade a um recurso espec�fico, frequentemente causando uma mudança no estado do recurso ou efeitos colaterais no servidor.
PUT - substitui todas as atuais representaç�es do recurso de destino pela carga de dados da requisiç�o.
DELETE - remove um recurso espec�fico.
PATCH - � utilizado para aplicar modificaç�es parciais em um recurso.

Funç�es an�nimas

Uma funç�o an�nima � qualquer funç�o que n�o possui ou n�o precise de um nome identificador, estas funç�es podem ser definidas em qualquer lugar e normalmente s�o atribu�das a uma vari�vel e/ou utilizadas como callback.

Vamos alterar as informaç�es do c�digo para exibir na tela nosso primeiro Hello World:

Route::get('/', function () {
    return 'Hello World com Laravel';
});

C�digo 5: Alteraç�o do arquivo web.php

Na linha 1 � mantida a mesma estrutura, sem alteraç�es.
Na linha 2 view('welcome') � removido e substituido por 'Hello World com Laravel' um texto simples.
Feita a modificaç�o, quando acessarmos o caminho http://127.0.0.1:8000/ o texto escrito acima ser� retornado no navegador.

Figura 7. Hello World com Laravel

E assim executamos nosso primeiro Hello World com o framework Laravel. Concluimos que com poucas linhas de c�digo podemos facilmente utiliza-lo. Desta forma a curva de aprendizado do framework se torna menor.

Laravel: Criando um Hello World

Laravel é um Framework PHP utilizado no desenvolvimento web, que tem como principal característica ajudar a desenvolver aplicações seguras e performáticas de forma rápida.