


[Laravel vx Docker] Efficiently Set Up a Laravel App Dev Environment with Laravel Sail
Oct 23, 2024 am 08:07 AMAbout Laravel Sail
Laravel Sail is the official development environment for the Laravel framework. Sail provides a lightweight command-line interface (CLI) to easily set up and manage a Laravel application development environment using Docker. Below, we explain the main features and usage of Laravel Sail.
Benefits of Using Laravel Sail
-
Build a development environment independent of the OS
- Sail uses Docker to containerize the development environment for Laravel applications. This allows you to build a development environment that is independent of the OS.
-
Easy setup of the development environment
- With Sail, you can set up a Laravel development environment with just a few commands. Even complex development environments using MySQL, Redis, MailHog, etc., can be easily built.
-
Easy management of projects with different versions
- For example, the version of Laravel depends on the version of PHP, but by setting the environment for each project in the docker-compose.yml file, you can easily switch versions.
When you create a project using Docker with Laravel Sail, the structure will look like the diagram above.
Usage
Development Environment
- Mac
- PHP v8.3
- Laravel v11
- Docker
Prerequisites
Before creating a Laravel project, download and start Docker Desktop.
https://www.docker.com/products/docker-desktop/
1. Creating a Laravel Project
Run the following command to create a new Laravel project and set up Laravel Sail.
curl -s "https://laravel.build/example-app" | bash cd example-app
This will create the Laravel project files. The development environment is described in the generated docker-compose.yml file.
Specify services with the with query
If you want to specify the PHP version or use PostgreSQL instead of MySQL, you can specify with=
curl -s "https://laravel.build/example-app?php=81&with=pgsql,redis" | bash
2. Starting Sail
Move to the project directory and start Sail.
./vendor/bin/sail up -d
This command starts the Docker containers and runs the Laravel application.
※Registering an alias
Typing ./vendor/bin/sail an be cumbersome, so save it as an alias sail in your shell's configuration file.
Check the path of the shell you are using with the following command
echo $SHELL
Example: /bin/zsh
Editing the Shell configuration file
- For zsh
The Shell configuration file is ~/.zshrc.
To add an alias, run the following command
curl -s "https://laravel.build/example-app" | bash cd example-app
- For bash
The shell configuration file is ~/.bash_profile or ~/.bashrc.
To add an alias, run the following command:
curl -s "https://laravel.build/example-app?php=81&with=pgsql,redis" | bash
With the above settings, you can run the sail command in a shortened form.
./vendor/bin/sail up -d
3. Using Sail Commands
You can use Sail to perform various development tasks. Here are some examples.
- Starting the application:
echo $SHELL
- Stopping the application:
echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.zshrc source ~/.zshrc
- Running Artisan commands:
echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.bash_profile source ~/.bash_profile
- Running Composer commands:
sail up -d
- Running npm commands:
sail up -d
4. Changing Services
Even after creating the project, you can change the services by modifying the docker-compose.yml file, which is the Docker configuration file. Here, we will change the PHP version and the database used.
Changing the PHP version
First, check the current PHP version
sail down
Next, modify the development environment information described in the docker-compose.yml file.
sail artisan migrate
Change build context and image to 8.1 .
sail composer install
After modifying docker-compose.yml, stop the application.
sail npm install
Next, rebuild the Docker containers to reflect the changes.
sail php -v PHP 8.3.12 (cli) (built: Sep 27 2024 03:53:05) (NTS)
Restart the application.
services: laravel.test: build: context: "./vendor/laravel/sail/runtimes/8.3" dockerfile: Dockerfile args: WWWGROUP: "${WWWGROUP}" image: "sail-8.3/app"
Check if the PHP version has changed.
services: laravel.test: build: context: "./vendor/laravel/sail/runtimes/8.1" dockerfile: Dockerfile args: WWWGROUP: "${WWWGROUP}" image: "sail-8.1/app"
The PHP version has been changed from PHP 8.3 to PHP 8.1.
Changing the database used
Change a project created with MySQL to PostgreSQL.
Run the Sail installation command
sail down
Select pgsql
sail build --no-cache
Check the docker-compose.yml file and confirm that the pgsql entries have been added.
sail up -d
ext, open the .env file in the project directory and confirm that DB_CONNECTION=pgsql and DB_HOST=pgsql are set.
If not, change them manually.
sail php -v PHP 8.1.30 (cli) (built: Sep 27 2024 04:07:29) (NTS)
After confirming the changes in docker-compose.yml and .env, stop the application.
sail php artisan sail:install
Next, rebuild the Docker containers to reflect the changes.
┌ Which services would you like to install? ───────────────────┐ │ ? mysql ┃ │ │ ? ? pgsql │ │ │ ? mariadb │ │ │ ? redis │ │ │ ? memcached │ │ └────────────────────────────────────────────────── 1 selected ┘ Use the space bar to select options.
Restart the application.
services: laravel.test: ... depends_on: - mysql - redis - meilisearch - mailpit - selenium - pgsql ... pgsql: image: 'postgres:17' ports: - '${FORWARD_DB_PORT:-5432}:5432' environment: PGPASSWORD: '${DB_PASSWORD:-secret}' POSTGRES_DB: '${DB_DATABASE}' POSTGRES_USER: '${DB_USERNAME}' POSTGRES_PASSWORD: '${DB_PASSWORD:-secret}' volumes: - 'sail-pgsql:/var/lib/postgresql/data' - './vendor/laravel/sail/database/pgsql/create-testing-database.sql:/docker-entrypoint-initdb.d/10-create-testing-database.sql' networks: - sail healthcheck: test: - CMD - pg_isready - '-q' - '-d' - '${DB_DATABASE}' - '-U' - '${DB_USERNAME}' retries: 3 timeout: 5s
Run the migration files.
DB_CONNECTION=pgsql DB_HOST=pgsql DB_PORT=5432 DB_DATABASE=laravel DB_USERNAME=sail DB_PASSWORD=******
Start a shell in Docker and check pgsql
Display the list of currently running Docker containers.
curl -s "https://laravel.build/example-app" | bash cd example-app
curl -s "https://laravel.build/example-app?php=81&with=pgsql,redis" | bash
Check the container name of the application and start the bash of the application inside Docker.
./vendor/bin/sail up -d
Connect to pgsql.
echo $SHELL
You will be prompted for a password, so enter the DB_PASSWORD specified in the .env file.
echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.zshrc source ~/.zshrc
Check the tables in pgsql
echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.bash_profile source ~/.bash_profile
In this way, you can change from MySQL to PostgreSQL even after creating the project.
Conclusion
Through this article, you will understand how to efficiently set up and manage a development environment using Laravel Sail. By selecting appropriate services and customizing the settings according to the project's requirements, you can achieve a more flexible and powerful development environment.
The above is the detailed content of [Laravel vx Docker] Efficiently Set Up a Laravel App Dev Environment with Laravel Sail. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

Hot Topics

ToversionaPHP-basedAPIeffectively,useURL-basedversioningforclarityandeaseofrouting,separateversionedcodetoavoidconflicts,deprecateoldversionswithclearcommunication,andconsidercustomheadersonlywhennecessary.StartbyplacingtheversionintheURL(e.g.,/api/v

TosecurelyhandleauthenticationandauthorizationinPHP,followthesesteps:1.Alwayshashpasswordswithpassword_hash()andverifyusingpassword_verify(),usepreparedstatementstopreventSQLinjection,andstoreuserdatain$_SESSIONafterlogin.2.Implementrole-basedaccessc

Proceduralandobject-orientedprogramming(OOP)inPHPdiffersignificantlyinstructure,reusability,anddatahandling.1.Proceduralprogrammingusesfunctionsorganizedsequentially,suitableforsmallscripts.2.OOPorganizescodeintoclassesandobjects,modelingreal-worlden

PHPdoesnothaveabuilt-inWeakMapbutoffersWeakReferenceforsimilarfunctionality.1.WeakReferenceallowsholdingreferenceswithoutpreventinggarbagecollection.2.Itisusefulforcaching,eventlisteners,andmetadatawithoutaffectingobjectlifecycles.3.YoucansimulateaWe

To safely handle file uploads in PHP, the core is to verify file types, rename files, and restrict permissions. 1. Use finfo_file() to check the real MIME type, and only specific types such as image/jpeg are allowed; 2. Use uniqid() to generate random file names and store them in non-Web root directory; 3. Limit file size through php.ini and HTML forms, and set directory permissions to 0755; 4. Use ClamAV to scan malware to enhance security. These steps effectively prevent security vulnerabilities and ensure that the file upload process is safe and reliable.

Yes, PHP can interact with NoSQL databases like MongoDB and Redis through specific extensions or libraries. First, use the MongoDBPHP driver (installed through PECL or Composer) to create client instances and operate databases and collections, supporting insertion, query, aggregation and other operations; second, use the Predis library or phpredis extension to connect to Redis, perform key-value settings and acquisitions, and recommend phpredis for high-performance scenarios, while Predis is convenient for rapid deployment; both are suitable for production environments and are well-documented.

In PHP, the main difference between == and == is the strictness of type checking. ==Type conversion will be performed before comparison, for example, 5=="5" returns true, and ===Request that the value and type are the same before true will be returned, for example, 5==="5" returns false. In usage scenarios, === is more secure and should be used first, and == is only used when type conversion is required.

The methods of using basic mathematical operations in PHP are as follows: 1. Addition signs support integers and floating-point numbers, and can also be used for variables. String numbers will be automatically converted but not recommended to dependencies; 2. Subtraction signs use - signs, variables are the same, and type conversion is also applicable; 3. Multiplication signs use * signs, which are suitable for numbers and similar strings; 4. Division uses / signs, which need to avoid dividing by zero, and note that the result may be floating-point numbers; 5. Taking the modulus signs can be used to judge odd and even numbers, and when processing negative numbers, the remainder signs are consistent with the dividend. The key to using these operators correctly is to ensure that the data types are clear and the boundary situation is handled well.
