[函数]dirname()函数—用法及示例

函数名称：dirname()

适用版本：所有 PHP 版本

函数用法：dirname() 函数返回路径中的目录部分。

语法：dirname( string $path [, int $levels = 1 ] ) : string

参数：

• $path：要获取目录部分的路径，可以是相对路径或绝对路径。
• $levels（可选）：指定要向上返回的目录层级，默认为 1。

返回值：返回指定路径的目录部分，如果没有目录部分，则返回一个点（.）。

注意事项：

• 如果给定的路径是一个相对路径，将会使用当前执行脚本的目录。
• 如果 $path 为空，返回 "." 。
• 目录分隔符在 Windows 下是 ""，在 Unix/Linux 下是 "/"。

示例：

// 示例 1:
$path = "/home/user/test/file.txt";
$dir = dirname($path);
echo $dir;  // 输出: /home/user/test

// 示例 2:
$path = "test/file.txt";
$dir = dirname($path);
echo $dir;  // 输出: test

// 示例 3:
$path = "file.txt";
$dir = dirname($path);
echo $dir;  // 输出: .

// 示例 4:
$path = "/var/www/html/";
$dir = dirname($path);
echo $dir;  // 输出: /var/www/html

// 示例 5:
$path = "C:\Program Files\Apache\htdocs\";
$dir = dirname($path);
echo $dir;  // 输出: C:\Program Files\Apache\htdocs

在示例 1 中，给定一个绝对路径，函数返回路径的目录部分 "/home/user/test"。

在示例 2 中，给定一个相对路径，函数返回路径的目录部分 "test"。

在示例 3 中，给定一个只有文件名的路径，函数返回当前目录 "."。

在示例 4 中，给定一个以目录路径结尾的路径，函数返回相同的目录路径 "/var/www/html"。

在示例 5 中，给定一个 Windows 路径，函数返回相同的目录路径 "C:\Program Files\Apache\htdocs"。