pathinfo 的 PATHINFO_DIRNAME 是如何工作的？

gitbox 2025-06-03

在 PHP 中，pathinfo() 函数是用来解析文件路径的一个非常实用的函数。它可以帮助我们快速地获取路径中的各种组成部分，比如目录名、文件名、扩展名等等。而在这些组成部分中，PATHINFO_DIRNAME 常常被初学者忽略或误解。今天，我们就来深入了解一下 PATHINFO_DIRNAME 到底是什么，它的作用是什么。

什么是 pathinfo 函数？

pathinfo() 函数用于解析一个文件路径，并返回路径的组成信息。它的基本语法是：

pathinfo(string $path, int $options = PATHINFO_ALL): array|string

$path：要解析的文件路径。
$options：指定要获取的信息部分。可以是以下常量之一：
- PATHINFO_DIRNAME：返回路径中的目录部分
- PATHINFO_BASENAME：返回文件名（包含扩展名）
- PATHINFO_EXTENSION：返回文件扩展名
- PATHINFO_FILENAME：返回文件名（不包含扩展名）
- 如果不指定，默认返回包含上述所有信息的关联数组。

PATHINFO_DIRNAME 是什么？

PATHINFO_DIRNAME 是 pathinfo() 函数的一个选项，表示只返回路径中的目录部分。换句话说，它告诉你文件所在的目录路径，而不包含文件名本身。

例如：

<?php
$path = "/var/www/html/index.php";
$dirname = pathinfo($path, PATHINFO_DIRNAME);
echo $dirname;
?>

输出：

/var/www/html

这里 PATHINFO_DIRNAME 就返回了文件所在的目录 /var/www/html，而不是文件名 index.php。

作用与场景

PATHINFO_DIRNAME 的作用主要体现在以下几个方面：

获取文件所在目录
当你只想知道文件在哪个目录，而不关心文件名时，使用 PATHINFO_DIRNAME 非常方便。
目录操作
在对文件路径进行操作，比如移动文件、复制文件，或生成新文件路径时，常常需要先得到目录部分。
防止路径错误
在拼接路径时，先获取目录路径，再追加新的文件名或子目录，可以避免路径拼接错误。

结合实际示例

假设你有一个上传的文件路径，你想要得到文件所在目录，并在该目录下生成一个新的文件：

<?php
$uploadPath = "/uploads/images/photo.jpg";

// 获取目录名
$dir = pathinfo($uploadPath, PATHINFO_DIRNAME);

// 生成新文件路径
$newFile = $dir . "/photo_thumb.jpg";

echo "新文件路径：" . $newFile;
?>

输出：

新文件路径：/uploads/images/photo_thumb.jpg

通过 PATHINFO_DIRNAME，我们很方便地拿到了上传文件的目录，并生成了同目录下的新文件路径。

注意事项

当路径中不包含目录部分时，PATHINFO_DIRNAME 会返回一个点 "."，表示当前目录：

<?php
$path = "file.txt";
echo pathinfo($path, PATHINFO_DIRNAME);
?>

输出：

PATHINFO_DIRNAME 只返回目录路径，不包含文件名或扩展名。
在 Windows 系统中，路径分隔符是反斜杠 \，pathinfo 会自动处理。

总结

PATHINFO_DIRNAME 是 pathinfo() 函数的重要选项，用来获取路径中的目录部分。它在文件路径处理和目录操作中非常有用，能够帮助你轻松获取文件的所在目录，便于后续的路径拼接和文件操作。

掌握它的用法，能让你在 PHP 中处理文件路径更加游刃有余。

<?php
$examplePath = "https://gitbox.net/path/to/file.txt";
$dirName = pathinfo($examplePath, PATHINFO_DIRNAME);
echo $dirName; // 输出：https://gitbox.net/path/to
?>

pathinfo