oihana/php-files

The Oihana PHP Files library

dev-main 2025-07-20 16:05 UTC

Requires

• php: >=8.4
• ext-fileinfo: *
• ext-openssl: *
• oihana/php-core: dev-main
• oihana/php-system: dev-main

Requires (Dev)

• mikey179/vfsstream: ^1.6
• nunomaduro/collision: ^8.8
• phpdocumentor/shim: ^3.8
• phpunit/phpunit: ^12

MPL-2.0

• Marc Alcaraz

• php
• file
• path
• directory

README

📚 Documentation

Full project documentation is available at:
👉 https://bcommebois.github.io/oihana-php-files

🚀 Features

• 📁 Cross-platform path and file utilities
• 🔐 File encryption and decryption with OpenSSL
• 🗜️ Tar and compressed .tar.gz archive creation and extraction
• 📂 Recursive file discovery with filters and options
• 🧪 Full unit test coverage

📦 Installation

Requires PHP 8.4+

Install via Composer:

composer require oihana/php-files

✅ Running Unit Tests

To run all tests:

composer run-script test

To run a specific test file:

composer run test ./tests/oihana/files/OpenSSLFileEncryptionTest.php

🧾 Licence

This project is licensed under the Mozilla Public License 2.0 (MPL-2.0).

👤 About the author

• Author : Marc ALCARAZ (aka eKameleon)
• Mail : [e-mail]
• Website : http://www.ooop.fr

🛠️ Generate the Documentation

We use phpDocumentor to generate the documentation into the ./docs folder.

Usage

Run the command :

composer doc