gksh/bitmask

A bitmask value object for PHP

v1.0.0 2026-01-12 03:34 UTC

Requires

• php: ^8.2

Requires (Dev)

• laravel/pint: ^1.18
• pestphp/pest: ^3.0|^4.0
• phpstan/phpstan: ^2.1
• rector/rector: ^2.0
• symfony/var-dumper: ^7.2

MIT

• Gustavo Karkow

• php
• bitfield
• binary
• bitmask
• bitwise
• bit flags

README

gksh/bitmask

A simple way to use bitmask and bitwise operations in PHP.

Installation

Requires PHP 8.2+

composer require gksh/bitmask

Usage

Streamline flag handling by encoding boolean options into simple integers through bitmasking.

Please see ide.php for full example and playground for more.

use Gksh\Bitmask\Bitmask;

enum Panel: int
{
    case Project = 1;
    case Terminal = 2;
    case SourceControl = 4;
    case Extensions = 8;
}

class Ide
{
    public Bitmask $panels;

    public function __construct()
    {
        $this->panels = Bitmask::tiny(); // 8-bit
    }

    public function togglePanel(Panel $panel): self
    {
        $this->panels = $this->panels->toggle($panel);

        return $this;
    }
}

$ide = (new Ide())
    ->togglePanel(Panel::Project)
    ->togglePanel(Panel::Terminal);

$ide->panels->has(Panel::Terminal); // true
$ide->panels->has(Panel::Extensions); // false

Features

• Immutable: Operations return new instances, original unchanged
• Enum support: Pass BackedEnum directly — no ->value extraction needed
• Size variants: tiny() (8-bit), small() (16-bit), medium() (24-bit), make() (32-bit default)

Factory Methods

Bitmask::make()         // 32-bit (default)
Bitmask::tiny()         // 8-bit, for TINYINT columns
Bitmask::small()        // 16-bit, for SMALLINT columns
Bitmask::medium()       // 24-bit, for MEDIUMINT columns

Operations

$mask = Bitmask::tiny()
    ->set(Flag::A)      // Set a flag
    ->unset(Flag::B)    // Unset a flag
    ->toggle(Flag::C);  // Toggle a flag

$mask->has(Flag::A);    // Check if flag is set
$mask->value();         // Get integer value
$mask->size();          // Get Size enum

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• Gustavo Karkow
• All Contributors

License

The MIT License (MIT). Please see License File for more information.