推荐新手使用docker-laravel模板:克隆仓库后执行make for-linux-env(Linux)或跳过(macOS/Windows),再运行make create-project自动完成项目创建、密钥生成和storage软链,最后docker compose up -d启动服务,5分钟内即可通过http://localhost访问Laravel欢迎页。

要在Docker环境中快速安装Laravel项目,无需在宿主机安装PHP、Composer或数据库服务,所有依赖都由容器提供,直接从空目录起步即可生成可运行的Laravel应用。
使用现成模板一键创建(推荐新手)
克隆成熟维护的docker-laravel模板仓库:git clone https://gitcode.com/gh_mirrors/do/docker-laravel
进入目录后执行初始化脚本:cd docker-laravel && make for-linux-env(Linux用户)或跳过此步(macOS/Windows)
运行项目构建与安装命令:make create-project,该命令会自动执行容器内composer create-project、密钥生成、storage软链等全部操作
启动服务:docker compose up -d,等待Nginx、PHP-FPM、MySQL容器就绪
浏览器访问 http://localhost 即可看到Laravel欢迎页——整个过程不碰宿主机PHP环境,5分钟内完成。
用官方镜像临时容器安装(适合已有项目目录)
方法一:挂载当前目录到Composer容器中创建新项目
执行:docker run --rm -v $(pwd):/app -w /app composer create-project laravel/laravel .
这会在当前文件夹生成完整Laravel骨架,但【注意:必须确保当前目录为空,否则会报错覆盖拒绝】
方法二:用PHP+Composer组合镜像一步到位
运行:docker run --rm -v $(pwd):/app -w /app php:8.2-cli curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer && composer create-project laravel/laravel .
这条命令先装Composer再拉Laravel,适合无法联网但能拉取php镜像的离线调试场景。
通过docker-compose.yml定义服务并安装依赖
第一步:在项目根目录新建docker-compose.yml,至少包含app(PHP-FPM)、nginx、mysql三个服务,其中app服务需声明build上下文或指定image: php:8.2-fpm
第二步:确保项目目录下已存在composer.json(可先用composer init交互生成最小配置)
第三步:启动PHP容器并安装依赖:docker compose run --rm app composer install --no-interaction --prefer-dist
这步必须在app服务能正确挂载代码目录的前提下执行,否则提示“找不到composer.json”
第四步:进入容器生成密钥:docker compose exec app php artisan key:generate
第五步:建立storage链接:docker compose exec app php artisan storage:link
此时Laravel基础功能已就绪,配合Nginx配置即可响应HTTP请求。


















