PHPackages                             kristoffbertram/thedirectorycleaner - 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. [Utility & Helpers](/categories/utility)
4. /
5. kristoffbertram/thedirectorycleaner

ActivePackage[Utility & Helpers](/categories/utility)

kristoffbertram/thedirectorycleaner
===================================

A Directory Cleaner for PHP

07PHP

Since Feb 23Pushed 2y ago1 watchersCompare

[ Source](https://github.com/kristoffbertram/thedirectorycleaner)[ Packagist](https://packagist.org/packages/kristoffbertram/thedirectorycleaner)[ RSS](/packages/kristoffbertram-thedirectorycleaner/feed)WikiDiscussions main Synced 2d ago

READMEChangelogDependenciesVersions (1)Used By (0)

thedirectorycleaner
===================

[](#thedirectorycleaner)

*2.0.0*

Introduction
------------

[](#introduction)

A PHP utility class for cleaning up directories by deleting files and folders that are (optionally) not ignored and are older than a specified age. This class supports ignoring specific directories, files or patterns.

Usage
-----

[](#usage)

Specify one or more directories that require cleaning.
Optionally, define file paths, -names or patterns to be ignored or set a time (e.g. 10 minutes, 1 day, 2 weeks.)
Finally, run clean();

```
$TheDirectoryCleaner->addDirectory(__DIR__."/cache");
$TheDirectoryCleaner->ignore(__DIR__."/cache/ignore.txt");
$TheDirectoryCleaner->ignore("*.jpg");
$TheDirectoryCleaner->after("1 day"); // Accepts any textual datetime
$TheDirectoryCleaner->clean();

```

### Demo

[](#demo)

Open ~/demo in your terminal and run `php -S localhost:8000`.

Changelog
---------

[](#changelog)

- `directory()` was renamed to `addDirectory()`.
- Introduced patterns.
- `debug` no longer cleans. Best used together with `logs()`.

Disclaimer
----------

[](#disclaimer)

- Built for personal use, but I imagine you may have a need for it too.
- Be aware, this package irreversibly deletes files and folders. Use at your own risk.
    **I take absolutely no responsibility for any unexpected loss of data.**

###  Health Score

13

—

LowBetter than 1% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity19

Early-stage or recently created project

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/0443cbc8a5d8a34460b64230f0ee05a2b53a350caa5ce81f4e0e27ec743cb479?d=identicon)[kristoffbertram](/maintainers/kristoffbertram)

### Embed Badge

![Health badge](/badges/kristoffbertram-thedirectorycleaner/health.svg)

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

###  Alternatives

[dazet/data-map

Library for mapping data structures.

2123.7k](/packages/dazet-data-map)

PHPackages © 2026

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