PHPackages                             pendenga/file - 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. pendenga/file

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

pendenga/file
=============

File tools

0.1.0(6y ago)016[1 PRs](https://github.com/pendenga/file/pulls)1nonePHPCI failing

Since Mar 25Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/pendenga/file)[ Packagist](https://packagist.org/packages/pendenga/file)[ RSS](/packages/pendenga-file/feed)WikiDiscussions master Synced 6d ago

READMEChangelogDependencies (5)Versions (3)Used By (1)

File Tools
==========

[](#file-tools)

Several tools I use when working with files and directories, particularly when I have a large amount of files to work with. I build most of these when exporting years of data for a customer, which ended up being 165,000+ files in 4000+ directories totaling 140GB+.

Installation
------------

[](#installation)

This package is hosted on packagist installable via [Composer](https://getcomposer.org/).

### Requirements

[](#requirements)

- PHP version 7.1 or greater (7.2+ recommended)
- Composer (for installation)

### Installing Via Composer

[](#installing-via-composer)

Run the following at the command line in your repo:

```
composer require pendenga/file
```

Or add the following lines to your composer.json file...

```
"require": {
  "pendenga/file": "0.1.0",
},
```

and run the following command:

```
$ composer update
```

This will set the **Pendenga File** as a dependency in your project and install it.

When bootstrapping your application, you will need to require `'vendor/autoload.php'` in order to setup autoloading.

Tools Available
---------------

[](#tools-available)

All logging is done with the Psr\\Log\\LoggerInterface for compatability with other packages and loggers. In my examples, I'll just use $logger to mean any LoggerInterface.

### Batch

[](#batch)

Batch will take a large number of directories and consolidate them into subdirectories not to exceed a certain size. The use case was I had 4000+ folders in a single directory, totaling 140GB+ and had uploaded that to Box.com. Box.com didn't allow downloads over 15GB so the customer couldn't download the whole set at once. This script put sets of hundreds of folders into 15 batch folders of less than 10GB each, so they could be downloaded.

```
$batch = new Batch(new Scan(), $logger);
$batch->setOption('max_batch_bytes', 10737418240); // 10 gb
$batches = $batch->evaluate($tmp_dir);
// print_r($batches); // review before executing
$batch->execute($batches);
```

### ColumnMap

[](#columnmap)

ColumnMap is used by Manifest to map columns in a spreadsheet to values that need to match up. For example if a user-defined manifest spreadsheet has columns (name, size, checksum) or (filename, bytes, md5) those might both be valid and we need to map the columns in the spreadsheet to be able to work with them.

### Directory

[](#directory)

Directory has some tools that are useful when creating directories and moving files around.

```
$dir = new Directory($logger);

// bool check if directory is empty
if ($dir->checkEmpty($tmp_dir)) { ... }

// array list of files
foreach ($dir->files($tmp_dir) as $file) { ... }

// delete all files in a directory (useful for unit tests)
$dir->deleteFiles($tmp_dir);

// delete all empty subdirectories in a directory (useful for unit tests)
$dir->deleteSubDirs($tmp_dir);
```

### Generate

[](#generate)

Generate a bunch of random files. You can configure options for a random number of directories, files in each dir, lines in each file, characters on each line, etc. Optionally, you can create a manifest file of the new files.

```
$gen = new Generate($logger);
$gen->setOption('file_base_dir', $tmp_dir)
    ->setManifest(new ManifestWriter($manifest))
    ->files();
```

### Ini

[](#ini)

A pretty simple wrapper for the ini file, to help find it in the root directory, even after this package is installed in a different project, and provide one-line, static functions for ini access.

```
$tmp_dir = Ini::get('TMP_DIRECTORY');
```

### Manifest

[](#manifest)

Validate files in a directory using a spreadsheet manifest with relative file name and zero or more of the following:

- File size in bytes
- Number or lines in file
- md5 checksum

```
$chk = new Manifest(new ColumnMap(), $logger);
$chk->load($path_to_manifest_file);
$results = $chk->validateFiles($path_to_files, new Scan());
```

### ManifestWriter

[](#manifestwriter)

Used to create a manifest file when files are being created. You can specify which columns get created, but here are the current options:

- Relative file name (required)
- File size in bytes
- Number or lines in file
- md5 checksum

### Properties

[](#properties)

A simple class to abstract some of the checks that are done in the manifest file.

```
$prop = new Properties($path_to_file);
$prop->bytes();
$prop->checksum();
$prop->exists();
$prop->lines();
```

### Scan

[](#scan)

Abstraction of some PHP file scanning and GLOB tools. Helps in searching for files, getting lists of files and directories.

```
$scan = new Scan($logger);

// search directory for text files (recursive)
$scan->files($path_to_file_directory, '*.txt'))

// list subdirectories (not recursive)
$scan->directories($path_to_file_directory)
```

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance53

Moderate activity, may be stable

Popularity6

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity47

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

Unknown

Total

1

Last Release

2244d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/27fbb3bb3008265520daa337334fb9b3ae57bb282bc7d4785784bf8be1d7d855?d=identicon)[pendenga](/maintainers/pendenga)

---

Top Contributors

[![pendenga](https://avatars.githubusercontent.com/u/29118?v=4)](https://github.com/pendenga "pendenga (3 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pendenga-file/health.svg)

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

###  Alternatives

[sonata-project/media-bundle

Symfony SonataMediaBundle

4625.5M71](/packages/sonata-project-media-bundle)[puli/repository

A filesystem-like repository for storing arbitrary resources.

44287.6k32](/packages/puli-repository)

PHPackages © 2026

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