直接在php项目根目录运行git init即可初始化git仓库,随后须创建.gitignore忽略vendor/、.env等文件,显式添加核心文件而非git add .,并配置正确的git user.name和user.email。

直接在 PHP 项目根目录运行 git init
PHP 本身不提供版本控制能力,所谓“初始化 PHP 项目版本库”,本质是为存放 PHP 文件的目录初始化 Git 仓库。只要项目文件已存在(比如有 index.php、composer.json 或 vendor/),进入该目录后执行:
git init即可创建
.git 子目录,完成版本库初始化。
常见错误是误以为要先写 PHP 代码再“注册”到 Git——Git 只认目录和文件,跟语言无关。哪怕目录里只有 README.md,也能 git init。
初始化后必须做三件事:忽略 vendor/、.env、缓存文件
PHP 项目常含大量不应提交的生成物或敏感配置,不加处理会导致仓库臃肿或泄露密钥。立即创建 .gitignore 并填入:
-
/vendor/— Composer 依赖,由composer install重建 -
.env— 环境变量文件,本地配置不应进仓库 -
/storage/framework/cache/、/storage/framework/sessions/— Laravel 类框架的运行时缓存 -
/var/、/logs/(若存在)— 日志和临时文件
没加 .gitignore 就先 git add .,很可能把整个 vendor/ 提交进去,后续清理麻烦且污染历史。
立即学习“PHP免费学习笔记(深入)”;
citySHOP是一款集CMS、网店、商品、分类信息、论坛等为一体的城市多用户商城系统,已完美整合目前流行的Discuz! 6.0论坛,采用最新的5.0版PHP+MYSQL技术。面向对象的数据库连接机制,缓存及80%静态化处理,使它能最大程度减轻服务器负担,为您节约建设成本。多级店铺区分及联盟商户地图标注,实体店与虚拟完美结合。个性化的店铺系统,会员后台一体化管理。后台登陆初始网站密匙:LOVES
git add 时别用 git add . 直接全加
尤其当项目刚运行过 composer install 或框架命令(如 php artisan config:cache),目录里可能已混入不该跟踪的文件。更安全的做法是:
- 先
git status -u看哪些是未跟踪文件 - 用
git add index.php composer.json README.md显式添加核心文件 - 确认无误后再
git add src/ app/ config/等逻辑目录 - 避免
git add .一次吞掉所有未跟踪项
很多团队踩坑在于第一次提交就带进了 vendor/autoload.php 或 .env.example 的错误副本,后期改名或删文件都留有历史痕迹。
首次提交前检查 git config 用户信息是否正确
Git 提交需要绑定作者身份,如果全局没设或设错,会导致提交记录显示 unknown@localhost 或邮箱不统一,影响协作追溯。运行以下命令确认:
git config --global user.name "Your Name"<br>git config --global user.email "you@example.com"
若只想对当前项目单独设置(比如工作/个人邮箱混用),去掉 --global,并在项目目录内运行:
git config user.name "Team Name"<br>git config user.email "team@company.com"
注意:git config 输出为空或报错,说明配置缺失;提交后发现作者名异常,基本就是这里没配好——不是 PHP 问题,但直接影响版本库可信度。










