Understanding PHP dirname() Function: Syntax, Parameters, and Usage Examples

PHP's dirname() function retrieves the directory portion of a given path.

Syntax of dirname()

<code>string dirname ( string $path [, int $levels = 1 ] )</code>

Parameter description

$path : required, the path to evaluate.

$levels : optional, number of directory levels to return, default is 1.

The function returns the directory part of the path, removing the file name; if $levels is omitted it removes one level.

Usage examples

Getting the directory part of a path

<code>$path = '/var/www/html/index.php';
$dir = dirname($path);

echo $dir; // outputs: /var/www/html</code>

In this example, $path specifies a file path and dirname() returns its directory.

Getting multiple directory levels

<code>$path = '/var/www/html/includes/functions.php';
$dir = dirname($path, 2);

echo $dir; // outputs: /var/www</code>

This shows how setting $levels to 2 returns the parent two directories; if the path lacks enough levels, dirname() returns "." (the current directory).

Handling relative paths

<code>$path = '../index.php';
$dir = dirname($path);

echo $dir; // outputs: ..</code>

The function correctly extracts the directory part from a relative path.

Summary

The dirname() function is a convenient tool for obtaining the directory component of a path, useful for both file system and URL handling; careful use of the $levels parameter ensures the desired directory depth.

PHP Learning Recommendations

Vue3+Laravel8+Uniapp Beginner to Advanced Development Tutorial

Vue3+TP6+API Social E‑commerce System Development Course

Swoole From Beginner to Master Recommended Course

Workerman+TP6 Real‑time Chat System Limited‑time Offer