Como Instalar o Laravel no Debian 12

Laravel é um framework de aplicação web baseado em PHP para construir aplicações web empresariais. É um framework web gratuito e aberto que segue a arquitetura de modelo-visão-controlador (MVC) e é baseado no Symfony. Ele fornece uma sintaxe elegante que permite criar aplicações com código limpo e é fácil de ler e entender.

Laravel é um framework web de nível empresarial para construir aplicações web robustas e completas. As aplicações Laravel podem ser entregues rapidamente sem dores de cabeça, desde o processo de desenvolvimento até a produção.

Combinar o framework web Laravel com outro framework como React ou Vue permite criar um frontend bonito e interativo. Além disso, ele suporta múltiplos bancos de dados, incluindo MySQL, PostgreSQL, SQLite e SQL Server. O Laravel também fornece scaffolding para autenticação segura.

Neste guia, vamos mostrar como instalar o Laravel passo a passo no Debian 12, para que você possa começar com o projeto Laravel. Vamos mostrar como instalar o Laravel com o servidor web Apache2, MariaDB e PHP 8.2.

Pré-requisitos

Abaixo estão os requisitos que você precisa seguir para este guia:

• Um servidor Debian 12.
• Um usuário não-root com privilégios de administrador.

Instalando o LAMP Stack

O primeiro passo que você precisa fazer é instalar o LAMP Stack (Apache2, MariaDB e PHP) no seu servidor Debian. Em seguida, você também verificará os serviços do Apache2 e do MariaDB para garantir que o serviço esteja em execução.

Antes de instalar os pacotes, execute o comando apt update para atualizar e refrescar os repositórios do Debian.

sudo apt update

Uma vez que o repositório esteja atualizado, instale os pacotes do LAMP Stack (Apache2, PHP e MariaDB) executando o comando apt install abaixo. O seguinte comando também instala algumas das extensões PHP que são necessárias pelo Laravel.

sudo apt install apache2 php php-curl php-bcmath php-json php-mysql php-mbstring php-xml php-tokenizer php-zip mariadb-server

Digite y para confirmar e prosseguir com a instalação.

Com o LAMP Stack instalado, execute o comando systemctl abaixo para verificar os serviços do apache2 e do mariadb. Se o serviço estiver em execução, você deve obter a saída active (running).

sudo systemctl status apache2  
sudo systemctl status mariadb

Para o serviço apache2, você deve obter uma saída como esta:

E abaixo está o status do serviço mariadb.

Em seguida, execute o comando php abaixo para verificar a versão do PHP e os módulos habilitados no PHP. Você deve ver PHP 8.2 instalado com alguns módulos habilitados, como curl, date, dom e exif.

php -v  
php -m

Por fim, abra seu navegador e visite o endereço IP do seu servidor Debian (ou seja: http://192.168.10.15/). Se a instalação for bem-sucedida, você deve obter a página index.html do servidor web Apache.

Configurando o PHP

Para instalar o Laravel, há algumas extensões PHP que você deve habilitar, como fileinfo, mbstring e openssl. Você pode habilitar essas extensões através do arquivo php.ini.

Use o seguinte comando do editor nano para abrir o arquivo de configuração do PHP /etc/php/8.2/apache2/php.ini.

sudo nano /etc/php/8.2/apache2/php.ini

Descomente as seguintes linhas para habilitar as extensões fileinfo, mbstring e openssl.

extension=fileinfo  
extension=mbstring  
extension=openssl

Quando terminar, salve o arquivo e saia do editor.

Em seguida, execute o seguinte comando systemctl para reiniciar o serviço apache2 e aplicar as alterações.

sudo systemctl restart apache2

Então, certifique-se de que as extensões PHP fileinfo, mbstring e openssl estão habilitadas executando o comando php abaixo.

sudo php -m

Agora crie um novo arquivo phpinfo /var/www/html/info.php usando o comando abaixo. Se sua instalação do PHP e do servidor web Apache2 for bem-sucedida, isso mostrará informações detalhadas sobre sua instalação do PHP.

echo "" > /var/www/html/info.php

Abra seu navegador preferido e visite o endereço IP do servidor seguido do caminho do arquivo info.php (ou seja: http://192.168.10.15/info.php). Se for bem-sucedido, você deve ver uma saída como esta:

Configurando o Servidor MariaDB

Após configurar o PHP, você configurará seu servidor MariaDB, que inclui proteger o servidor MariaDB através da ferramenta mariadb-secure-installation, e então criar um novo banco de dados e usuário para seu projeto Laravel.

Primeiro, execute o comando mariadb-secure-installation abaixo para proteger sua instalação do servidor MariaDB. Durante o processo, você será solicitado a algumas configurações do MariaDB, digite Y para confirmar a configuração ou n para Não.

sudo mariadb-secure-installation

Abaixo estão algumas das configurações do MariaDB que você será perguntado durante o processo:

• Pressione ENTER quando solicitado pela senha root do MariaDB.
• Digite n quando perguntado sobre o método de autenticação unix_socket.
• Digite Y para configurar uma nova senha para o usuário root do MariaDB. Em seguida, digite a nova senha e repita.
• Digite Y para remover o usuário anônimo padrão do MariaDB.
• Em seguida, digite Y novamente para desabilitar o login remoto para o usuário root do MariaDB.
• Digite Y para remover o banco de dados de teste padrão do MariaDB.
• Por fim, digite Y novamente para recarregar os privilégios da tabela e aplicar as alterações.

Após configurar o servidor MariaDB, você precisa criar um novo banco de dados e usuário para seu projeto Laravel.

Faça login no servidor MariaDB através do comando mariadb abaixo. Digite sua senha do MariaDB quando solicitado.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados testapp, o usuário testapp e a senha password. Certifique-se de mudar a senha na consulta a seguir.

CREATE DATABASE testapp;  
CREATE USER testapp@localhost IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON testapp.* TO testapp@localhost;  
FLUSH PRIVILEGES;

Em seguida, execute a consulta abaixo para garantir que o usuário testapp pode acessar o banco de dados testapp.

SHOW GRANTS FOR testapp@localhost;

A saída abaixo confirma que o usuário testapp pode acessar o banco de dados testapp.

Por fim, digite quit para sair do servidor MariaDB e completar esta etapa.

Instalando o Composer

O Laravel pode ser instalado de várias maneiras, e a mais fácil é instalá-lo via Composer, o gerenciador de pacotes PHP. Agora, você instalará o Composer no seu servidor Debian.

Para instalar o gerenciador de pacotes PHP Composer, execute o comando apt install abaixo. Digite y quando solicitado para prosseguir com a instalação.

sudo apt install composer

Após a instalação ser concluída, execute o seguinte comando para localizar o arquivo binário do composer e verificar a versão do composer.

which composer  
sudo -u www-data composer --version

O arquivo binário do composer está localizado em /usr/bin/composer e o composer 2.5.5 está instalado.

Criando o Primeiro Projeto Laravel

Com tudo em ordem, você está pronto para instalar e criar o primeiro projeto Laravel. Você criará o primeiro projeto Laravel com o MariaDB como banco de dados.

Primeiro, crie um novo diretório de raiz de documento /var/www/testapp para seu projeto e mude a propriedade para o usuário www-data através do comando abaixo. Você também criará os diretórios /var/www/.cache e /var/www/.config que serão usados pelo Composer.

sudo mkdir -p /var/www/{.cache,.config,testapp}  
sudo chown -R www-data:www-data /var/www/{.cache,.config,testapp}

Agora mude para o diretório /var/www/testapp/ e execute o comando composer abaixo para criar o primeiro projeto Laravel. Seu primeiro projeto Laravel é armazenado no diretório /var/www/testapp/.

cd /var/www/testapp/  
sudo -u www-data composer create-project laravel/laravel .

Durante a instalação, você deve obter uma saída semelhante a esta:

Com o projeto Laravel criado, a próxima etapa é configurar o banco de dados para seu projeto através do arquivo de configuração .env. O arquivo .env é usado como a configuração base para seu projeto Laravel.

Use o seguinte comando do editor nano para abrir o arquivo .env.

nano .env

Altere o parâmetro APP_URL com o nome de domínio local do seu projeto Laravel. Desta forma, você pode acessar seu projeto através de um nome de domínio local. Neste caso, o nome de domínio é testapp.local.

APP_URL=http://testapp.local

Agora altere a configuração do banco de dados DB_CONNECTION para mysql e mude os detalhes de DB_DATABASE, DB_USERNAME e DB_PASSWORD com os detalhes do seu banco de dados e usuário MariaDB.

DB_CONNECTION=mysql  
DB_HOST=127.0.0.1  
DB_PORT=3306  
DB_DATABASE=testapp  
DB_USERNAME=testapp  
DB_PASSWORD=password

Quando terminar, salve o arquivo e saia do editor.

Agora execute o seguinte comando para migrar o banco de dados. Isso criará tabelas para o projeto Laravel.

sudo -u www-data php artisan migrate

Configurando o Host Virtual do Apache

Na próxima etapa, você criará uma nova configuração de host virtual do Apache2 para seu projeto Laravel. Depois disso, você deve ativar o host virtual e verificar as configurações do Apache2, e então reiniciar o servidor web Apache2 para que as alterações tenham efeito.

Antes de criar a configuração de host virtual do Apache2 para o Laravel, você deve habilitar o módulo rewrite no Apache2 através do comando abaixo.

sudo a2enmod rewrite

Use o seguinte comando do editor nano para criar a configuração do host virtual do Apache2 /etc/apache2/sites-available/laravel.conf.

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

Insira a seguinte configuração e altere o parâmetro ServerName com seu nome de domínio.

  
  
    ServerAdmin [email protected]  
    ServerName testapp.local  
    DocumentRoot /var/www/testapp/public  
  
      
            Options FollowSymLinks  
            AllowOverride None  
      
      
            AllowOverride All  
      
  
    ErrorLog ${APACHE_LOG_DIR}/error.log  
    CustomLog ${APACHE_LOG_DIR}/access.log combined  
  

Quando terminar, salve o arquivo e saia do editor.

Em seguida, execute o seguinte comando para ativar a configuração do host virtual laravel.conf e verificar as configurações do Apache2. Se você tiver configurações corretas, deve obter a mensagem como Syntax OK.

sudo a2ensite laravel.conf  
sudo apachectl configtest

Por fim, reinicie o serviço apache2 executando o comando abaixo e aplicando as alterações que você fez.

sudo systemctl restart apache2

Acessando o Laravel

Se você estiver em um cliente Linux, modifique o arquivo /etc/hosts através do comando do editor nano abaixo.

sudo nano /etc/hosts

Se você estiver em uma máquina Windows, modifique o arquivo C:\Windows\System32\drivers\etc\hosts.

Insira o nome de domínio do seu projeto Laravel e o endereço IP do seu servidor Debian assim:

192.168.10.15   testapp.local

Salve o arquivo e saia do editor.

Por fim, abra seu navegador e visite o nome de domínio local do seu projeto Laravel (ou seja: http://testapp.local). Se for bem-sucedido, você deve obter uma página semelhante ao Laravel como esta:

Conclusão

Em conclusão, você instalou o Laravel com o LAMP Stack (Apache2, MariaDB e PHP) no servidor Debian 12. Você também instalou o Composer, o gerenciador de pacotes PHP, e o usou como o meio de instalação para o Laravel. Com isso em mente, você pode agora desenvolver sua aplicação usando o framework web Laravel e o MariaDB como banco de dados para suas aplicações.