Instalando o Framework PHP Laravel no Ubuntu 16.04 para Apache

Laravel é um framework PHP de código aberto muito popular, voltado para o desenvolvimento fácil de aplicações. Se você está procurando um novo framework PHP para experimentar, deve dar uma chance ao Laravel.

O seguinte guia mostrará como instalar e executar o Laravel em um servidor Apache baseado no Ubuntu 16.04 LTS. Este tutorial também funciona para o Ubuntu 17.x, mas para servidores você deve preferir usar uma versão LTS do Ubuntu, como o atual Ubuntu 16.04 LTS.

Pré-Requisitos

Antes de prosseguir com a instalação, é sempre uma boa ideia garantir que suas fontes e software existente estejam atualizados.

sudo apt-get update   
sudo apt-get upgrade

Para este guia, assumiremos que você tem um servidor básico baseado no Ubuntu em execução. Antes do Laravel, precisamos instalar outros componentes que são essenciais.

Instalando PHP 7.1

O próximo passo é instalar o PHP junto com vários pacotes extras que seriam úteis se você for trabalhar com o Laravel.

sudo add-apt-repository ppa:ondrej/php  
sudo apt-get update  
sudo apt-get install php7.1 php7.1-mcrypt php7.1-xml php7.1-gd php7.1-opcache php7.1-mbstring

Embora o repositório próprio do Ubuntu tenha PHP, é melhor adicionar um repositório de terceiros aqui, pois ele é atualizado com mais frequência. Você pode pular essa etapa e ficar com a versão do Ubuntu se preferir.

Instalando o Apache

Agora é hora de instalar o servidor Apache. Também precisamos instalar o pacote libapache2-mod-php7.1 para conectar o Apache ao PHP.

sudo apt-get install apache2 libapache2-mod-php7.1

Instalando o Laravel

Antes de finalmente mergulharmos nisso, também precisamos que o controle de versão Git esteja instalado. Se você já o tem instalado, pode pular a próxima etapa. Se não tiver, você pode seguir nosso guia para configurá-lo primeiro.

Para instalar o Laravel, precisamos instalar o Composer primeiro. É uma ferramenta para gerenciamento de dependências em PHP que permite empacotar todas as bibliotecas necessárias associadas a um pacote como um só. Para instalar o Laravel e todas as suas dependências, o Composer é necessário. Ele fará o download e instalará tudo o que é necessário para executar o framework Laravel. Para instalar o Composer, emita os seguintes comandos.

cd /tmp  
curl -sS https://getcomposer.org/installer | php  
sudo mv composer.phar /usr/local/bin/composer

O comando curl baixa o pacote composer.phar para o seu diretório /tmp. Mas queremos que o composer seja executado globalmente, portanto, precisamos movê-lo para o diretório /usr/local/bin com o nome ‘composer’. Agora podemos executar o composer de qualquer lugar.

Para instalar o Laravel, vá para o diretório html público em seu sistema. Como estamos no Ubuntu e usando o Apache, instalaremos no diretório /var/www/html.

cd /var/www/html  
sudo composer create-project laravel/laravel seu-projeto --prefer-dist

O comando acima criará um diretório “ seu-projeto “ com a instalação do Laravel nele. O Composer usa o git para baixar e instalar todos os pacotes e módulos que o Laravel requer para funcionar.

Configurando o Apache

Agora que instalamos o Laravel, passamos para a etapa de configuração do servidor web Apache.

O próximo passo é dar permissões adequadas ao diretório do projeto. Para isso, precisamos habilitar o acesso a ele do grupo www-data e dar permissões de escrita ao diretório de armazenamento.

sudo chgrp -R www-data /var/www/html/seu-projeto  
sudo chmod -R 775 /var/www/html/seu-projeto/storage

Agora vá para o diretório /etc/apache2/sites-available e use o seguinte comando para criar um arquivo de configuração para nossa instalação do laravel.

cd /etc/apache2/sites-available  
sudo nano laravel.conf

Agora adicione o seguinte conteúdo ao arquivo e feche-o após salvar. Substitua seu-dominio.tld pelo nome de domínio do seu site dentro do arquivo.

  
    ServerName seu-dominio.tld  
    ServerAdmin webmaster@localhost  
    DocumentRoot /var/www/html/seu-projeto/public  
      
        AllowOverride All  
      
    ErrorLog ${APACHE_LOG_DIR}/error.log  
    CustomLog ${APACHE_LOG_DIR}/access.log combined  

Agora precisamos habilitar este novo arquivo .conf criado e desabilitar o arquivo .conf padrão que é instalado com a instalação padrão do Apache. Além disso, precisamos habilitar o mod_rewrite para que os links permanentes funcionem corretamente.

sudo a2dissite 000-default.conf  
sudo a2ensite laravel.conf  
sudo a2enmod rewrite  
sudo service apache2 restart

Sua instalação do Laravel agora está completa. Visite o endereço IP ou nome de domínio do seu servidor com um navegador da web (no meu caso http://192.168.1.100). Você verá a página padrão do Laravel.

Download da máquina virtual deste tutorial

Este tutorial está disponível como uma imagem de máquina virtual pronta para uso no formato ovf/ova, que é compatível com VMWare e Virtualbox. A imagem da máquina virtual usa os seguintes detalhes de login:

Login SSH / Shell

Nome de usuário: administrator
Senha: howtoforge

Para se tornar o usuário root, execute: sudo -s
Senha: howtoforge

O IP da VM é 192.168.1.100, ele pode ser alterado no arquivo /etc/network/interfaces. Por favor, altere todas as senhas acima para proteger a máquina virtual.