Instalar o Framework Laravel no Debian 11

Laravel é um framework web PHP gratuito e de código aberto baseado no framework Symfony. É usado para o desenvolvimento mais rápido de aplicações web. O Laravel facilita a realização de algumas tarefas comuns, como autenticação, roteamento, sessões e cache. Ele possui vários recursos úteis, incluindo Artisan, Mapeamento objeto-relacional, Motor de template, Arquitetura MVC, Testes unitários e Sistema de migração de banco de dados.

Neste tutorial, vou mostrar como instalar o Laravel no Debian 11.

Pré-requisitos

Um servidor rodando Debian 11.
Um nome de domínio válido apontado para o IP do seu servidor.
Uma senha de root configurada no servidor.

Instalar o Servidor Web Apache

Primeiro, você precisará instalar o pacote Apache no seu servidor. Você pode instalá-lo usando o seguinte comando:

apt-get install apache2 -y

Uma vez que o pacote Apache esteja instalado, verifique a versão do Apache usando o seguinte comando:

apache2ctl -v

Você deve ver a seguinte saída:

Server version: Apache/2.4.48 (Debian)
Server built:   2021-08-12T11:51:47

Instalar PHP e Outras Extensões Necessárias

Em seguida, você precisará instalar o PHP e outras extensões necessárias para a aplicação Laravel. Primeiro, instale as dependências necessárias usando o seguinte comando:

apt-get install apt-transport-https gnupg2 ca-certificates -y

Em seguida, adicione a chave GPG e o repositório PHP com o seguinte comando:

wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg  
sh -c 'echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'

Em seguida, atualize o repositório e instale o PHP com outras extensões usando o seguinte comando:

apt-get update -y  
apt-get install libapache2-mod-php php php-common php-xml php-gd php8.0-opcache php-mbstring php-tokenizer php-json php-bcmath php-zip unzip curl -y

Uma vez que o PHP esteja instalado, edite o arquivo php.ini e faça algumas alterações:

nano /etc/php/8.0/apache2/php.ini

Altere as seguintes linhas:

cgi.fix_pathinfo=0 
date.timezone = Asia/Kolkata

Salve e feche o arquivo, então verifique a versão do PHP usando o seguinte comando:

php -v

Saída de exemplo:

PHP 8.0.10 (cli) (built: Aug 26 2021 16:06:19) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.10, Copyright (c) Zend Technologies
    with Zend OPcache v8.0.10, Copyright (c), by Zend Technologies

Instalar o Composer

Em seguida, você precisará instalar o Composer no seu sistema. Você pode instalá-lo usando o seguinte comando:

curl -sS https://getcomposer.org/installer | php

Saída de exemplo:

All settings correct for using Composer
Downloading...

Composer (version 2.1.6) successfully installed to: /root/composer.phar
Use it: php composer.phar

Em seguida, mova o binário do Composer para o caminho do sistema usando o seguinte comando:

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

Em seguida, verifique a versão do Composer com o seguinte comando:

composer --version

Você deve ver a seguinte saída:

Composer version 2.1.6 2021-08-19 17:11:08

Instalar o Laravel

Em seguida, mude o diretório para o webroot do Apache e baixe a versão mais recente do Laravel usando o Composer:

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

Você deve obter a seguinte saída:

> @php artisan package:discover --ansi
Discovered Package: facade/ignition
Discovered Package: fruitcake/laravel-cors
Discovered Package: laravel/sail
Discovered Package: laravel/sanctum
Discovered Package: laravel/tinker
Discovered Package: nesbot/carbon
Discovered Package: nunomaduro/collision
Package manifest generated successfully.
76 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
> @php artisan vendor:publish --tag=laravel-assets --ansi
No publishable resources for tag [laravel-assets].
Publishing complete.
> @php artisan key:generate --ansi
Application key set successfully.

Em seguida, defina as permissões e a propriedade adequadas para o diretório Laravel com o seguinte comando:

chown -R www-data:www-data /var/www/html/laravel  
chmod -R 775 /var/www/html/laravel

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Configurar o Apache para o Laravel

Em seguida, você precisará criar um arquivo de configuração de host virtual do Apache para o Laravel. Você pode criá-lo com o seguinte comando:

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

Adicione as seguintes linhas:


    ServerName laravel.example.com

    ServerAdmin [email protected]
    DocumentRoot /var/www/html/laravel/public

    
    Options Indexes MultiViews
    AllowOverride None
    Require all granted
    

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

Salve e feche o arquivo, então ative o host virtual do Apache e o módulo de reescrita com o seguinte comando:

a2enmod rewrite  
a2ensite laravel.conf

Finalmente, reinicie o serviço Apache para aplicar as alterações:

systemctl restart apache2

Você também pode verificar o status do Apache com o seguinte comando:

systemctl status apache2

Você deve obter a seguinte saída:

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2021-08-27 06:00:25 UTC; 7s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 14020 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
   Main PID: 14025 (apache2)
      Tasks: 6 (limit: 2341)
     Memory: 13.2M
        CPU: 97ms
     CGroup: /system.slice/apache2.service
             ??14025 /usr/sbin/apache2 -k start
             ??14026 /usr/sbin/apache2 -k start
             ??14027 /usr/sbin/apache2 -k start
             ??14028 /usr/sbin/apache2 -k start
             ??14029 /usr/sbin/apache2 -k start
             ??14030 /usr/sbin/apache2 -k start

Aug 27 06:00:25 debian11 systemd[1]: Starting The Apache HTTP Server...

Acessar o Laravel

Agora, abra seu navegador e acesse a interface web do Laravel usando a URL http://laravel.example.com. Você deve ver a página padrão do Laravel na tela a seguir:

Laravel no Debian 11

Conclusão

Parabéns! você instalou com sucesso o Laravel com Apache no Debian 11. Agora você pode começar a desenvolver sua aplicação usando o framework Laravel. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.