News

PHP 8.1 Support in Laravel Sail

Published
PHP 8.1 Support in Laravel Sail image

Laravel added PHP 8.1 support to Laravel Sail earlier this week. While PHP 8.1 is not ready for production yet, you can start developing applications, testing packages, and getting ready for the PHP 8.1 GA release in November.

A special thanks to Dries Vints who contributed this update:

Updating Your Sail Project to PHP 8.1

If you want to start using PHP 8.1 in your Sail applications now, you can update the project's docker-compose.yml file build.context and image values to 8.1:

services:
laravel.test:
build:
context: ./vendor/laravel/sail/runtimes/8.1
dockerfile: Dockerfile
args:
WWWGROUP: '${WWWGROUP}'
image: sail-8.1/app
# ...

If you have an existing application with Sail, you'll need to run composer update to get the latest version of Sail that includes the 8.1 runtime:

composer update laravel/sail

After you're done updating the files, you can rerun Sail to get the latest changes:

./vendor/bin/sail down
./vendor/bin/sail build
./vendor/bin/sail up

With that, you should see something similar to the following on the welcome screen if you're starting a new Laravel application:

Learn More

If you'd like to learn more about the PHP 8.1 sail implementation, check out Pull Request #254 in the laravel/sail repo. I'd also recommend checking out the Installation and Sail documentation for setup and usage details.

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

Filed in

Sponsored

acquaintsoft logo
Acquaint Softtech

Hire Laravel developers with AI expertise at $20/hr. Get started in 48 hours.

Visit Acquaint Softtech

The latest

View all →
Laravel Starter Kits Now Ship with Vite+ image

Laravel Starter Kits Now Ship with Vite+

Read article
Pessimistic Locking in Laravel Eloquent with refreshForUpdate() image

Pessimistic Locking in Laravel Eloquent with refreshForUpdate()

Read article
Mask Query Bindings in Laravel Exception Messages image

Mask Query Bindings in Laravel Exception Messages

Read article
whereBinary(): Case-Sensitive MySQL Queries in Laravel image

whereBinary(): Case-Sensitive MySQL Queries in Laravel

Read article
Compile PHP to Native Binaries with TypePHP image

Compile PHP to Native Binaries with TypePHP

Read article
State of Laravel 2026 Survey Is Now Open image

State of Laravel 2026 Survey Is Now Open

Read article