Laravel Docker部署教程

在现代PHP Web开发领域，Laravel框架凭借优雅的语法、丰富的组件生态和强大的工程化能力，成为了众多开发者构建企业级应用的首选，而容器化技术的普及，更是让Laravel应用的部署流程摆脱了传统环境配置的繁琐，实现了开发、测试、生产环境的高度一致性。传统的Laravel部署往往需要在服务器上手动安装PHP、Composer、Nginx、MySQL、Redis等一系列依赖，不仅容易因为版本不兼容引发各种诡异的问题，还会在多服务器扩展时耗费大量的运维成本，而Docker容器化部署能够将所有依赖打包进镜像中，做到一次构建多处运行，极大降低了部署的复杂度和出错概率。

要完成Laravel应用的Docker部署，首先需要准备基础的环境依赖，你需要在本地开发机和目标服务器上都安装好Docker Engine以及Docker Compose插件，目前Docker官方已经提供了适配Windows、macOS和主流Linux发行版的安装包，按照官方文档操作即可快速完成配置。准备好环境后，我们需要在Laravel项目根目录下创建三个核心的配置文件，分别是用于定义PHP服务镜像的Dockerfile、用于编排多容器服务的docker-compose.yml，以及用于配置Nginx虚拟主机的default.conf文件。

首先编写Dockerfile，我们通常选择PHP官方的fpm镜像作为基础镜像，因为Laravel运行需要PHP-FPM来处理PHP请求，基础镜像的版本要和你的Laravel版本兼容，比如Laravel 10推荐使用PHP 8.1及以上版本。在Dockerfile中，我们需要安装Laravel运行必备的PHP扩展，包括pdo_mysql、mbstring、exif、pcntl、bcmath、gd、zip等，还要安装Composer用于管理PHP依赖，同时可以设置工作目录为/var/www/html，将项目代码复制到镜像内部。为了减小镜像体积，我们可以使用多阶段构建的方式，先在一个构建阶段安装依赖并完成代码编译，再将必要的文件复制到运行阶段的镜像中，剔除开发环境的冗余文件。

接下来是docker-compose.yml文件的编写，Laravel应用通常需要至少三个服务协同工作，分别是处理PHP逻辑的app服务、处理Web请求的nginx服务，以及存储数据的mysql服务，如果你的项目用到了队列、缓存等功能，还可以加上redis服务和queue队列服务。每个服务都需要配置对应的镜像、端口映射、卷挂载、环境变量和依赖关系，比如app服务可以基于我们自己编写的Dockerfile构建，nginx服务使用官方的nginx:alpine镜像，将80端口映射到宿主机的指定端口，同时挂载项目的public目录和Nginx配置文件，mysql服务则需要配置root密码、数据库名、用户密码等环境变量，并且将数据目录挂载到宿主机，防止容器删除后数据丢失。

Nginx的配置文件需要适配Laravel的路由规则，要将所有非静态文件的请求都转发到index.php入口文件，同时配置好根目录指向/var/www/html/public，设置合适的文件上传大小限制，避免出现上传文件失败的问题。配置文件编写完成后，我们可以先在本地运行docker compose build命令构建镜像，再运行docker compose up -d启动所有容器，启动完成后可以通过docker ps命令查看容器运行状态，确认所有服务都正常运行后，就可以在浏览器中访问localhost对应的端口，查看Laravel应用是否正常加载。

本地测试通过后，就可以将项目部署到生产服务器了，生产环境部署时需要注意几个关键点，首先是环境变量的配置，不要将.env文件直接打包进镜像，而是通过docker-compose的environment配置或者单独的env_file来传递，尤其是数据库密码、APP_KEY等敏感信息，绝对不能提交到代码仓库中。其次是文件权限的问题，Laravel的storage和bootstrap/cache目录需要写入权限，我们可以在Dockerfile中添加RUN命令，修改这两个目录的权限为www-data用户所有，避免出现页面报错无法写入缓存的情况。

生产环境的镜像构建最好使用专门的CI/CD工具来完成，比如GitHub Actions、GitLab CI等，每次代码提交到主分支后，自动构建镜像并推送到私有镜像仓库，服务器上只需要拉取最新的镜像重启服务即可，整个过程不需要人工干预，大大提升了部署效率和可靠性。如果你的应用访问量较大，还可以结合Docker Swarm或者Kubernetes进行容器编排，实现服务的横向扩展和负载均衡，满足高并发场景下的需求。

还有一些细节优化值得注意，比如我们可以将Composer的依赖安装单独放在Dockerfile的一个层级中，利用Docker的镜像缓存机制，每次构建只有当composer.json和composer.lock文件发生变化时才会重新安装依赖，大幅提升构建速度。对于静态资源，我们可以在构建镜像时执行npm install和npm run build命令，将编译后的静态文件直接打包进nginx镜像或者单独的对象存储中，减少PHP服务的压力。日志处理方面，Laravel的日志可以配置为输出到标准输出，这样Docker就可以统一收集所有容器的日志，方便我们通过docker logs命令查看，也可以对接ELK等日志分析系统进行统一管理。

Laravel结合Docker的部署方式，不仅解决了传统部署中环境不一致的痛点，还让应用的扩展和维护变得更加简单，哪怕是刚接触容器化的开发者，只要按照规范编写配置文件，也能快速搭建出稳定可靠的生产环境。随着容器技术的不断发展，未来Laravel的部署流程会更加自动化和智能化，开发者可以将更多精力放在业务逻辑的实现上，而不用耗费大量时间在环境配置和运维工作上。