README

File hashing contract and default implementation.

Use this package when a service needs to hash a file by filename and receive file-specific exceptions for invalid paths.

Installation

composer require componenta/file-hasher

Usage

use Componenta\Stdlib\FileHasher;

$hasher = new FileHasher('sha256');

$hash = $hasher->hashFile(__DIR__ . '/document.pdf');
$sha1 = $hasher->withAlgorithm('sha1');

FileHasher exposes the selected algorithm as read-only public state:

$hasher->algorithm; // sha256

withAlgorithm() returns a new immutable instance.

Contract

interface FileHasherInterface
{
    public function hashFile(string $filename): string;
}

Exceptions

All package exceptions are named with a File* prefix and implement FileHasherExceptionInterface.

Related Packages