Git 不跟踪 chmod 设置的完整权限(如644与600差异),仅记录可执行位(100755/100644)和目录权限(755),PHP 的 chmod() 仅影响系统权限,不触发 Git 状态变更;是否显示权限变化取决于 core.filemode 配置。

PHP 修改文件权限不影响 Git 仓库状态
Git 只跟踪文件内容和部分元数据(如可执行位),但不记录 chmod 设置的完整权限(比如 644 和 600 的差异)。你在 PHP 中用 chmod() 改了某个文件的权限,Git 不会把它标记为“已修改”——除非该文件本身内容变了。
常见误解是:改完权限后 git status 没反应,就以为没生效。其实它确实生效了(ls -l 能看到),只是 Git 默认不关心这个。
- Git 仅记录三种权限状态:
644(普通文件)、755(目录)、755或644对应的可执行位(通过git update-index --chmod=+x控制) - PHP 的
chmod()函数操作的是操作系统层面的权限,对 Git 工作区无副作用 - 如果文件原本是
644,你用 PHP 改成600,Git 完全感知不到;但若改成755且该文件本不可执行,Git 有可能在某些配置下提示“mode change”,这取决于core.filemode
git config core.filemode false 是常见误配点
很多团队在 Windows 或 Docker 环境中把 core.filemode 设为 false,目的是忽略权限变更。结果就是:无论你用 PHP、shell 还是 IDE 改权限,Git 都不会 diff 出来。
检查当前设置:
git config --get core.filemode
立即学习“PHP免费学习笔记(深入)”;
- 返回
true:Git 会尝试检测并记录可执行位变化(仅限+x/-x) - 返回
false:Git 彻底忽略所有权限变更,包括 PHP 的chmod() - 想让 Git 响应可执行位变化?运行
git config core.filemode true(需确保文件系统支持)
PHP 中安全地设置可执行脚本权限并同步到 Git
如果你真有一个 PHP 脚本要作为命令行工具被 Git 跟踪,并希望它在 clone 后自动可执行,不能只靠 PHP chmod() —— 因为那只是本地临时操作,不进版本库。
- 正确做法是:先用 shell 设置权限,再
git add,Git 才会记录可执行位chmod +x bin/deploy.php
git add bin/deploy.php - 等价的 Git 命令(不改系统权限,只改 Git 记录):
git update-index --chmod=+x bin/deploy.php - PHP 中调用
shell_exec('chmod +x ...')可以辅助,但关键还是后续的git add操作 - 别在部署脚本里反复
chmod:既没必要,也可能因用户权限失败(如 webserver 用户无权改仓库文件)
权限修改后 git status 仍为空?先看是不是 content-only 变更
这是最常让人困惑的点:明明 ls -l 显示权限变了,git status 却干净得像什么都没发生。
- 运行
git status --ignored排除忽略文件干扰 - 用
git ls-files --stage | grep "bin/script.php"查看 Git 实际记录的 mode(第三列),比如100755表示可执行,100644表示普通 - 对比
stat -c "%a %n" bin/script.php看实际文件权限,二者本就不需要一致(Git 不存600这种细节) - 真正影响协作的是:你 push 的 commit 是否包含可执行位变更。其他人 pull 后,Git 会按自己的
core.filemode和文件系统能力决定是否还原该位











