php unlink 删除不了文件？检查这几点权限设置问题！

发布日期： 2025-10-23 阅读量： 作者： admin

今天正好有点空闲，就想着捣鼓一下 PHP 里那个删文件的函数，叫 `unlink`。平时项目里也时不时会用到，比如删用户上传的临时图片，或者清理一些过期的缓存文件啥的。虽然感觉挺简单的，但有时候手生了或者遇到点特殊情况就容易卡壳，所以还是自己动手跑一遍心里踏实。

我就先在我的开发环境里，随便找了个目录，比如 `/www/test/` 目录下，手动创建了一个名叫 `*` 的文本文件。里面随便写了点字，比如“这是个测试文件”。

然后，我在这个目录外面一点的地方，新建了一个 PHP 文件，就叫 `delete_*` 。打开这个 PHP 文件，最开始就想试试最直接的用法。

我就写了这么一句：

unlink('/www/test/*');

写完保存，然后在浏览器里访问这个 `delete_*`。刷新了一下 `/www/test/` 目录，那个 `*` 文件果然不见了。看来基本功能是没问题的，挺好使。

但是， 我就想，实际用的时候肯定不能这么草率。万一文件不存在？或者 PHP 没权限删？这些都得考虑进去。

所以我就先把刚才删掉的 `*` 又重新创建了一个。这回我先试试文件不存在的情况。我故意把 PHP 文件里的路径写错，改成：

unlink('/www/test/nonexistent_*');

再访问 `delete_*`，果然，页面上直接就报了个警告（Warning），说 `unlink(/www/test/nonexistent_*): No such file or directory`。这不行，程序里出这种警告肯定不

于是我就想起来，删之前最好先判断一下文件到底在不在。我就改了下代码，加上了 `file_exists()` 判断：

<?php
$filePath = '/www/test/*'; // 把路径存变量里，好管理
if (file_exists($filePath)) {
// 文件存在，再尝试删除
if (unlink($filePath)) {
echo '文件删除成功！';
} else {
echo '文件删除失败！可能是权限问题？';

} else {
echo '文件压根儿就不存在！';

?>

这样一改，我再故意把 `$filePath` 改成一个不存在的文件路径，访问页面就只会输出“文件压根儿就不存在！”了，不会再报那个刺眼的警告，看起来舒服多了。

就是权限问题了。这也是个大头。在 Linux 服务器上，PHP 脚本通常是通过 Web 服务器（比如 Apache 或 Nginx）的用户来跑的，一般是 `www-data` 或者 `apache` 这类的用户。如果这个用户对要删除的文件没有写入权限（删除文件需要对文件所在的目录有写入权限，对文件本身有时也需要有写入权限，具体看系统和配置），那 `unlink` 就会失败。

我就手动把 `/www/test/*` 的权限改了一下，比如用 `chmod 444 *`，让它变成只读。然后确保 `$filePath` 是正确的，再跑上面的脚本。这回`file_exists()` 判断通过了，进到了 `unlink()` 那一步，但是 `unlink()` 执行失败了，页面输出了“文件删除失败！可能是权限问题？”。PHP 的错误日志里（如果开了的话）通常也会记录一个 Permission denied 的错误。

为了让程序更健壮，删之前除了检查文件是否存在，最好再检查一下是否有写入权限。PHP 里有个函数叫 `is_writable()` 可以干这事。我就又把代码完善了一下：

<?php
$filePath = '/www/test/*';
if (file_exists($filePath)) {
// 先判断文件是否存在
if (is_writable($filePath)) { // 再判断文件是否可写（通常意味着可删）
// 都满足了，再动手删除
if (unlink($filePath)) {
echo '文件删除成功！';
} else {
// 理论上能写就能删，如果还失败，可能就是更奇怪的原因了
echo '文件删除失败！原因比较罕见。';

} else {
echo '文件存在，但是没权限删除！';

} else {
echo '文件压根儿就不存在！';

?>

这样一来，代码就比较稳了。先看在不在，再看能不能动，才真动手。每一步都有对应的提示，排查问题也方便。

关于中文文件名

我还想到之前好像在哪看到过，说删中文名的文件可能会有编码问题。比如 PHP 文件是 UTF-8 编码，但服务器操作系统（特别是 Windows）默认可能是 GBK 编码。直接用 UTF-8 的中文文件名去 `unlink`，系统可能不认。

我就试了试，在 `/www/test/` 目录下建了个文件叫 `测试文件.txt`。然后把 `$filePath` 改成 `/www/test/测试文件.txt`。在我这个 Linux + UTF-8 的环境里跑了一下，没问题，直接就删掉了。

不过为了保险起见，如果你的环境比较复杂，或者不确定服务器是啥编码，可能真得像网上说的那样，在 `unlink` 之前，用 `iconv()` 或者 `mb_convert_encoding()` 把文件名从 PHP 脚本的编码（通常是 UTF-8）转换成操作系统能识别的编码（比如 GBK）。类似这样（没实际跑，只是个思路）：

$filePathEncoded = iconv('UTF-8', 'GBK', $filePath);
unlink($filePathEncoded);

现在大部分现代服务器环境都统一用 UTF-8 了，这个问题可能没那么常见了，但知道有这么个坑总是好的。

今天把 `unlink` 这东西从头到尾捋了一遍，把各种可能遇到的情况都试了试，感觉心里更有底了。虽然是个小函数，但用好它，保证程序的稳定不出错，还是得注意这些细节判断。

上一篇: 稳定又好用的服务器系统租用？这几个方案值得看看！

下一篇: Apache配置虚拟主机教程：图文详解，一看就懂！

php unlink 删除不了文件？检查这几点权限设置问题！

随便看看