Understanding PHP dirname() Function with Practical Examples

PHP is a widely used scripting language for web development, and the dirname() function is a handy built‑in tool that returns the directory portion of a given path.

The function takes a required $path string and an optional $levels integer (default 1) to specify how many directory levels to ascend.

It returns a string containing the directory path, which is useful for extracting a file’s directory, building dynamic paths, or handling file operations.

The syntax is:

string dirname ( string $path [, int $levels = 1 ] )

Parameters

$path : the path string to be processed (required).

$levels : the number of directory levels to return (optional, default 1).

Return Value

A string representing the directory part of the provided path.

Below are four illustrative examples.

Example 1

$path = "/var/www/html/myfile.txt";
$dir = dirname($path);
echo $dir;

Output:

/var/www/html

The function extracts /var/www/html from the absolute Linux path.

Example 2

$path = "../img/pic.jpg";
$dir = dirname($path);
echo $dir;

Output:

../img

When given a relative path, dirname() returns the relative directory ../img .

Example 3

$path = "C:/xampp/htdocs/index.php";
$dir = dirname($path);
echo $dir;

Output:

C:/xampp/htdocs

This demonstrates usage on a Windows file path.

Example 4

$path = "/var/www/html";
$dir = dirname($path);
echo $dir;

Output:

/var/www

If the supplied path is already a directory, dirname() returns its parent directory.

Summary

The dirname() function is a versatile PHP utility for extracting the directory component of a path, which is especially helpful in dynamic path generation and file manipulation tasks.