guillaumetissier/path-utilities

Simple PHP Path utility classes for files and directories.

1.0.0 2026-01-03 11:53 UTC

Requires

• php: >=8.1

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.92
• phpunit/phpunit: ^10.5

MIT

• Guillaume Tissier

README

Simple PHP utility classes for handling filesystem paths, permissions, and timestamps.

Installation

Install via Composer:

composer require guillaumetissier/path-utilities

Usage

use Guillaumetissier\PathUtilities\Path;

$path = new Path('/path/to/file.txt');

// Basic information
echo $path->basename();  // file.txt
echo $path->extension(); // txt
echo $path->dirname();   // /path/to

// Parent directory
$parent = $path->parent();

// Check existence and type
if ($path->exists() && $path->isFile()) {
    echo "File exists!";
}

// File size
echo $path->size(); // in bytes

// Permissions
$permissions = $path->permissions();
echo $permissions->octal();     // e.g., 0644
echo $permissions->symbolic();  // e.g., rw-r--r--

// File times
$times = $path->times();
echo $times->modification()->format('Y-m-d H:i:s');

Features

• Path utilities (basename, dirname, filename, extension, parent)
• File existence and type checks (isFile, isDir, isLink)
• File size
• Permissions handling via PathPermissions
• File timestamps via PathTimes
• Optional exception mode for filesystem warnings

Requirements

• PHP 8.1 or higher
• Composer

Development

Install development dependencies:

composer install

Run tests:

composer test

Fix coding style:

composer cs

License

MIT License