PHP 文件系统 dirname() 函数



PHP 文件系统dirname()函数用于获取文件路径的目录部分。在处理文件路径并希望将目录路径与文件名分开时,此函数非常有用。dirname()返回包含您指定为文件路径的文件的目录的路径。此外,您可以选择要遍历的目录级别数。

dirname()函数的常见用例包括组织文件路径、导航目录以及管理PHP应用程序中的文件系统结构。

语法

以下是PHP文件系统dirname()函数的语法:

string dirname ( string path, int levels )

参数

使用dirname()函数所需的参数如下所示:

序号 参数及说明
1

path (必需)

这是文件的路径。

2

levels (可选)

此参数显示您要访问的目录级别数。默认情况下,它返回1,即直接父目录。如果将其设置为2,它将向上移动两个级别,依此类推。

返回值

该函数返回一个包含给定文件路径的目录路径的字符串。

PHP 版本

dirname()函数最初作为PHP 4核心的一部分引入,并与PHP 5、PHP 7、PHP 8良好兼容。

示例

首先,我们将了解PHP文件系统dirname()函数的简单用法。我们将简单地输出dirname()函数中指定路径的dirname()。

<?php
   echo dirname("C:/PhpProject/index.php") . "\n";
   echo dirname("/PhpProject/index.php");
?>

输出

这将产生以下结果:

C:/PhpProject
/PhpProject

示例

在下面的代码中,我们将看到如何通过使用dirname()函数的可选参数,在给定的目录路径中向上移动多个目录级别。

<?php
   // define file path here
   $filePath = "/var/www/html/index.php";

   // use dirname function and pass both the parameters
   $parentDirectory = dirname($filePath, 2);

   // print the parent directory detail
   echo $parentDirectory; 
?> 

输出

这将生成以下输出:

/var/www

示例

此示例演示如何使用dirname()函数获取当前脚本文件的目录。我们使用了PHP魔术常量__FILE__,它表示当前正在运行的脚本的完整路径和文件名。因此,dirname(__FILE__)可用于确定当前脚本文件的目录名。

<?php
   $sdir = dirname(__FILE__);
   echo $sdir; 
?> 

输出

这将导致以下结果:

/Applications/XAMPP/xamppfiles/htdocs/mac

注意

  • dirname()可在基于Unix和Windows的平台上使用。它对Windows使用\,对Unix使用/作为目录分隔符。
  • 它可以与绝对路径或相对路径一起使用。例如,可以使用dirname("documents/file.txt")来处理文档。

总结

使用dirname()获取文件路径的目录名。如果您需要创建一个备份目录,请使用dirname()获取父目录,然后在其内部创建备份文件夹。

php_function_reference.htm
广告