PHP项目需用Git管理而非PHP自身版本控制，重点在于.gitignore合理配置（如vendor/、.env、缓存目录）、composer.lock必须提交、多PHP版本下通过phpbrew/asdf统一CLI环境，并确保所有.php文件为UTF-8无BOM编码。
PHP 本身没有内置的“版本控制”功能——你真正需要的是把 PHP 项目纳入 Git 管理，并合理处理 PHP 版本差异带来的兼容性问题。自学重点不在“PHP 做版本控制”，而在“用 Git 管理 PHP 项目”和“在多 PHP 版本环境中安全开发”。
Git 初始化 PHP 项目时忽略哪些文件
刚建好 composer.json 就提交？别急。PHP 项目里大量生成文件、依赖和敏感配置不该进仓库。
-
vendor/—— Composer 安装的包，靠composer install恢复，必须加进.gitignore -
composer.lock—— 必须提交！它锁定依赖精确版本，否则不同人composer install可能装出不一致行为 -
.env—— 环境变量文件，含数据库密码等，绝对不提交；用.env.example提交作模板 -
storage/和bootstrap/cache/（Laravel）或cache/（ThinkPHP）—— 运行时写入目录，忽略
切换 PHP 版本时 Composer 报错 “Package … requires php ^8.1”
这是最常见但容易被误解的问题：不是 Composer 本身坏了，而是当前 PHP CLI 版本不满足 composer.json 中声明的 php 平台要求。
- 先确认 CLI 版本：
php -v，不是浏览器里phpinfo()显示的那个 - 检查
composer.json的"platform": {"php": "..."}或"require": {"php": "..."}字段 - 临时绕过检查（仅调试用）：
composer install --ignore-platform-reqs，但上线前务必修复版本匹配 - 长期方案：用
phpbrew或asdf管理多 PHP 版本，再用alias php=~/php/8.1/bin/php绑定 CLI
Git 提交后发现 .php 文件编码是 GBK，导致 Linux 服务器解析失败
Windows 默认记事本保存为 GBK，而 PHP 解析器（尤其 Linux 上的 PHP-FPM）默认按 UTF-8 读取源码——混用会直接报 Parse error: syntax error, unexpected 'xxx'。
立即学习“PHP免费学习笔记（深入）”；
- 编辑器必须设为 UTF-8 无 BOM（VS Code 默认是，Sublime/Notepad++ 需手动选）
- 用命令行批量转码（Linux/macOS）：
find . -name "*.php" -exec iconv -f GBK -t UTF-8 {} -o {}.utf8 \; && rename 's/\.php\.utf8$/.php/' *.php.utf8 - Git 本身不处理编码，但可配
core.autocrlf和core.safecrlf防止换行符污染，不过这和编码无关，别混淆
真正的难点不在学会命令，而在于每次切环境（本地/测试/生产）时，同步确认三件事：PHP CLI 版本、composer.json 中的 php 要求、以及所有 .php 文件的实际编码。漏掉任意一个，都可能让代码在某处静默崩溃。
