ThinkPHP环境部署之文件读写异常_Linux所有者与组权限调整-ThinkPHP-PHP中文网

file_put_contents在thinkphp中返回false，主要是web服务器进程（如www-data）对runtime目录无写权限；需确认进程用户、检查目录属主与权限、设置chown -r www-data:www-data runtime/和chmod -r 775 runtime/。

thinkphp环境部署之文件读写异常_linux所有者与组权限调整

为什么 `file_put_contents` 在 ThinkPHP 中返回 false？

多半是 Web 服务器进程（如 www-data 或 nginx）没权限往目标目录写文件，不是代码写错了。ThinkPHP 的日志、缓存、上传临时目录都依赖真实文件系统权限，PHP 脚本运行时身份和你登录终端的用户完全不是一回事。

先用 ps aux | grep nginx 或 ps aux | grep apache 确认 Web 进程实际以哪个用户运行
再用 ls -ld /path/to/runtime 查看目录所有者和组，比如显示 drwxr-xr-x 1 root root，那 www-data 用户就写不进去
别直接 chown -R root:www-data runtime/ —— root 写不了，但 www-data 可以读；要让 www-data 拥有写权，得是 chown -R www-data:www-data runtime/
如果目录属主是 root 且不想改属主，可用 chmod g+w runtime/ + 把 www-data 加进对应组（如 usermod -aG root www-data），但组权限容易漏掉子目录，不推荐

`chmod 755` 和 `775` 对 ThinkPHP runtime 目录到底差在哪？

关键在「组是否可写」。ThinkPHP 默认把缓存、日志、模板编译文件全扔进 runtime/，而 PHP-FPM 或 Apache 的子进程默认不继承你的用户组权限，只认文件属组 + 权限位。

755：属主可读写执行，属组和其他人只能读+执行 → 组成员无法创建或覆盖文件 → file_put_contents 失败，错误日志里常带 failed to open stream: Permission denied
775：属组也获得写权限 → 只要 Web 进程用户属于该目录属组，就能写 → 更安全，比 777 少暴露“其他人”权限
执行顺序很重要：先 chown -R www-data:www-data runtime/，再 chmod -R 775 runtime/；反过来设权限再改属主，可能被 umask 截断
注意 chmod -R 会把所有子文件也设成 775，其实 .php 缓存文件只需 644，但目录必须 775，所以更稳妥的是 find runtime -type d -exec chmod 775 {} \;

Linux 下 `setfacl` 能替代 `chown` 吗？

能，但 ThinkPHP 部署中一般没必要。ACL 是精细授权工具，适合多用户协作环境；单机部署用好属主+组+权限位就够了，加 ACL 反而增加排查复杂度。

Linux installer

先解析安全源，运行本地CLI安装、启动、卸载Linux桌面应用。用户请求时使用。

下载

常见误操作：setfacl -m u:www-data:rwx runtime/ 看似解决了，但新生成的子目录默认不继承 ACL，得加 -d 参数设默认 ACL，否则下层 log/ 或 cache/ 依然写失败
ACL 权限和传统权限共存时，Linux 优先按 ACL 判定，但 ls -l 不直观显示，得用 getfacl runtime/ 才能看到，线上排查容易漏
部分老旧生产环境（如某些 CentOS 6 镜像）默认没启用 ACL 支持，mount 输出里没有 acl 选项，setfacl 会静默失败

ThinkPHP 的 `runtime` 目录为什么不能放在 `/tmp`？

因为 /tmp 通常挂载了 noexec 或 nosuid 选项，且部分系统定时清理，更重要的是——它默认权限是 1777（带 sticky bit），导致 PHP 创建的子目录继承不了写权限。

mkdir /tmp/thinkphp_runtime 后，ls -ld /tmp/thinkphp_runtime 很可能显示 drwxr-xr-x，而不是预期的 drwxrwxr-x，因为 /tmp 的 sticky bit 会压制新建目录的组写权限
即使强行 chmod 775，下次系统重启或 tmpwatch 清理后就没了
Web 进程对 /tmp 有写权，不代表对里面某个子目录有写权——权限判定是逐级检查的，/tmp 的 1777 不自动下放
正确做法是把 runtime 放到项目根目录下（如 /var/www/myapp/runtime），然后统一调所有权和权限

真正卡住人的往往不是命令记不牢，而是没意识到 Web 进程用户、目录属主、umask、挂载选项这四者会咬合出意料之外的权限状态。调一次 id -a（看 Web 进程用户）、ls -ld（看目录）、mount | grep $(df . | tail -1 | awk '{print $1}')（看挂载选项），比反复改 chmod 有用得多。