ubuntu.md

Tutorial de instalação do Laravel no Ubuntu 18.04

Sobre o Laravel

O Laravel é uma Framework web contruída em PHP para criação de sites com o Padrão MVC.

Nossa instalação será da versão 5.8, que é a mais recente no momento da criação deste tutorial.

Para que o Laravel funcione, é preciso instalar o PHP, algumas libs adicionais e um banco de dados (que, pela faciliadade de uso e popularidade, escolhi utilizar MySQL).

Não irei instalar o Apache para desenvolvimento, pois o PHP contém um servidor web básico já pronto para utilizarmos :)

PHP

Primeiro, instalamos o PHP.

$ sudo apt update
$ sudo apt install php -y

Depois, instalamos as libs adicionais que o Laravel precisa.

$ sudo apt install php-mbstring php-tokenizer php-xml php-json php-bcmath php-mysql -y

Composer

O Composer é quem cuida de instalar e atualizar as dependências do nosso projeto, tanto as do próprio Laravel quanto de pacotes que viermos a precisar no decorer do desenvolvimento do projeto.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

Depois de baixar e instalar, vamos colocar o Composer para ser usado de forma global.

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

Agora sim, vamos baixar o Laravel

Escolha uma pasta de sua preferência para baixar os arquivos. Pode ser na pasta pessoal do seu Ubuntu, por exemplo.

O último parâmetro do comando abaixo é o nome do projeto, e você pode colocar o nome que achar melhor. No exemplo, estou usando o nome meu_primeiro_laravel.

cd ~
composer create-project --prefer-dist laravel/laravel meu_primeiro_laravel

Após a conclusão do donwload, navegue até a pasta do projeto - meu_primeiro_laravel, neste tutorial - e execute o comando abaixo. Se tudo deu certo, deverá aparecer o versão do Laravel que acabamos usar.

cd meu_primeiro_laravel
php artisan --version

Agora, vamos iniciar o servidor web para executar o projeto e o tornar acessível pelo browser.

php artisan serve

Esse comando mostra o link de acesso à execução do projeto, que, neste caso, é http://localhost:8000.

Mais Recursos, MySQL e Node/NPM

A instalação do Laravel já está pronta. Porém, não está se comunicando com nenhum banco de dados. Projetos Web normalmente utilizam uma base de dados. O Laravel dá suporte à várias soluções de banco (como MySQL, Postgres, SQLite, entre diversos outros), mas, pela simplicidade e popularidade, vamos instalar o MySQL.

MySQL

sudo apt install mysql-server

O próximo comando será para configurar a senha root do mysql e outras configurações de segurança.

sudo mysql_secure_installation

Não estamos configurando a conexão do Laravel ao banco de dados. Depois que você criar uma base de dados, login e senha no MySQL, você deve configurar o acesso à ela editando as credenciais de conexão no arquivo .env, que está na raiz do projeto Laravel.

NPM

Com o Node e o NPM, podemos compilar o CSS, JS, SASS e Vue e/ou outras dependencias Front-end do projeto. Na documentação do Laravel https://laravel.com/docs/5.8/frontend, você encontrará mais informações de como usar esses recursos.

Os comandos para instalação do Node e do NPM são estes:

sudo apt install nodejs -y
sudo apt install npm -y

Depois, podemos conferir a instalação com estes comandos:

nodejs -v
npm -v

Considerações finais

Esta instalação deixa seu sistema com o Laravel funcionando. Para produção, você deverá instalar um servidor Web completo, como o Apache ou o Nginx.

É possível configurar todo o ambiente de produção localmente com a utilização do Docker, mas isso fica pra outro momento.