从零开始定制docker-compose-laravel：个性化开发环境配置指南

【免费下载链接】docker-compose-laravel A docker-compose workflow for local Laravel development 项目地址: https://gitcode.com/gh_mirrors/do/docker-compose-laravel

docker-compose-laravel是一个简化的Docker Compose工作流，为本地Laravel开发搭建了LEMP容器网络。本文将详细介绍如何从零开始定制这个开发环境，打造专属于你的高效Laravel开发空间。

准备工作：环境搭建基础

在开始定制之前，确保你的系统已安装Docker。然后通过以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/do/docker-compose-laravel

项目的核心配置文件位于根目录下的docker-compose.yml，它定义了整个开发环境的服务组合。

核心服务解析：了解你的开发环境

docker-compose-laravel包含多个关键服务，它们共同构成了完整的Laravel开发环境：

• nginx - 端口:80，处理HTTP请求
• mysql - 端口:3306，数据库服务
• php - 端口:9000，PHP解释器
• redis - 端口:6379，缓存服务
• mailhog - 端口:8025，邮件测试工具

这些服务在docker-compose.yml中定义，通过Laravel网络相互连接，形成一个完整的开发生态系统。

快速启动：基础环境配置

要启动基础开发环境，在项目根目录运行以下命令：

docker-compose up -d --build app

这条命令会构建并启动所有必要的服务。首次运行可能需要几分钟时间下载和构建镜像，但后续启动会快很多。

个性化配置：打造你的专属环境

1. 权限问题解决

如果在访问应用或运行容器命令时遇到文件系统权限问题，可以根据你的用户类型选择以下解决方案：

root用户环境：

• 停止容器：docker-compose down
• 编辑docker-compose.yml，将所有php.dockerfile替换为php.root.dockerfile
• 重建容器：docker-compose build --no-cache

非root用户环境：

• 停止容器：docker-compose down
• 运行命令：export UID=$(id -u) 和 export GID=$(id -g)
• 重建容器：docker-compose build --no-cache

2. 持久化MySQL数据

默认情况下，Docker网络关闭后MySQL数据会被清除。要实现数据持久化：

1. 在项目根目录创建mysql文件夹
2. 编辑docker-compose.yml，在mysql服务下添加：

volumes:
  - ./mysql:/var/lib/mysql

3. Nginx配置定制

Nginx配置文件位于dockerfiles/nginx/default.conf。你可以根据项目需求修改此文件，例如添加虚拟主机、启用HTTPS或配置URL重写规则。

默认配置已经针对Laravel进行了优化，包含了必要的PHP处理和URL重写规则。

高效开发工具：无需本地安装的命令支持

docker-compose-laravel提供了三个额外的容器，让你无需在本地安装相关工具即可运行Composer、NPM和Artisan命令：

• Composer：docker-compose run --rm composer update
• NPM：docker-compose run --rm npm run dev
• Artisan：docker-compose run --rm artisan migrate

这些命令让你的开发环境更加隔离和一致，避免了不同项目间的依赖冲突。

前端资源编译：支持Laravel Mix和Vite

该配置支持使用Laravel Mix和Vite编译前端资源。以Vite为例，只需在package.json中修改dev命令：

"scripts": {
  "dev": "vite --host 0.0.0.0",
  "build": "vite build"
}

然后运行以下命令安装依赖并启动开发服务器：

docker-compose run --rm npm install
docker-compose run --rm --service-ports npm run dev

邮件测试：使用MailHog

Laravel默认使用MailHog进行本地邮件测试。启动环境后，访问http://localhost:8025即可查看邮件发送情况，这对于测试密码重置、通知等功能非常有用。

生产环境部署建议

虽然该模板主要用于本地开发，但也可用于基础的Laravel应用部署。生产环境建议：

1. 优化nginx/default.conf配置
2. 启用HTTPS（可使用Let's Encrypt）
3. 调整容器资源限制
4. 添加监控和日志收集

通过这些定制化步骤，你可以打造一个既适合本地开发又能轻松部署到生产环境的Laravel开发环境。docker-compose-laravel的灵活性让你能够根据项目需求随时调整配置，提高开发效率。

【免费下载链接】docker-compose-laravel A docker-compose workflow for local Laravel development 项目地址: https://gitcode.com/gh_mirrors/do/docker-compose-laravel