PHPackages                             degraciamathieu/php-file-explorer - 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 & Storage](/categories/file-storage)
4. /
5. degraciamathieu/php-file-explorer

ActivePackage[File & Storage](/categories/file-storage)

degraciamathieu/php-file-explorer
=================================

v0.4.1(3y ago)12.7k3MITPHPPHP ^8.1

Since Dec 26Pushed 3y ago1 watchersCompare

[ Source](https://github.com/DeGraciaMathieu/php-file-explorer)[ Packagist](https://packagist.org/packages/degraciamathieu/php-file-explorer)[ Docs](https://github.com/DeGraciaMathieu/php-file-explorer)[ RSS](/packages/degraciamathieu-php-file-explorer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (7)Used By (3)

[![PHP Composer](https://github.com/DeGraciaMathieu/php-file-explorer/actions/workflows/build.yml/badge.svg)](https://github.com/DeGraciaMathieu/php-file-explorer/actions/workflows/build.yml)[![packagist](https://camo.githubusercontent.com/bbbe0f47b19f813a4c63b2deac1082cc2cd710cad5e367e8f0cf9297ffbfc066/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f44654772616369614d6174686965752f7068702d66696c652d6578706c6f726572)](https://camo.githubusercontent.com/bbbe0f47b19f813a4c63b2deac1082cc2cd710cad5e367e8f0cf9297ffbfc066/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f44654772616369614d6174686965752f7068702d66696c652d6578706c6f726572)[![packagist](https://camo.githubusercontent.com/8f76103685bce8262886fe27387add92d47b50803def68bd2a5e6487a374290f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f64656772616369616d6174686965752f7068702d66696c652d6578706c6f7265722f706870)](https://camo.githubusercontent.com/8f76103685bce8262886fe27387add92d47b50803def68bd2a5e6487a374290f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f64656772616369616d6174686965752f7068702d66696c652d6578706c6f7265722f706870)

php-file-explorer
=================

[](#php-file-explorer)

Code originally taken from [bmitch/churn-php](https://github.com/bmitch/churn-php)

> composer require degraciamathieu/php-file-explorer

Usage
-----

[](#usage)

```
use DeGraciaMathieu\FileExplorer\FileFinder;

$fileFinder = new FileFinder(
    basePath: __DIR__,
);

$files = $fileFinder->getFiles();

foreach ($files as $file) {

   # DeGraciaMathieu\FileExplorer\File
   $file->fullPath;
   $file->displayPath;
}
```

```
$fileFinder = new FileFinder(
    basePath: 'app/Modules/',
    onlyPatterns: [
        '.*/Logics/.*',
        '.*Logic.php',
    ],
);

$files = $fileFinder->getFiles();
```

```
$fileFinder = new FileFinder(
    basePath: 'app/Modules/',
    ignorePatterns: [
        '.*/Repositories/.*',
    ],
);

$files = $fileFinder->getFiles();
```

```
$fileFinder = new FileFinder(
    basePath: 'app/',
);

$files = $fileFinder->getFiles([
    'Models/.*',
    'Services/.*',
]);
```

Tests
-----

[](#tests)

```
make test
make coverage

```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~12 days

Total

6

Last Release

1171d ago

PHP version history (2 changes)v0.1.0PHP ^8.0

v0.2.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/b7c883dad74109462c750a2bafef33c1d26da31c68e90b686cc0aa355b57feaf?d=identicon)[DeGraciaMathieu](/maintainers/DeGraciaMathieu)

---

Top Contributors

[![DeGraciaMathieu](https://avatars.githubusercontent.com/u/11473997?v=4)](https://github.com/DeGraciaMathieu "DeGraciaMathieu (17 commits)")

---

Tags

filesystemfinderphp

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/degraciamathieu-php-file-explorer/health.svg)

```
[![Health](https://phpackages.com/badges/degraciamathieu-php-file-explorer/health.svg)](https://phpackages.com/packages/degraciamathieu-php-file-explorer)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k511.3M2.2k](/packages/aws-aws-sdk-php)[terminal42/contao-fineuploader

FineUploader bundle for Contao Open Source CMS

2052.9k4](/packages/terminal42-contao-fineuploader)

PHPackages © 2026

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