一、理解文件上传机制与常见错误
在web应用中，用户上传文件（如图片、文档）是常见功能。php通过$_files全局数组处理上传的文件，并通过move_uploaded_file()函数将临时目录中的文件移动到指定的目标位置。然而，开发者在实现此功能时，常会遇到“permission denied”（权限拒绝）错误，导致文件无法保存。
当move_uploaded_file()函数返回bool(false)，并在错误日志中出现类似以下警告时，通常意味着目标目录的写入权限不足：
Warning: move_uploaded_file(img/textak.txt): failed to open stream: Permission denied in /home/kloucto2/www/create_new_article.php on line 21 Warning: move_uploaded_file(): Unable to move '/tmp/phpxRsCsr' to 'img/textak.txt' in /home/kloucto2/www/create_new_article.php on line 21
这个错误的核心在于，运行PHP脚本的Web服务器用户（例如Apache的www-data或apache，Nginx的nginx或www-data）没有权限在指定的img/目录下创建或写入文件。在Linux/Unix系统中，文件和目录的访问权限是严格控制的，只有拥有相应权限的用户或组才能执行读、写、执行操作。
二、诊断与解决权限问题
解决Permission denied错误的关键在于正确配置目标目录的权限。
2.1 检查目标目录路径
首先，确保PHP代码中指定的$target_dir变量指向的目录确实存在，并且路径是正确的。相对路径（如img/）是相对于当前执行PHP脚本的目录而言的。
立即学习“PHP免费学习笔记（深入）”；
if (($_FILES['thumbnail']['name']!="")){
$target_dir = "img/"; // 确保这个目录存在且路径正确
$file = $_FILES['thumbnail']['name'];
$path = pathinfo($file);
$filename = $path['filename'];
$ext = $path['extension'];
$temp_name = $_FILES['thumbnail']['tmp_name'];
$path_filename_ext = $target_dir.$filename.".".$ext;
var_dump(move_uploaded_file($temp_name,$path_filename_ext));
}2.2 验证目录权限
在Linux/Unix终端中，使用ls -ld命令检查目标目录的当前权限：
ls -ld img/
输出示例可能如下：
drwxr-xr-x 2 user group 4096 Jan 1 10:00 img/
其中：
- d 表示这是一个目录。
- rwxr-xr-x 是权限位，分别代表所有者、组和其他用户的读（r）、写（w）、执行（x）权限。
- rwx = 读、写、执行（数字表示为 7）
- r-x = 读、执行（数字表示为 5）
- r-- = 读（数字表示为 4）
- --x = 执行（数字表示为 1）
- --- = 无权限（数字表示为 0）
如果Web服务器用户不属于user或group，且“其他用户”没有写入权限（即第三组权限位不是w），则会出现Permission denied。
解决方案：使用chmod命令修改目录权限
为了允许Web服务器用户写入，您需要赋予目标目录写入权限。
-
临时解决方案（不推荐用于生产环境）：
chmod 777 img/
这将赋予所有用户对img/目录的读、写、执行权限。虽然能解决问题，但777权限过于开放，存在严重安全风险，可能被恶意用户利用。
-
更安全的通用解决方案：
chmod 755 img/
此命令赋予所有者读写执行权限，组和其他用户只读执行权限。这通常是目录的推荐权限，但前提是运行PHP的Web服务器用户是该目录的所有者，或者该用户属于该目录的组。
-
针对Web服务器用户的特定解决方案： 如果Web服务器用户（例如www-data）不属于img/目录的所有者或组，但您希望它能写入，可以考虑：
chmod o+w img/
这将只为“其他用户”（others）添加写入权限。
2.3 验证目录所有者与组
如果chmod 755仍无法解决问题，可能是因为Web服务器用户既不是目录的所有者，也不属于其组。在这种情况下，您需要更改目录的所有者或组，使其与Web服务器用户匹配。
首先，确定Web服务器运行的用户和组。这通常可以在Web服务器的配置文件（如Apache的httpd.conf或Nginx的nginx.conf）中找到User和Group指令。常见的用户有www-data、apache、nginx等。
解决方案：使用chown命令修改所有者和组
假设Web服务器用户是www-data，组也是www-data：
sudo chown www-data:www-data img/
执行此命令后，img/目录的所有者和组都将变为www-data。然后，结合chmod 755 img/，Web服务器用户就拥有了对该目录的读写执行权限。
三、PHP文件上传代码示例与最佳实践
除了权限配置，健壮的PHP文件上传代码也至关重要。
3.1 核心PHP代码示例
以下是一个更完善的PHP文件上传代码示例，包含了基本的错误处理、安全考量和权限检查：
3.2 HTML表单配置
确保您的HTML表单正确配置了文件上传所需的enctype属性：
enctype="multipart/form-data"是文件上传的必要属性，它告诉浏览器以特殊方式编码表单数据，以便服务器能够正确解析文件内容。
3.3 安全注意事项
- 文件命名： 永远不要直接使用用户上传的文件名。生成一个唯一的文件名（如使用uniqid()或哈希值），以防止文件名冲突、路径遍历攻击和注入恶意脚本。
- 文件类型验证： 不要仅仅依赖文件扩展名。攻击者可以轻易更改文件扩展名。更安全的做法是检查文件的MIME类型（使用finfo_open()或getimagesize()），甚至在服务器端进一步检查文件内容。
- 文件大小限制： 在PHP配置（php.ini中的upload_max_filesize和post_max_size）和后端代码中限制文件大小，同时在前端提供提示。
- 存储位置： 尽量将上传的文件存储在Web服务器的根目录之外（即用户无法通过URL直接访问的目录）。如果必须存储在可访问的目录中，确保该目录没有执行脚本的权限，以防止上传的恶意脚本被执行。
- 权限最小化： 赋予上传目录的权限应尽可能小，仅允许Web服务器用户进行写入操作，避免给予777等过于宽松的权限。
总结
Permission denied是PHP文件上传中最常见的错误之一，其根本原因在于Web服务器用户对目标目录没有写入权限。通过正确理解Linux/Unix的文件权限模型，并使用chmod和chown命令进行精确配置，可以有效地解决这一问题。同时，在编写PHP文件上传代码时，务必考虑安全性，采取生成唯一文件名、严格验证文件类型和大小、以及合理设置存储位置等最佳实践，以构建健壮、安全的文件上传功能。
