Laravel + Vue.js 微服务开发环境自动化
Laradock + Laravel + Vue.js 基于的微服务开发环境的全自动设置工具
🚀 特徴
- ⚡ 完全自动设置 -从容器启动到初始设置全自动（2-3分钟）
- 🔍 自动避免端口冲突（v3.0新增功能） -发现正在使用的端口并自动查找空闲端口
- 🔧 端口自动管理 -支持多服务同时启动
- 🎯 MCP连携 - Claude Code中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积
- 📦 支持通用包 -可重复使用Composer包管理
- 👥 团队共享 - Git统一设置
📋 必要环境
- Docker桌面
- Git
- Composer（选项-Docker可在容器中运行）
- Claude Code（推奨）
⚡ 快速启动
方法1：Claude Code（最简单）
いつもの開発環境をnginxのポート20600で作って或
/new-service方法2:命令行
# リポジトリをクローン
git clone https://github.com/your-username/dev-environment.git
cd dev-environment
# スクリプトダウンロード
curl -O https://raw.githubusercontent.com/your-username/dev-environment/main/scripts/setup-complete-environment.sh
# 実行
chmod +x setup-complete-environment.sh
./setup-complete-environment.sh user-service 8001🎯 什么是自动设置的
- ✅创建项目目录
- ✅Laradock克隆和配置
- ✅Nginx配置文件生成
- ✅Laravel创建项目
- ✅数据库设置
- ✅ Docker容器启动
- ✅ MySQL起动待机
- ✅ 应用程序密钥生成
- ✅ 迁移执行
- ✅ 立即访问
🌐 自动配置的服务
｜服务｜端口示例｜说明｜ |---------|---------|------| | Nginx | 8001 | Web服务器｜ |phpMyAdmin | 8002|行人数据库栽培作业（nginx+1）| | MySQL | 33001 | 数据库 | Redis | 63701 | 高速缓存 | MailHog | 80201 | 邮件测试
📁 创建的项目配置
/
├── laradock/
│ ├── .env # 自動生成・設定済み
│ └── nginx/sites/
│ └──
.conf # Nginx設定
├── src/ # Laravelアプリ
│ ├── .env # DB接続設定済み
│ ├── app/
│ ├── routes/
│ └── ...
└── README.md # 使い方ガイド📚 文档
🛠️ 脚本
｜脚本｜说明｜ |-----------|------| | scripts/setup-complete-environment-v3.sh | v3.0 端口冲突自动回避版（最新、推荐） | | scripts/setup-complete-environment-v2.sh | v2.0 端口冲突避免版 | scripts/setup-complete-environment.sh | v1.0 完全自动设置 | scripts/setup-new-microservice.sh 基本设置 | scripts/push-to-github.sh | GitHub推送自动化
🔧 使用方法
基本用法
# 完全自動セットアップ
./scripts/setup-complete-environment.sh
# 例: user-service を nginx ポート 8001 で作成
./scripts/setup-complete-environment.sh user-service 8001端口号建议规则
| 服务Nginx | PhpMyAdmin | |
|---|---|---|
| 用户服务 | 8001 | 8002 |
| 订购服务 | 8003 | 8004 |
| 支付服务 | 8005 | 8006 |
| 通知服务 | 8007 | 8008 |
🎨 Claude Code 协作
MCP设置（仅限第一次）
# GitHub MCPサーバーを追加
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
# 認証
/mcp添加斜线命令
.claude/commands/new-service.md 复制到项目：
cp dev-environment/.claude/commands/new-service.md your-project/.claude/commands/这样一来 /new-service 命令可用。
👥 与熟人共享
单击功能区上URL只要教大家，谁都能构筑同样的开发环境！
传达给熟人
このリポジトリを使えば2-3分でLaravel環境ができるよ！
https://github.com/YOUR-USERNAME/dev-environment熟人做的事（2种模式）
模式1：Claude Code（推荐）
# 初回のみ
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
/mcp
# 使用
「いつもの開発環境をポート20600で作って」模式2:命令行
curl -O https://raw.githubusercontent.com/YOUR-USERNAME/dev-environment/main/scripts/setup-complete-environment.sh
chmod +x setup-complete-environment.sh
./setup-complete-environment.sh my-project 8001就这样完成了！ 🎉
了解更多信息 SHARE-WITH-OTHERS.md 的双曲正切值
🔒 关于安全性
公共存储库注意事项
✅ 包括：
- 脚本（.sh）
- 模板（.template）
- 文档（.md）
- 配置文件（.mcp.json）
❌ 绝对不能包含的东西：
- .env 文件（实际环境变量）
- 凭据（API密钥、密码）
- 专用源代码
- 数据库转储
.gitignore 配置
存储库不包括：
# テスト用プロジェクト
test-service/
user-service/
*/
# 環境設定（実ファイル）
.env
!*.template
# 機密情報
*.key
*.pem
credentials.json🐛 故障排除
端口冲突
# 使用中のポート確認
lsof -i :8001
# 別のポートを使用
./scripts/setup-complete-environment.sh user-service 8011Docker未起动
Docker Desktopを起動してから再実行してください权限错误
cd
/laradock
docker-compose exec workspace chmod -R 775 /var/www/storage
docker-compose exec workspace chmod -R 775 /var/www/bootstrap/cache了解更多信息 故障排除指南 的双曲正切值
🤝 貢献
改善建议和错误报告Issue 或Pull Request 那就拜托了。
📝 许可证
MIT许可证
🔗 相关链接
📊 所要时间
- 初回：5-10分钟（下载Docker映像）
- 2回目以降: 2-3分
✨ 总结
从传统的手动设置（30-60分钟）到仅2-3分钟的完全自动设置。
“创造平时的开发环境” -只有这些！