document.writeln('');
Laravel Sail 是 Laravel 9+ 默認集成的輕量級 Docker 開發方案,封裝 Nginx、PHP-FPM、MySQL 等服務,自動處理依賴順序與網絡配置;需修正 docker-compose.yml 路徑、.env 主機配置及時區,并在容器內執行 composer install;生產環境須導出并精簡配置,不可直接使用 sail up -d。

直接用 Laravel Sail 部署 Docker 環境是目前最輕量、最貼近官方推薦的方案——它不是“可選工具”,而是 Laravel 9+ 默認集成的容器化入口,不需要手寫 docker-compose.yml 就能跑起完整開發棧。
Sail 的核心價值是把常見組合(Nginx + PHP-FPM + MySQL + Redis + MailHog + Selenium)封裝成開箱即用的 CLI 工具,避免重復配置網絡、卷映射、環境變量順序等易錯點。你自己寫的 docker-compose.yml 很容易在 APP_SERVICE 和 php-fpm 容器間出現 socket 連接超時,或因 mysql 容器啟動慢導致 Laravel 遷移失敗。
sail up 自動等待 MySQL 就緒后再啟動應用服務sail 網絡,PHP 容器內訪問 mysql 就是 DNS 名字,無需 127.0.0.1 或 host.docker.internal.env 中的 DB_HOST=mysql、REDIS_HOST=redis 是生效前提,不是占位符運行 composer require laravel/sail --dev 并執行 php artisan sail:install 后,別急著 sail up。以下三處不改,90% 的人會卡在 502 或數據庫連接拒絕:
docker-compose.yml 中 build.context 是否指向項目根目錄(不是 ./vendor/laravel/sail/runtimes/8.2 這類絕對路徑).env 里 DB_HOST=mysql、REDIS_HOST=redis、MAIL_MAILER=smtp 且 MAIL_HOST=mailhogdocker-compose.yml 的 laravel.test 服務下加 environment 塊:1 2 3 |
|
這是最常被忽略的權限與自動加載問題:Sail 的 sail artisan 實際在 laravel.test 容器里執行,但 vendor/autoload.php 如果由宿主機(比如 Mac M1)生成,可能含不兼容的擴展或緩存。解決方式不是重裝依賴,而是強制容器內生成:
sail down 停掉所有容器vendor/ 和 composer.locksail composer install —— 這一步會在 PHP 容器內執行,生成匹配容器架構的 autoloadersail up -d 啟動,sail artisan migrate 就不會報 Class App\Models\User not foundSail 是為開發設計的:它默認暴露 8000 端口、啟用 Xdebug、掛載整個項目目錄為 volume、日志直寫 stdout。上線時這些全是風險點。真正上生產應導出配置:sail artisan sail:publish,然后手動刪掉 xdebug 擴展、注釋 volumes 下的源碼掛載、把 APP_ENV=production 寫死進 docker-compose.yml 的 environment 塊,并用 Nginx 反向代理替換 Sail 自帶的簡易服務器。否則你看到的 “Docker 部署” 其實只是本地開發鏡像直接扔到云服務器上裸跑。