PHP file_put_contents因文件所有权问题致权限拒绝的解决问询

为什么文件夹所有权为cpanelusername:cpanelusername时PHP无法生成文件？ #

PHP当前以nobody用户运行，而invoices文件夹的所有权是cpanelusername:cpanelusername——nobody用户既不属于该文件夹的所有者用户，也不在对应的用户组内，因此没有文件夹的写入权限，自然无法创建PDF文件。

之前功能正常，大概率是服务器的PHP运行模式被修改了（比如从suPHP/PHP-FPM单用户模式改成了mod_php共享nobody用户模式），导致PHP的运行用户和文件夹所有者不再匹配。

可行解决方案（无需设置777权限） #

方案1：调整文件夹用户组与组权限 #

1. 将invoices文件夹的用户组改为nobody：

   chown cpanelusername:nobody invoices
   

2. 给文件夹添加组写入权限：

   chmod 775 invoices
   

   这样nobody用户所在的组拥有写入权限，PHP能正常生成文件；同时文件夹所有者还是cpanelusername，访客访问时不会有权限问题。

   补充：生成的PDF文件默认会继承文件夹的用户组，若需要让文件也能被访客正常读取，可在PHP生成文件后设置文件权限：

   $filePath = 'invoices/999999.pdf';
   file_put_contents($filePath, $pdfContent);
   // 设置文件权限为所有者可读可写，组和其他可读
   chmod($filePath, 0644);
   

方案2：生成文件后自动修改所有权 #

在file_put_contents成功执行后，用PHP内置函数修改文件的所有权为cpanelusername:cpanelusername：

$filePath = 'invoices/999999.pdf';
if (file_put_contents($filePath, $pdfContent)) {
    chown($filePath, 'cpanelusername');
    chgrp($filePath, 'cpanelusername');
}

注意：此方案需要确保nobody用户拥有修改文件所有权的权限，部分主机环境可能需要联系服务商开放相关权限。

方案3：切换PHP运行模式 #

联系主机服务商，将PHP运行模式切换为suPHP或PHP-FPM单用户模式。这种模式下PHP会以cpanelusername用户运行，和文件夹所有者一致，从根源上解决权限不匹配的问题，也是最稳定的方案。

内容的提问来源于stack exchange，提问作者Ryan