Download the PHP package kduma/pcf without Composer
On this page you can find all versions of the php package kduma/pcf. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package pcf
Short Description PHP implementation of the Partitioned Container Format (PCF) v1.0
License MIT
Homepage https://github.com/kduma-OSS/Partitioned-Container-Format
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package pcf
pcf — Partitioned Container Format (PHP implementation)
PHP reader/writer for PCF v1.0, a language-agnostic binary container that stores multiple independent byte regions ("partitions") in one file.
This is the first PHP port of the format. It mirrors the written specification
(specs/PCF-spec-v1.0.txt) and the Rust reference (reference/PCF-v1.0/)
field-for-field, and it reproduces the canonical 395-byte test vector from spec
section 15 byte-for-byte. It favours auditability over performance.
Layout
- Header (20 B): magic
0x89 K P R T 0x0D 0x0A 0x1A, major/minor version, absolute offset of the first table block. - Table block: 74-byte header (
partition_count,next_table_offset, hash algo + 64-byte block hash) followed bypartition_countentries. Blocks form a singly linked chain to hold more than 255 partitions. - Entry (141 B):
type, 16-byte UID, 32-byte ASCII label,start_offset,max_length,used_bytes, 1-byte data-hash algorithm, 64-byte data hash.
All integers are little-endian. Free space is max_length - used_bytes.
Hash registry
| id | algorithm | id | algorithm |
|---|---|---|---|
| 0 | none | 5 | SHA-1 |
| 1 | CRC-32/ISO-HDLC | 16 | SHA-256 (default) |
| 2 | CRC-32C | 17 | SHA-512 |
| 3 | CRC-64/XZ | 18 | BLAKE3 |
| 4 | MD5 |
Most algorithms come from PHP's bundled ext-hash. The two it does not provide:
- CRC-64/XZ —
Kduma\PCF\Crc64(check value0x995DC9BBDF1939FA), shipped pure-PHP and validated against the canonical check vector. - BLAKE3 — delegated to the
tourze/blake3-phpComposer package, wrapped behindHashAlgo::blake3()so the dependency is isolated to one method.
Requirements
- PHP >= 8.1 with
ext-hash(bundled by default). - Composer (for the BLAKE3 dependency).
Installation
Usage
Container works over any Kduma\PCF\Storage\StorageInterface:
MemoryStorage— an in-memory string buffer (analogue of the reference'sCursor<Vec<u8>>).StreamStorage— any seekable PHP stream / file (analogue ofstd::fs::File).
Operations
| Method | Purpose |
|---|---|
Container::create() / createWith() |
Start an empty container. |
Container::open() |
Open an existing one (validates magic + major version). |
addPartition() |
Append a partition (unique non-NIL UID, non-reserved type). |
updatePartitionData() |
Replace data in place; maintains the hash cascade. |
removePartition() |
Remove a partition (data region becomes dead space). |
entries() / readPartitionData() |
Read metadata and data. |
verify() |
Verify every table-block and partition hash + conformance checks. |
compactedImage() / compactInto() |
Produce the tightly packed canonical form. |
Errors are reported as Kduma\PCF\PcfException; the precise cause is available
as $e->kind (a Kduma\PCF\ErrorKind).
Tests
The suite mirrors the Rust reference:
