Debian PHP如何进行代码版本控制

Debian PHP项目的版本控制实践

一 基础环境准备

• 在 Debian 上安装并初始化 Git，为提交绑定身份：
  • 安装：sudo apt update && sudo apt install git
  • 配置：git config --global user.name "Your Name" 与 git config --global user.email "your.email@example.com"
• 在 PHP 项目中启用版本控制：
  • 进入项目目录：cd /path/to/your/php/project
  • 初始化仓库：git init
  • 纳入版本管理：git add .
  • 提交更改：git commit -m "Initial commit"

二 远程仓库与日常协作

• 在 GitHub/GitLab/Bitbucket 创建空仓库，获取远程地址（HTTPS 或 SSH）。
• 关联并推送：
  • 关联：git remote add origin <repository-url>
  • 首次推送：git push -u origin master（若默认分支为 main，将 master 替换为 main）
• 日常同步与协作：
  • 拉取更新：git pull origin master
  • 推送本地：git push
• 分支工作流建议：
  • 功能开发：git checkout -b feature/xxx
  • 修复缺陷：git checkout -b hotfix/xxx
  • 合并回主干：git checkout master && git merge feature/xxx，必要时处理冲突后提交

三 忽略文件与环境管理

• 使用 .gitignore 忽略不应纳入版本控制的文件，示例：
  • 编辑器与系统：*.swp, *.swo, .idea/, .vscode/
  • 依赖与构建：vendor/, node_modules/, composer.lock（团队约定二选一）、package-lock.json
  • 运行与日志：runtime/, var/, storage/, *.log, .env
• 环境配置分离：将本地或生产的敏感配置放入 .env，并在仓库中提供 .env.example 作为模板，避免泄露密钥与数据库口令。

四 数据库变更与版本化

• 将数据库变更纳入版本管理，常见做法：
  • 结构变更脚本：使用迁移工具（如 Phinx、Laravel Migrations）生成可回滚的 SQL，放入 migrations/，随代码一起提交与发布。
  • 数据备份脚本：定期导出结构与数据快照，例如 mysqldump -u username -p database_name > database_backup.sql，提交到仓库以便追溯与回滚（注意脱敏与访问控制）。

五 自动化部署与IDE集成

• 使用 Ansible 实现从代码到服务的自动化部署（示例要点）：
  • 安装：sudo apt install php php-cli php-fpm git ansible
  • 拉取代码：git clone 或 git pull 到部署目录（如 /var/www/yourapp）
  • 安装依赖：composer install --no-interaction --prefer-dist
  • 重启服务：systemctl restart php7.4-fpm 与 systemctl restart nginx
  • 通过 Playbook 编排上述步骤，实现一键部署与滚动更新
• 在 PhpStorm 中集成版本控制（Debian 桌面环境）：
  • 启用 VCS：VCS > Enable Version Control Integration > Git
  • 远程与推送：VCS > Git > Remotes 添加地址；Git > Repository > Push 推送；VCS > Git > Pull 拉取
  • 适合在 IDE 内完成提交、分支、解决冲突与代码审查等日常操作