PHPackages                             decodelabs/atlas - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. decodelabs/atlas

ActiveLibrary[File &amp; Storage](/categories/file-storage)

decodelabs/atlas
================

Easy filesystem and io functions

v0.14.2(5mo ago)226.3k↓100%1MITPHPPHP ^8.4CI passing

Since Oct 6Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/decodelabs/atlas)[ Packagist](https://packagist.org/packages/decodelabs/atlas)[ RSS](/packages/decodelabs-atlas/feed)WikiDiscussions develop Synced today

READMEChangelog (10)Dependencies (6)Versions (47)Used By (0)

Atlas
=====

[](#atlas)

[![PHP from Packagist](https://camo.githubusercontent.com/047387df0563276143d8bc4303b628f3229f5945a3bf63f2d6ba57fa0d56fcd2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6465636f64656c6162732f61746c61733f7374796c653d666c6174)](https://packagist.org/packages/decodelabs/atlas)[![Latest Version](https://camo.githubusercontent.com/69f01be1dbcda9f78834e82f51436818200494fd3182754ffa1156a517824e6c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6465636f64656c6162732f61746c61732e7376673f7374796c653d666c6174)](https://packagist.org/packages/decodelabs/atlas)[![Total Downloads](https://camo.githubusercontent.com/f203246deccf1c461a8689a7e5df021658121eff65ed681e3b1bb973e5bcc58c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6465636f64656c6162732f61746c61732e7376673f7374796c653d666c6174)](https://packagist.org/packages/decodelabs/atlas)[![GitHub Workflow Status](https://camo.githubusercontent.com/f47b16ea4c52a8aabbb905882c1dd642ea5307d8b07f0adce396962a2bd2f148/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6465636f64656c6162732f61746c61732f696e746567726174652e796d6c3f6272616e63683d646576656c6f70)](https://github.com/decodelabs/atlas/actions/workflows/integrate.yml)[![PHPStan](https://camo.githubusercontent.com/e25c14ce011edabdd0fbd2e10415b41cc5d66ed11ef3e5b7edd074c5bdd35a2d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d656e61626c65642d3434434331312e7376673f6c6f6e6743616368653d74727565267374796c653d666c6174)](https://github.com/phpstan/phpstan)[![License](https://camo.githubusercontent.com/244db1d592cd23d5b7554e65d8422e29f92b3c0f02b22d7863c3cf1a1be3e919/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6465636f64656c6162732f61746c61733f7374796c653d666c6174)](https://packagist.org/packages/decodelabs/atlas)

### Easy filesystem and IO functions for PHP

[](#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
------------

[](#installation)

This package requires PHP 8.4 or higher.

Install via Composer:

```
composer require decodelabs/atlas
```

Usage
-----

[](#usage)

### Basic local filesystem functions

[](#basic-local-filesystem-functions)

There are many standard filesystem functions represented by either `File` or `Dir` objects. See [Context.php](./src/Context.php), [File.php](./src/File.php) and [Dir.php](./src/Dir.php) and [Node.php](./src/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::getFile('my/file')
    ->renameTo('file.txt')
    ->setOwner('user');

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

### Dir scanning

[](#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](./src/Dir/ScannerTrait.php) for all scanning options.

Licensing
---------

[](#licensing)

Atlas is licensed under the MIT License. See [LICENSE](./LICENSE) for the full license text.

###  Health Score

52

↑

FairBetter than 97% of packages

Maintenance75

Regular maintenance activity

Popularity27

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 99.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~49 days

Recently: every ~29 days

Total

45

Last Release

170d ago

PHP version history (5 changes)v0.5.0PHP ^7.2

v0.8.0PHP ^7.2|^8.0

v0.10.0PHP ^8.0

v0.11.1PHP ^8.1

v0.12.3PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/8a241d64d12b3b5ee94197862ec1ec30b82ed2efa34a0cd7f4c3565a021daddd?d=identicon)[betterthanclay](/maintainers/betterthanclay)

---

Top Contributors

[![betterthanclay](https://avatars.githubusercontent.com/u/1273586?v=4)](https://github.com/betterthanclay "betterthanclay (350 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (1 commits)")

---

Tags

filefilesystemphpfilesystemfileiodirectory

### Embed Badge

![Health badge](/badges/decodelabs-atlas/health.svg)

```
[![Health](https://phpackages.com/badges/decodelabs-atlas/health.svg)](https://phpackages.com/packages/decodelabs-atlas)
```

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k626.7M1.9k](/packages/league-flysystem)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k257.1M691](/packages/league-flysystem-aws-s3-v3)[knplabs/gaufrette

PHP library that provides a filesystem abstraction layer

2.5k39.2M118](/packages/knplabs-gaufrette)[knplabs/knp-gaufrette-bundle

Allows to easily use the Gaufrette library in a Symfony project

73628.2M85](/packages/knplabs-knp-gaufrette-bundle)[league/flysystem-local

Local filesystem adapter for Flysystem.

226221.1M24](/packages/league-flysystem-local)[league/flysystem-memory

In-memory filesystem adapter for Flysystem.

8532.5M167](/packages/league-flysystem-memory)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
