decodelabs/atlas

Easy filesystem and io functions

v0.12.4 2025-02-20 14:14 UTC

Requires

• php: ^8.4
• decodelabs/coercion: ^0.3
• decodelabs/deliverance: ^0.2.14
• decodelabs/enumerable: ^0.2
• decodelabs/exceptional: ^0.5.2
• decodelabs/glitch-support: ^0.5.1
• decodelabs/veneer: ^0.12.2

Requires (Dev)

• decodelabs/phpstan-decodelabs: ^0.7

MIT

• Tom Wright

• file
• filesystem
• directory
• io

README

Easy filesystem and IO functions for PHP

Atlas provides an easy and accessible interface to file system interaction. Read, write, copy and move files without breaking a sweat.

Installation

Install via Composer:

composer require decodelabs/atlas

Usage

Basic local filesystem functions

There are many standard filesystem functions represented by either File or Dir objects. See Context.php, File.php and Dir.php and Node.php for the full list.

use DecodeLabs\Atlas;

Atlas::get('/path/to/dir_or_file')
    ->copyTo('/another/path/');

Atlas::createDir('some/dir/path', 0770);

Atlas::file('my/file')
    ->renameTo('file.txt')
    ->setOwner('user');

Atlas::gzFile('my/file.gz', 'w')
    ->write('hello world')
    ->close();

Dir scanning

Scan the contents of a folder with optional filtering.. Replace "scan" for "list" to return an array rather than a Generator:

use DecodeLabs\Atlas;

foreach(Atlas::scan('my/dir') as $name => $fileOrDir) {
    // All files and dirs in my/dir
}

foreach(Atlas::scanDirs('my/dir') as $name => $dir) {
    // All dirs in my/dir
}

foreach(Atlas::listFilesRecursive('my/dir', function($name, $file) {
    // Return true if you want the file to be output
    return $name !== 'BadFile.php';
}) as $name => $file) {
    // All files in all dirs in my/dir
}

See Dir/ScannerTrait.php for all scanning options.

Licensing

Atlas is licensed under the MIT License. See LICENSE for the full license text.