Loheide-eu-mitarbeiterplatt.../vendor/spomky-labs/cbor-php
Friederich Loheide 9c0f8de791
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 1m14s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 1m12s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 1m7s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 1m19s
CI / PHP 8.3 / mysql:8.0 (pull_request) Successful in 1m32s
CI / PHP 8.4 / mysql:8.0 (pull_request) Successful in 1m22s
CI / PHP 8.4 / mysql:8.4 (pull_request) Successful in 1m32s
CI / PHP 8.3 / mysql:8.4 (pull_request) Successful in 1m35s
CI / Build-Artefakte aktuell (pull_request) Failing after 1m7s
Phase 0: Fundament für Inhaus
- Laravel 13 mit Filament 5 (Admin), Inertia 3 + Vue 3 + Vuetify 4 (Material 3)
- Anmeldung über Fortify (Login, Passwort vergessen/ändern), keine Selbstregistrierung
- Profil mit Profilbild (WebP in festen Größen), Personenseiten, Header mit Avatar-Menü
- Material-3-Farbschema aus der Primärfarbe, hell/dunkel/System pro Person
- Basis-Branding (Portalname, Logo, Primärfarbe) im Admin unter „Erscheinungsbild“
- Benutzerverwaltung im Admin, Zugang vorläufig über is_admin
- vendor/ (ohne Dev-Pakete) und Frontend-Build mitversioniert, Dev-Pakete in vendor-dev/
- PHPUnit-Tests gegen MySQL/MariaDB, Forgejo-CI-Matrix, Docker-Entwicklungsumgebung
- VERSION, CHANGELOG.md und CONTRIBUTING.md mit Release-Ablauf

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-25 20:35:30 +00:00
..
.github Phase 0: Fundament für Inhaus 2026-09-25 20:35:30 +00:00
src Phase 0: Fundament für Inhaus 2026-09-25 20:35:30 +00:00
CODE_OF_CONDUCT.md Phase 0: Fundament für Inhaus 2026-09-25 20:35:30 +00:00
composer.json Phase 0: Fundament für Inhaus 2026-09-25 20:35:30 +00:00
LICENSE Phase 0: Fundament für Inhaus 2026-09-25 20:35:30 +00:00
README.md Phase 0: Fundament für Inhaus 2026-09-25 20:35:30 +00:00
RELEASES.md Phase 0: Fundament für Inhaus 2026-09-25 20:35:30 +00:00
SECURITY.md Phase 0: Fundament für Inhaus 2026-09-25 20:35:30 +00:00

CBOR for PHP

CI Latest Stable Version Total Downloads License

A comprehensive PHP library for encoding and decoding CBOR (Concise Binary Object Representation) data according to RFC 8949.

Features

  • ✅ Full support for all CBOR major types (0-7)
  • ✅ Extensible tag system with built-in support for common tags
  • ✅ Streaming decoder for efficient memory usage
  • ✅ Type-safe API with modern PHP 8.0+ features
  • ✅ Comprehensive support for indefinite-length objects
  • ✅ Built-in normalization to PHP native types

Installation

composer require spomky-labs/cbor-php

Requirements:

  • PHP 8.0 or higher
  • ext-mbstring
  • brick/math

Optional but recommended:

  • ext-gmp or ext-bcmath for improved performance with large integers
  • ext-bcmath for Big Float and Decimal Fraction support

This project follows semantic versioning strictly.

Quick Start

<?php

use CBOR\Decoder;
use CBOR\MapObject;
use CBOR\TextStringObject;
use CBOR\UnsignedIntegerObject;

// Encoding: Create a CBOR object
$map = MapObject::create()
    ->add(TextStringObject::create('name'), TextStringObject::create('John Doe'))
    ->add(TextStringObject::create('age'), UnsignedIntegerObject::create(30));

$encoded = (string) $map;

// Decoding: Parse CBOR data
$decoder = Decoder::create();
$decoded = $decoder->decode(StringStream::create($encoded));

// Normalize to native PHP types
$data = $decoded->normalize();
// ['name' => 'John Doe', 'age' => '30']

Documentation

📖 Complete Documentation - Full API reference and guides

Major Types Overview

This library supports all CBOR major types defined in RFC 8949:

Major Type Description Classes
0 Unsigned Integer UnsignedIntegerObject
1 Negative Integer NegativeIntegerObject
2 Byte String ByteStringObject, IndefiniteLengthByteStringObject
3 Text String TextStringObject, IndefiniteLengthTextStringObject
4 Array ListObject, IndefiniteLengthListObject
5 Map MapObject, IndefiniteLengthMapObject
6 Tag Tag and subclasses - See Tags Reference
7 Other TrueObject, FalseObject, NullObject, etc.

Common API:

  • All objects have a static create() method for instantiation
  • All objects can be converted to binary: (string) $object
  • Many objects implement Normalizable to convert to native PHP types

Basic Usage Examples

For complete documentation with all examples, see the Documentation.

Working with Basic Types

use CBOR\UnsignedIntegerObject;
use CBOR\TextStringObject;
use CBOR\ListObject;
use CBOR\MapObject;

// Integers
$number = UnsignedIntegerObject::create(42);

// Strings
$text = TextStringObject::create('Hello World');

// Arrays
$list = ListObject::create([
    UnsignedIntegerObject::create(1),
    TextStringObject::create('two'),
]);

// Maps/Objects
$map = MapObject::create()
    ->add(TextStringObject::create('key'), TextStringObject::create('value'));

Working with Tags

📖 For complete tags documentation, see Tags Reference

use CBOR\Tag\TimestampTag;
use CBOR\Tag\DecimalFractionTag;
use CBOR\UnsignedIntegerObject;

// Timestamps
$timestamp = TimestampTag::create(UnsignedIntegerObject::create(time()));
$dateTime = $timestamp->normalize(); // DateTimeImmutable

// Decimal fractions
$decimal = DecimalFractionTag::createFromFloat(3.14159);
echo $decimal->normalize(); // "3.14159"

Supported Tags:

  • Date/Time (Tags 0, 1) and dates without a time (Tags 100, 1004)
  • Big Numbers (Tags 2, 3), Decimal/Binary Fractions (Tags 4, 5) and Rationals (Tag 30)
  • Encoding hints (Tags 21, 22, 23), embedded CBOR (Tags 24, 63)
  • URIs, MIME and UUIDs (Tags 32, 36, 37, 257)
  • COSE structures and CBOR Web Tokens (Tags 16, 17, 18, 61, 96, 97, 98)
  • Typed and multi-dimensional arrays (Tags 40, 41, 64-87, 1040)
  • IP and network addresses (Tags 52, 54, 260, 261)
  • And more...

Create your own: See Creating Custom Tags guide.

Complete Example

use CBOR\Decoder;
use CBOR\MapObject;
use CBOR\ListObject;
use CBOR\TextStringObject;
use CBOR\UnsignedIntegerObject;
use CBOR\StringStream;
use CBOR\Tag\TimestampTag;

// Build a complex nested structure
$data = MapObject::create()
    ->add(
        TextStringObject::create('user'),
        MapObject::create()
            ->add(TextStringObject::create('name'), TextStringObject::create('Alice'))
            ->add(TextStringObject::create('age'), UnsignedIntegerObject::create(30))
    )
    ->add(
        TextStringObject::create('scores'),
        ListObject::create([
            UnsignedIntegerObject::create(95),
            UnsignedIntegerObject::create(87),
        ])
    )
    ->add(
        TextStringObject::create('timestamp'),
        TimestampTag::create(UnsignedIntegerObject::create(time()))
    );

// Encode to binary
$encoded = (string) $data;

// Decode back
$decoder = Decoder::create();
$decoded = $decoder->decode(StringStream::create($encoded));

// Convert to native PHP types
$phpData = $decoded->normalize();

For more examples including WebAuthn, COSE, IoT scenarios, and advanced usage, see the complete documentation.

Contributing

Contributions are welcome! Here's how you can help:

Please read our contribution guidelines before submitting.

Support

If you find this project valuable, consider supporting its development:

License

This project is released under the MIT License.


Maintained by: Florent Morselli and contributors