Como Instalar o Laravel

Conheça o Laravel
Laravel é um framework de aplicação web com sintaxe expressiva e elegante. Uma estrutura da web fornece uma estrutura e um ponto de partida para a criação de seu aplicativo, permitindo que você se concentre na criação de algo incrível enquanto suamos nos detalhes.
O Laravel se esforça para fornecer uma experiência de desenvolvedor incrível, enquanto fornece recursos poderosos como injeção de dependência completa, uma camada de abstração de banco de dados expressiva, filas e trabalhos agendados, testes de unidade e integração e muito mais.
Quer você seja novo em PHP ou frameworks web, ou tenha anos de experiência, o Laravel é um framework que pode crescer com você. Vamos ajudá-lo a dar os primeiros passos como desenvolvedor da web ou dar-lhe um impulso conforme você leva sua experiência para o próximo nível. Mal podemos esperar para ver o que você constrói.
Por que Laravel?
Há uma variedade de ferramentas e estruturas disponíveis para você ao construir um aplicativo da web. No entanto, acreditamos que o Laravel é a melhor escolha para construir aplicativos da web modernos e completos.
Uma estrutura progressiva
Gostamos de chamar o Laravel de framework “progressivo”. Com isso, queremos dizer que o Laravel cresce com você. Se você está apenas dando os primeiros passos no desenvolvimento web, a vasta biblioteca de documentação, guias e tutoriais em vídeo do Laravel o ajudará a aprender o básico sem ficar sobrecarregado.
Se você é um desenvolvedor sênior, o Laravel oferece ferramentas robustas para injeção de dependência , teste de unidade , filas , eventos em tempo real e muito mais. Laravel é ajustado para construir aplicações web profissionais e pronto para lidar com cargas de trabalho corporativas.
Uma Estrutura Escalável
O Laravel é incrivelmente escalonável. Graças à natureza amigável de escalonamento do PHP e ao suporte embutido do Laravel para sistemas de cache rápido e distribuído como o Redis, escalar horizontalmente com o Laravel é uma brisa. Na verdade, os aplicativos Laravel foram facilmente dimensionados para lidar com centenas de milhões de solicitações por mês.
Precisa de escalonamento extremo? Plataformas como o Laravel Vapor permitem que você execute seu aplicativo Laravel em escala quase ilimitada na mais recente tecnologia sem servidor da AWS.
Uma Estrutura da Comunidade
O Laravel combina os melhores pacotes do ecossistema PHP para oferecer o framework mais robusto e amigável disponível para o desenvolvedor. Além disso, milhares de desenvolvedores talentosos de todo o mundo contribuíram para a estrutura . Quem sabe, talvez você até se torne um contribuidor do Laravel.
Seu primeiro projeto Laravel
Queremos que seja o mais fácil possível para começar a usar o Laravel. Há uma variedade de opções para desenvolver e executar um projeto Laravel em seu próprio computador. Embora você possa desejar explorar essas opções posteriormente, o Laravel fornece o Sail , uma solução embutida para executar seu projeto Laravel usando o Docker .
O Docker é uma ferramenta para executar aplicativos e serviços em “contêineres” pequenos e leves que não interferem na configuração ou no software instalado em seu computador local. Isso significa que você não precisa se preocupar em configurar ou definir ferramentas de desenvolvimento complicadas, como servidores da web e bancos de dados em seu computador pessoal. Para começar, você só precisa instalar o Docker Desktop .
Laravel Sail é uma interface de linha de comando leve para interagir com a configuração padrão do Docker do Laravel. O Sail fornece um ótimo ponto de partida para construir um aplicativo Laravel usando PHP, MySQL e Redis sem a necessidade de experiência anterior com Docker.
Já é um especialista do Docker? Não se preocupe! Tudo sobre o Sail pode ser personalizado usando o
docker-compose.yml
arquivo incluído no Laravel.
Primeiros passos no macOS
Se você estiver desenvolvendo em um Mac e o Docker Desktop já estiver instalado, você pode usar um comando de terminal simples para criar um novo projeto Laravel. Por exemplo, para criar um novo aplicativo Laravel em um diretório chamado “example-app”, você pode executar o seguinte comando em seu terminal:
curl -s "https://laravel.build/example-app" | bash
Claro, você pode alterar “example-app” neste URL para o que quiser. O diretório do aplicativo Laravel será criado dentro do diretório a partir do qual você executa o comando.
Após a criação do projeto, você pode navegar até o diretório do aplicativo e iniciar o Laravel Sail. O Laravel Sail fornece uma interface de linha de comando simples para interagir com a configuração padrão do Docker do Laravel:
cd example-app
./vendor/bin/sail up
Na primeira vez que você executa o up
comando Sail , os contêineres de aplicativos do Sail serão construídos em sua máquina. Isso pode levar vários minutos. Não se preocupe, as tentativas subsequentes de iniciar o Sail serão muito mais rápidas.
Depois que os contêineres do Docker do aplicativo forem iniciados, você pode acessar o aplicativo em seu navegador da web em: http://localhost .
Para continuar aprendendo mais sobre o Laravel Sail, revise sua documentação completa .
Primeiros passos no Windows
Antes de criarmos um novo aplicativo Laravel em sua máquina Windows, certifique-se de instalar o Docker Desktop . Em seguida, você deve garantir que o Subsistema Windows para Linux 2 (WSL2) esteja instalado e ativado. O WSL permite que você execute executáveis binários do Linux nativamente no Windows 10. As informações sobre como instalar e habilitar o WSL2 podem ser encontradas na documentação do ambiente de desenvolvedor da Microsoft .
Depois de instalar e habilitar o WSL2, você deve garantir que o Docker Desktop esteja configurado para usar o back-end WSL2 .
Em seguida, você está pronto para criar seu primeiro projeto Laravel. Inicie o Windows Terminal e comece uma nova sessão de terminal para seu sistema operacional WSL2 Linux. Em seguida, você pode usar um comando de terminal simples para criar um novo projeto Laravel. Por exemplo, para criar um novo aplicativo Laravel em um diretório chamado “example-app”, você pode executar o seguinte comando em seu terminal:
curl -s https://laravel.build/example-app | bash
Claro, você pode alterar “example-app” neste URL para o que quiser. O diretório do aplicativo Laravel será criado dentro do diretório a partir do qual você executa o comando.
Após a criação do projeto, você pode navegar até o diretório do aplicativo e iniciar o Laravel Sail. O Laravel Sail fornece uma interface de linha de comando simples para interagir com a configuração padrão do Docker do Laravel:
cd example-app
./vendor/bin/sail up
Na primeira vez que você executa o up
comando Sail , os contêineres de aplicativos do Sail serão construídos em sua máquina. Isso pode levar vários minutos. Não se preocupe, as tentativas subsequentes de iniciar o Sail serão muito mais rápidas.
Depois que os contêineres do Docker do aplicativo forem iniciados, você pode acessar o aplicativo em seu navegador da web em: http: // localhost .
Para continuar aprendendo mais sobre o Laravel Sail, revise sua documentação completa .
Desenvolvimento dentro da WSL2
Obviamente, você precisará modificar os arquivos do aplicativo Laravel que foram criados na instalação do WSL2. Para fazer isso, recomendamos o uso do editor de código do Visual Studio da Microsoft e sua extensão original para desenvolvimento remoto .
Uma vez que essas ferramentas são instaladas, você pode abrir qualquer projeto Laravel executando o code .
comando do diretório raiz de seu aplicativo usando o Terminal do Windows.
Primeiros passos no Linux
Se você estiver desenvolvendo no Linux e o Docker já estiver instalado, você pode usar um comando de terminal simples para criar um novo projeto Laravel. Por exemplo, para criar um novo aplicativo Laravel em um diretório chamado “example-app”, você pode executar o seguinte comando em seu terminal:
curl -s https://laravel.build/example-app | bash
Claro, você pode alterar “example-app” neste URL para o que quiser. O diretório do aplicativo Laravel será criado dentro do diretório a partir do qual você executa o comando.
Após a criação do projeto, você pode navegar até o diretório do aplicativo e iniciar o Laravel Sail. O Laravel Sail fornece uma interface de linha de comando simples para interagir com a configuração padrão do Docker do Laravel:
cd example-app
./vendor/bin/sail up
Na primeira vez que você executa o up
comando Sail , os contêineres de aplicativos do Sail serão construídos em sua máquina. Isso pode levar vários minutos. Não se preocupe, as tentativas subsequentes de iniciar o Sail serão muito mais rápidas.
Depois que os contêineres do Docker do aplicativo forem iniciados, você pode acessar o aplicativo em seu navegador da web em: http: // localhost .
Para continuar aprendendo mais sobre o Laravel Sail, revise sua documentação completa .
Escolhendo Seus Serviços de Sail
Ao criar um novo aplicativo Laravel via Sail, você pode usar a with
variável query string para escolher quais serviços devem ser configurados no docker-compose.yml
arquivo do seu novo aplicativo . Os serviços disponíveis incluem mysql
, pgsql
, redis
, memcached
, meilisearch
, selenium
, e mailhog
:
curl -s "https://laravel.build/example-app?with=mysql,redis" | bash
Se você não especificar quais serviços você gostaria configurado, uma pilha padrão de mysql
, redis
, meilisearch
, mailhog
, e selenium
será configurado.
Instalação Via Composer
Se o seu computador já tem PHP e Composer instalados, você pode criar um novo projeto Laravel usando o Composer diretamente. Depois que o aplicativo foi criado, você pode iniciar o servidor de desenvolvimento local do Laravel usando o serve
comando Artisan CLI :
composer create-project laravel/laravel example-app
cd example-app
php artisan serve
O instalador do Laravel
Ou você pode instalar o instalador do Laravel como uma dependência global do Composer:
composer global require laravel/installer
laravel new example-app
cd example-app
php artisan serve
Certifique-se de colocar o diretório bin do fornecedor de todo o sistema do Composer em seu $PATH
para que o laravel
executável possa ser localizado por seu sistema. Este diretório existe em diferentes locais com base em seu sistema operacional; no entanto, alguns locais comuns incluem:
- Mac OS:
$HOME/.composer/vendor/bin
- Janelas:
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin
- Distribuições GNU / Linux:
$HOME/.config/composer/vendor/bin
ou$HOME/.composer/vendor/bin
Por conveniência, o instalador do Laravel também pode criar um repositório Git para seu novo projeto. Para indicar que você deseja que um repositório Git seja criado, passe a --git
sinalização ao criar um novo projeto:
laravel new example-app --git
Este comando inicializará um novo repositório Git para o seu projeto e enviará automaticamente o esqueleto básico do Laravel. O git
sinalizador assume que você instalou e configurou corretamente o Git. Você também pode usar o --branch
sinalizador para definir o nome inicial do branch:
laravel new example-app --git --branch="main"
Em vez de usar a --git
sinalização, você também pode usar a --github
sinalização para criar um repositório Git e também criar um repositório privado correspondente no GitHub:
laravel new example-app --github
O repositório criado estará então disponível em https://github.com/<your-account>/my-app.com
. O github
sinalizador pressupõe que você instalou corretamente a gh
ferramenta CLI e está autenticado com o GitHub. Além disso, você deve ter git
instalado e configurado corretamente. Se necessário, você pode passar sinalizadores adicionais compatíveis com a CLI do GitHub:
laravel new example-app --github="--public"
Você pode usar a --organization
sinalização para criar o repositório em uma organização GitHub específica:
laravel new example-app --github="--public" --organization="laravel"
Configuração Inicial
Todos os arquivos de configuração do framework Laravel são armazenados no config
diretório. Cada opção está documentada, portanto, fique à vontade para examinar os arquivos e se familiarizar com as opções disponíveis.
O Laravel quase não precisa de configuração adicional fora da caixa. Você está livre para começar a desenvolver! No entanto, você pode desejar revisar o config/app.php
arquivo e sua documentação. Ele contém várias opções como timezone
e locale
que você pode desejar alterar de acordo com sua aplicação.
Configuração baseada em ambiente
Uma vez que muitos dos valores das opções de configuração do Laravel podem variar dependendo se sua aplicação está rodando em seu computador local ou em um servidor web de produção, muitos valores de configuração importantes são definidos usando o .env
arquivo que existe na raiz de sua aplicação.
Seu .env
arquivo não deve ser comprometido com o controle de origem de seu aplicativo, uma vez que cada desenvolvedor / servidor usando seu aplicativo pode exigir uma configuração de ambiente diferente. Além disso, isso seria um risco de segurança no caso de um invasor obter acesso ao repositório de controle de origem, uma vez que quaisquer credenciais confidenciais seriam expostas.
Para obter mais informações sobre a configuração de
.env
, verifique a documentação de configuração completa .
Configuração de diretório
O Laravel deve sempre ser servido a partir da raiz do “diretório web” configurado para o seu servidor web. Você não deve tentar servir um aplicativo Laravel fora de um subdiretório do “diretório da web”. Tentar fazer isso pode expor arquivos confidenciais que existem em seu aplicativo.
Próximos passos
Agora que criou seu projeto Laravel, você pode estar se perguntando o que aprender a seguir. Primeiramente, recomendamos que você se familiarize com o funcionamento do Laravel lendo a seguinte documentação:
A maneira como você deseja usar o Laravel também determinará os próximos passos em sua jornada. Existem várias maneiras de usar o Laravel, e vamos explorar dois casos de uso principais para o framework abaixo.
Laravel The Full Stack Framework
O Laravel pode servir como um framework full stack. Por framework “full stack” queremos dizer que você usará o Laravel para rotear requisições para sua aplicação e renderizar seu frontend através de templates Blade ou usando uma tecnologia híbrida de aplicação de página única como Inertia.js . Esta é a forma mais comum de usar o framework Laravel.
Se é assim que você planeja usar o Laravel, você pode verificar nossa documentação sobre roteamento , visualizações ou o ORM do Eloquent . Além disso, você pode estar interessado em aprender sobre pacotes de comunidade como Livewire e Inertia.js . Esses pacotes permitem que você use o Laravel como uma estrutura full-stack enquanto desfruta de muitos dos benefícios da interface do usuário fornecidos por aplicativos JavaScript de página única.
Se você está usando o Laravel como um framework full stack, também encorajamos você a aprender como compilar o CSS e JavaScript de sua aplicação usando o Laravel Mix .
Se você quiser começar a construir seu aplicativo, dê uma olhada em um de nossos kits oficiais para iniciantes .
Laravel, o backend da API
O Laravel também pode servir como um backend de API para um aplicativo JavaScript de página única ou aplicativo móvel. Por exemplo, você pode usar o Laravel como um backend de API para seu aplicativo Next.js. Neste contexto, você pode usar o Laravel para fornecer autenticação e armazenamento / recuperação de dados para sua aplicação, enquanto também aproveita os poderosos serviços do Laravel como filas, emails, notificações e muito mais.
Se é assim que você planeja usar o Laravel, você pode verificar nossa documentação sobre roteamento , Laravel Sanctum e o Eloquent ORM .