Requisitos do Sistema
Para começar a usar o Laravel, é importante garantir que seu ambiente de desenvolvimento atenda aos requisitos mínimos. Estes incluem:
PHP: Versão 8.0 ou superior
Extensões PHP: OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON, BCMath
Composer: Gerenciador de dependências para PHP
Instalando o Laravel via Composer
Composer é a ferramenta padrão para gerenciar dependências no PHP. Primeiro, você precisa instalar o Composer, se ainda não o fez. Para instalar o Laravel, siga os passos abaixo:
Instalando o Composer:
No terminal, execute o seguinte comando para instalar o Composer:
curl -sShttps://getcomposer.org/installer| php sudo mv composer.phar /usr/local/bin/composer
Criando um Projeto Laravel:
Use o Composer para criar um novo projeto Laravel. No terminal, execute:
composer create-project --prefer-dist laravel/laravel nome-do-projeto
Substitua
nome-do-projeto
pelo nome desejado para seu projeto.Estrutura de Diretórios do Laravel
Uma vez que o Laravel esteja instalado, você verá uma estrutura de diretórios semelhante à seguinte:
nome-do-projeto/ ├── app/ ├── bootstrap/ ├── config/ ├── database/ ├── public/ ├── resources/ ├── routes/ ├── storage/ ├── tests/ ├── vendor/ ├── .env ├── artisan ├── composer.json ├── package.json └── webpack.mix.js
app/: Contém os modelos, controladores e outros arquivos principais da aplicação.
bootstrap/: Contém os arquivos necessários para iniciar o framework.
config/: Contém todos os arquivos de configuração da aplicação.
database/: Contém migrações, seeders e o arquivo de banco de dados SQLite.
public/: Contém o ponto de entrada da aplicação (index.php) e ativos públicos como CSS, JavaScript e imagens.
resources/: Contém views Blade, arquivos de idioma e outros recursos.
routes/: Contém arquivos de definição de rotas.
storage/: Contém logs, arquivos de cache e outros arquivos gerados pela aplicação.
tests/: Contém os testes automatizados da aplicação.
vendor/: Contém as dependências instaladas via Composer.
Configurações Básicas do Ambiente
Laravel utiliza um arquivo .env
para gerenciar as configurações do ambiente. Após a instalação, um arquivo .env.example
estará disponível na raiz do projeto. Você pode copiá-lo e renomeá-lo para .env
:
cp .env.example .env
Abra o arquivo .env
e configure os detalhes do ambiente. As principais configurações incluem:
APP_NAME: Nome da aplicação.
APP_ENV: Ambiente da aplicação (local, production, etc.).
APP_KEY: Chave de criptografia da aplicação (gerada automaticamente).
APP_DEBUG: Modo debug (true/false).
APP_URL: URL base da aplicação.
DB_CONNECTION: Tipo de conexão do banco de dados (mysql, sqlite, etc.).
DB_HOST: Host do banco de dados.
DB_PORT: Porta do banco de dados.
DB_DATABASE: Nome do banco de dados.
DB_USERNAME: Usuário do banco de dados.
DB_PASSWORD: Senha do banco de dados.
Gerando a Chave da Aplicação
Depois de configurar o arquivo .env
, você precisa gerar a chave da aplicação. Esta chave é usada pelo Laravel para criptografar dados:
php artisan key:generate
Configuração do Servidor de Desenvolvimento
Laravel inclui um servidor de desenvolvimento embutido que pode ser iniciado com o Artisan CLI. Para iniciar o servidor, execute:
php artisan serve
O comando acima iniciará o servidor em http://localhost:8000
. Você pode acessar essa URL em seu navegador para verificar se a instalação foi bem-sucedida.
Instalação com Docker usando Sail
Conclusão
Após seguir estes passos, você terá o Laravel instalado e configurado, pronto para começar o desenvolvimento da sua aplicação. Nos próximos tópicos, exploraremos em detalhes como criar rotas, controladores, views e muito mais, aprofundando-se nas funcionalidades do Laravel para construir aplicações web robustas e escaláveis.