函数名称: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"。