- Conheça o Laravel
- Creating a Laravel Project
- Initial Configuration
- Docker Installation Using Sail
- IDE Support
- Next Steps
Laravel é um framework de aplicação web com sintaxe expressiva e elegante. Um framework web fornece uma estrutura e um ponto de partida para a criação da sua aplicação, permitindo que você se concentre na criação de algo incrível enquanto nos preocupamos com os detalhes.
O Laravel se esforça para fornecer uma experiência incrível à pessoa desenvolvedora, enquanto fornece recursos poderosos, como injeção completa de dependência, uma camada expressiva de abstração de banco de dados, filas e trabalhos agendados, testes unitários e de integração e muito mais.
Quer você seja uma pessoa nova em frameworks web PHP ou tenha anos de experiência, o Laravel é um framework que pode crescer com você. Nós te ajudaremos a dar os primeiros passos como pessoa desenvolvedora web ou te daremos um impulso à medida que você leva seu conhecimento para o próximo nível. Mal podemos esperar para ver o que você construirá.
Nota: Começando agora com o Laravel? Confira o Bootcamp Laravel para uma jornada prática pelo framework enquanto orientamos você na construção da sua primeira aplicação Laravel.
Há uma variedade de ferramentas e frameworks disponíveis para você construir uma aplicação web. No entanto, acreditamos que o Laravel é a melhor escolha para construir aplicações web modernas e completas.
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 te ajudará a aprender o básico sem se sobrecarregar.
Se você é uma pessoa desenvolvedora sênior, o Laravel oferece ferramentas robustas para injeção de dependência, testes unitários, filas, eventos em tempo real, e muito mais. O Laravel vem ajustado para construir aplicações web profissionais e está pronto para lidar com cargas de trabalho empresariais.
O Laravel é incrivelmente escalável. Graças à natureza amigável ao escalonamento do PHP e ao suporte integrado do Laravel para sistemas de cache distribuídos e rápidos como o Redis, o escalonamento horizontal com o Laravel é muito fácil. Na verdade, as aplicações Laravel têm sido facilmente dimensionadas para lidar com centenas de milhões de solicitações mensais.
Precisa de dimensionamento extremo? Plataformas como o Laravel Vapor permitem que você execute sua aplicação Laravel em escala quase ilimitada na mais recente tecnologia serverless da AWS.
O Laravel combina os melhores pacotes do ecossistema PHP para oferecer o framework mais robusto e amigável disponível para a pessoa desenvolvedora. Além disso, milhares de pessoas desenvolvedoras talentosas de todo o mundo contribuíram para o framework. Quem sabe você até se tornará uma pessoa contribuidora do Laravel.
Before creating your first Laravel project, make sure that your local machine has PHP and Composer installed. If you are developing on macOS or Windows, PHP and Composer can be installed in minutes via Laravel Herd. In addition, we recommend installing Node and NPM.
After you have installed PHP and Composer, you may create a new Laravel project
via Composer's create-project command:
composer create-project laravel/laravel example-app
Or, you may create new Laravel projects by globally installing the Laravel installer via Composer:
composer global require laravel/installer
laravel new example-app
Once the project has been created, start Laravel's local development server
using Laravel Artisan's serve command:
cd example-app
php artisan serve
Once you have started the Artisan development server, your application will be accessible in your web browser at http://localhost:8000. Next, you're ready to start taking your next steps into the Laravel ecosystem. Of course, you may also want to configure a database.
Note
If you would like a head start when developing your Laravel application, consider using one of our starter kits. Laravel's starter kits provide backend and frontend authentication scaffolding for your new Laravel application.
All of the configuration files for the Laravel framework are stored in
the config directory.
Each option is documented, so feel free to look through the files and get
familiar with the options available to you.
Laravel needs almost no additional configuration out of the box.
You are free to get started developing! However, you may wish to review
the config/app.php file and its documentation.
It contains several options such as timezone and locale that you may wish to
change according to your application.
Since many of Laravel's configuration option values may vary depending on
whether your application is running on your local machine or on a production web
server, many important configuration values are defined using the .env file
that exists at the root of your application.
Your .env file should not be committed to your application's source control,
since each developer / server using your application could require a different
environment configuration.
Furthermore, this would be a security risk in the event an intruder gains access
to your source control repository, since any sensitive credentials would be
exposed.
Note
For more information about the .env file and environment based
configuration, check out the
full configuration documentation.
Now that you have created your Laravel application, you probably want to store
some data in a database.
By default, your application's .env configuration file specifies that Laravel
will be interacting with a SQLite database.
During the creation of the project, Laravel created a database/database.sqlite
file for you, and ran the necessary migrations to create the application's
database tables.
If you prefer to use another database driver such as MySQL or PostgreSQL, you
can update your .env configuration file to use the appropriate database.
For example, if you wish to use MySQL, update your .env configuration
file's DB_* variables like so:
DB_CONNECTION = mysql
DB_HOST = 127.0.0.1
DB_PORT = 3306
DB_DATABASE = laravel
DB_USERNAME = root
DB_PASSWORD =If you choose to use a database other than SQLite, you will need to create the database and run your application's database migrations:
php artisan migrateNote
If you are developing on macOS and need to install MySQL, PostgreSQL, or Redis locally, consider using DBngin.
Laravel should always be served out of the root of the "web directory" configured for your web server. You should not attempt to serve a Laravel application out of a subdirectory of the "web directory". Attempting to do so could expose sensitive files present within your application.
We want it to be as easy as possible to get started with Laravel regardless of your preferred operating system. So, there are a variety of options for developing and running a Laravel project on your local machine. While you may wish to explore these options at a later time, Laravel provides Sail, a built-in solution for running your Laravel project using Docker.
Docker is a tool for running applications and services in small, light-weight " containers" which do not interfere with your local machine's installed software or configuration. This means you don't have to worry about configuring or setting up complicated development tools such as web servers and databases on your local machine. To get started, you only need to install Docker Desktop.
Laravel Sail is a light-weight command-line interface for interacting with Laravel's default Docker configuration. Sail provides a great starting point for building a Laravel application using PHP, MySQL, and Redis without requiring prior Docker experience.
Note
Already a Docker expert? Don't worry! Everything about Sail can be customized
using the docker-compose.yml file included with Laravel.
If you're developing on a Mac and Docker Desktop is already installed, you can use a simple terminal command to create a new Laravel project. For example, to create a new Laravel application in a directory named " example-app", you may run the following command in your terminal:
curl -s "https://laravel.build/example-app" | bashOf course, you can change "example-app" in this URL to anything you like - just make sure the application name only contains alpha-numeric characters, dashes, and underscores. The Laravel application's directory will be created within the directory you execute the command from.
Sail installation may take several minutes while Sail's application containers are built on your local machine.
After the project has been created, you can navigate to the application directory and start Laravel Sail. Laravel Sail provides a simple command-line interface for interacting with Laravel's default Docker configuration:
cd example-app
./vendor/bin/sail upOnce the application's Docker containers have started, you should run your application's database migrations:
./vendor/bin/sail artisan migrateFinally, you can access the application in your web browser at: http://localhost.
Note
To continue learning more about Laravel Sail, review its complete documentation.
Before we create a new Laravel application on your Windows machine, make sure to install Docker Desktop. Next, you should ensure that Windows Subsystem for Linux 2 (WSL2) is installed and enabled. WSL allows you to run Linux binary executables natively on Windows 10. Information on how to install and enable WSL2 can be found within Microsoft's developer environment documentation.
Note
After installing and enabling WSL2, you should ensure that Docker Desktop
is configured to use the WSL2 backend.
Next, you are ready to create your first Laravel project. Launch Windows Terminal and begin a new terminal session for your WSL2 Linux operating system. Next, you can use a simple terminal command to create a new Laravel project. For example, to create a new Laravel application in a directory named " example-app", you may run the following command in your terminal:
curl -s https://laravel.build/example-app | bashOf course, you can change "example-app" in this URL to anything you like - just make sure the application name only contains alpha-numeric characters, dashes, and underscores. The Laravel application's directory will be created within the directory you execute the command from.
Sail installation may take several minutes while Sail's application containers are built on your local machine.
After the project has been created, you can navigate to the application directory and start Laravel Sail. Laravel Sail provides a simple command-line interface for interacting with Laravel's default Docker configuration:
cd example-app
./vendor/bin/sail upOnce the application's Docker containers have started, you should run your application's database migrations:
./vendor/bin/sail artisan migrateFinally, you can access the application in your web browser at: http://localhost.
Note
To continue learning more about Laravel Sail, review its complete documentation.
Of course, you will need to be able to modify the Laravel application files that were created within your WSL2 installation. To accomplish this, we recommend using Microsoft's Visual Studio Code editor and their first-party extension for Remote Development.
Once these tools are installed, you may open any Laravel project by executing
the code . command from your application's root directory using Windows
Terminal.
If you're developing on Linux and Docker Compose is already installed, you can use a simple terminal command to create a new Laravel project.
First, if you are using Docker Desktop for Linux, you should execute the following command. If you are not using Docker Desktop for Linux, you may skip this step:
docker context use defaultThen, to create a new Laravel application in a directory named "example-app", you may run the following command in your terminal:
curl -s https://laravel.build/example-app | bashOf course, you can change "example-app" in this URL to anything you like - just make sure the application name only contains alpha-numeric characters, dashes, and underscores. The Laravel application's directory will be created within the directory you execute the command from.
Sail installation may take several minutes while Sail's application containers are built on your local machine.
After the project has been created, you can navigate to the application directory and start Laravel Sail. Laravel Sail provides a simple command-line interface for interacting with Laravel's default Docker configuration:
cd example-app
./vendor/bin/sail upOnce the application's Docker containers have started, you should run your application's database migrations:
./vendor/bin/sail artisan migrateFinally, you can access the application in your web browser at: http://localhost.
Note
To continue learning more about Laravel Sail, review its complete documentation.
When creating a new Laravel application via Sail, you may use the with query
string variable to choose which services should be configured in your new
application's docker-compose.yml file.
Available services
include mysql, pgsql, mariadb, redis, memcached, meilisearch, typesense, minio, selenium,
and mailpit:
curl -s "https://laravel.build/example-app?with=mysql,redis" | bashIf you do not specify which services you would like configured, a default stack
of mysql, redis, meilisearch, mailpit, and selenium will be
configured.
You may instruct Sail to install a
default Devcontainer by adding
the devcontainer parameter to the URL:
curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bashYou are free to use any code editor you wish when developing Laravel applications; however, PhpStorm offers extensive support for Laravel and its ecosystem, including Laravel Pint.
In addition, the community maintained Laravel Idea PhpStorm plugin offers a variety of helpful IDE augmentations, including code generation, Eloquent syntax completion, validation rule completion, and more.
Now that you have created your Laravel project, you may be wondering what to learn next. First, we strongly recommend becoming familiar with how Laravel works by reading the following documentation:
How you want to use Laravel will also dictate the next steps on your journey. There are a variety of ways to use Laravel, and we'll explore two primary use cases for the framework below.
Note
New to Laravel? Check out the Laravel Bootcamp for a hands-on tour of the framework while we walk you through building your first Laravel application.
Laravel may serve as a full stack framework. By "full stack" framework we mean that you are going to use Laravel to route requests to your application and render your frontend via Blade templates or a single-page application hybrid technology like Inertia. This is the most common way to use the Laravel framework, and, in our opinion, the most productive way to use Laravel.
If this is how you plan to use Laravel, you may want to check out our documentation on frontend development, routing, views, or the Eloquent ORM. In addition, you might be interested in learning about community packages like Livewire and Inertia. These packages allow you to use Laravel as a full-stack framework while enjoying many of the UI benefits provided by single-page JavaScript applications.
If you are using Laravel as a full stack framework, we also strongly encourage you to learn how to compile your application's CSS and JavaScript using Vite.
Note
If you want to get a head start building your application, check out one of our official application starter kits.
Laravel may also serve as an API backend to a JavaScript single-page application or mobile application. For example, you might use Laravel as an API backend for your Next.js application. In this context, you may use Laravel to provide authentication and data storage / retrieval for your application, while also taking advantage of Laravel's powerful services such as queues, emails, notifications, and more.
If this is how you plan to use Laravel, you may want to check out our documentation on routing, Laravel Sanctum, and the Eloquent ORM.
Note
Need a head start scaffolding your Laravel backend and Next.js frontend? Laravel Breeze offers an API stack as well as a Next.js frontend implementation so you can get started in minutes.