kduma/binary-tools

PHP library for binary data manipulation and encoding/decoding tools

v0.0.3 2025-09-13 15:47 UTC

Requires

• php: ^8.4
• ext-hash: *
• ext-mbstring: *

Requires (Dev)

• laravel/pint: ^1.18
• phpunit/phpunit: ^11.0

MIT

• kduma

README

A PHP library for binary data manipulation and encoding/decoding operations. This library provides safe, efficient tools for working with binary data, including UTF-8 validation and secure string comparisons.

Check full documentation: opensource.duma.sh/libraries/php/binary-tools

Installation

composer require kduma/binary-tools

Requirements

• PHP 8.4+
• ext-mbstring - For UTF-8 validation
• ext-hash - For secure string comparisons

Features

• Safe binary data manipulation with bounds checking
• UTF-8 string validation for text data
• Multiple encoding formats (hex, base64)
• Secure string comparison using hash_equals()
• Big-endian integer support for network protocols
• Position tracking for streaming operations

Core Classes

BinaryString

Immutable wrapper for binary data with conversion and comparison methods.

BinaryWriter

Stream-like writer for building binary data structures.

BinaryReader

Stream-like reader for parsing binary data with position tracking.

License

This library is open-sourced software licensed under the MIT license.