PHPackages                             thesis/endian - 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. thesis/endian

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

thesis/endian
=============

Library for encoding and decoding numbers in either big-endian or little-endian order.

0.3.3(2mo ago)144.9k↓59%[1 PRs](https://github.com/thesis-php/endian/pulls)7MITPHPPHP ^8.4CI passing

Since Jan 15Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/thesis-php/endian)[ Packagist](https://packagist.org/packages/thesis/endian)[ Fund](https://www.tinkoff.ru/cf/5MqZQas2dk7)[ RSS](/packages/thesis-endian/feed)WikiDiscussions 0.3.x Synced 1w ago

READMEChangelog (6)Dependencies (8)Versions (12)Used By (7)

Endian
======

[](#endian)

[![PHP Version Requirement](https://camo.githubusercontent.com/045b9cb42a4920f7520a690f4502b1e04265153a4ad56ac9365a57621c3b5df6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f7468657369732f656e6469616e2f706870)](https://packagist.org/packages/thesis/endian)[![GitHub Release](https://camo.githubusercontent.com/e56acec4324f5d46112dd4c955a58fdc7b3a0ec53bfbfc522698187a0a751151/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f7468657369737068702f656e6469616e)](https://github.com/thesisphp/endian/releases)[![Code Coverage](https://camo.githubusercontent.com/dfa6b887810b0e9769d4e2b292e5efaee1ef5d24844b0fa92824516a989d944c/68747470733a2f2f636f6465636f762e696f2f67682f7468657369732d7068702f656e6469616e2f6272616e63682f302e342e782f67726170682f62616467652e737667)](https://codecov.io/gh/thesis-php/endian/tree/0.4.x)

Pack and unpack binary integers and floats in any byte order.

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

[](#installation)

```
composer require thesis/endian
```

Usage
-----

[](#usage)

```
use Thesis\Endian;

// Big endian (= network byte order)
$bytes = Endian\Order::Big->packInt32(-200);
$value = Endian\Order::Big->unpackInt32($bytes); // -200
$bytes = Endian\Order::Network->packInt32(-200);
$value = Endian\Order::Network->unpackInt32($bytes); // -200

// Little endian
$bytes = Endian\Order::Little->packFloat(2.2);
$value = Endian\Order::Little->unpackFloat($bytes); // 2.2

// Native byte order of the current machine
$order = Endian\Order::native(); // Order::Big or Order::Little
```

Design decisions
----------------

[](#design-decisions)

### No narrow int types on input

[](#no-narrow-int-types-on-input)

Pack methods accept plain `int` rather than narrow PHPStan types like `Int8` or `Int32`. This is intentional: requiring callers to carry and assert narrow types would flood driver code with redundant checks and type imports. Thus, we've decided to keep the validation on our side.

Bounds are checked with [`assert()`](https://www.php.net/manual/en/function.assert.php), which means zero overhead in production when assertions are disabled ([`zend.assertions = -1`](https://www.php.net/manual/en/info.configuration.php#ini.zend.assertions)).

### No object wrappers for 8/16/32-bit

[](#no-object-wrappers-for-81632-bit)

8/16/32-bit integers are represented as native PHP `int`, not value objects. This avoids allocation and method-call overhead on every pack/unpack — important in tight loops typical of binary protocol parsing.

### 64-bit integers

[](#64-bit-integers)

64-bit values use [`BcMath\Number`](https://www.php.net/manual/en/class.bcmath-number.php)to handle the full unsigned range beyond `PHP_INT_MAX`:

```
use Thesis\Endian;
use BcMath\Number;

$bytes = Endian\Order::Big->packUint64(new Number('18446744073709551615'));
$value = Endian\Order::Big->unpackUint64($bytes); // 18446744073709551615
```

Supported types
---------------

[](#supported-types)

TypePHP typeRange`int8``int``−128 .. 127``uint8``int``0 .. 255``int16``int``−32 768 .. 32767``uint16``int``0 .. 65535``int32``int``−2147483648 .. 2147483647``uint32``int``0 .. 4294967295``int64``BcMath\Number``−2⁶³ .. 2⁶³−1``uint64``BcMath\Number``0 .. 2⁶⁴−1``float``float`[32-bit IEEE 754](https://en.wikipedia.org/wiki/Single-precision_floating-point_format)`double``float`[64-bit IEEE 754](https://en.wikipedia.org/wiki/Double-precision_floating-point_format)

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance89

Actively maintained with recent releases

Popularity31

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 65.2% 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

Every ~56 days

Recently: every ~33 days

Total

9

Last Release

62d ago

PHP version history (2 changes)0.1.0PHP ^8.3

0.3.0PHP ^8.4

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2552865?v=4)[Valentin Udaltsov](/maintainers/vudaltsov)[@vudaltsov](https://github.com/vudaltsov)

---

Top Contributors

[![kafkiansky](https://avatars.githubusercontent.com/u/37590388?v=4)](https://github.com/kafkiansky "kafkiansky (15 commits)")[![vudaltsov](https://avatars.githubusercontent.com/u/2552865?v=4)](https://github.com/vudaltsov "vudaltsov (8 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/thesis-endian/health.svg)

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

###  Alternatives

[devfaysal/laravel-bangladesh-geocode

7611.6k](/packages/devfaysal-laravel-bangladesh-geocode)

PHPackages © 2026

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