Laravel 项目在 Linux 下的代码版本控制指南

在 Linux 环境下对 Laravel 项目进行版本控制主要使用 Git，以下是详细的操作步骤和最佳实践：

1. 初始化 Git 仓库

# 进入 Laravel 项目目录
cd /path/to/your/laravel-project

# 初始化 Git 仓库
git init

# 创建基本的 .gitignore 文件（Laravel 有默认的）
# 如果没有，可以从官方获取
wget https://raw.githubusercontent.com/laravel/laravel/master/.gitignore -O .gitignore

2. Laravel 特定的 .gitignore 内容

Laravel 默认的 .gitignore 应该包含以下内容：

/vendor
/node_modules
/public/storage
/storage/*.key
/.env
/.idea
Homestead.json
Homestead.yaml
.phpunit.result.cache
docker-compose.yml
.env.backup
.phpunit.result.cache
.php_cs.cache
_ide_helper.php

3. 初始提交

# 添加所有文件到暂存区
git add .

# 提交初始版本
git commit -m "Initial commit"

4. 连接到远程仓库（如 GitHub/GitLab）

# 添加远程仓库
git remote add origin https://github.com/yourusername/your-repo.git

# 推送代码
git push -u origin master

5. Laravel 特有的版本控制注意事项

环境文件处理

• 不要将 .env 文件加入版本控制
• 创建 .env.example 作为模板提交到仓库
• 新成员克隆项目后应复制 .env.example 为 .env 并修改配置

存储目录

• storage/app/public 应该被忽略
• storage/framework/cache 和 storage/framework/sessions 也应忽略

Composer 依赖

• 提交 composer.json 和 composer.lock
• 不提交 vendor/ 目录

6. 分支策略建议

推荐使用 Git Flow 或类似分支策略：

# 创建开发分支
git checkout -b develop

# 功能开发使用功能分支
git checkout -b feature/your-feature-name

# 完成后合并到 develop
git checkout develop
git merge feature/your-feature-name

7. 部署注意事项

对于生产部署：

# 克隆项目
git clone https://github.com/yourusername/your-repo.git

# 安装依赖
composer install --no-dev

# 生成应用密钥
php artisan key:generate

# 其他部署步骤...

8. 常用 Git 工作流程

# 拉取最新代码
git pull origin develop

# 查看状态
git status

# 查看变更
git diff

# 提交更改
git add .
git commit -m "Your commit message"
git push origin your-branch-name

9. 使用 Git Hooks 自动化

可以在 .git/hooks/ 中添加钩子脚本，例如： - 提交前运行 PHPUnit 测试 - 推送前运行代码风格检查

10. 协作开发建议

1. 定期从主分支拉取更新
2. 保持提交信息清晰明确
3. 一个功能/修复对应一个分支
4. 使用 Pull Request/Merge Request 进行代码审查

通过以上步骤，您可以在 Linux 环境下有效地对 Laravel 项目进行版本控制，保持代码的安全性和可追溯性。