README

Opinionated PHP library implementing the openEHR Basic Meta-Model (BMM). It serves primarily as an intermediate representation (IR) of P_BMM specifications, providing typed PHP objects for schemas, packages, classes, properties, types, and functions.

Features

• Parse openEHR BMM JSON schemas into strongly-typed PHP objects (BmmSchema, BmmClass, BmmPackage, etc.)
• Serialize models back to JSON (JsonSerializable)
• Support for all P_BMM class variants: classes, interfaces, enumerations (string and integer)
• Property types: single, container, generic, and open single properties
• Function definitions with parameters, pre/post-conditions, and result types
• Generic parameter definitions and generic types
• Typed collections with alias support

Installation

composer require cadasto/openehr-bmm

Quick start

use Cadasto\OpenEHR\BMM\Model\BmmSchema;

// Load a BMM schema from a JSON file
$json = json_decode(file_get_contents('openehr_rm_1.2.0.bmm.json'), true);
$schema = BmmSchema::fromArray($json);

// Access schema metadata
echo $schema->getSchemaId(); // "openehr_rm_1.2.0"

// Navigate packages and classes
foreach ($schema->packages as $package) {
    echo $package->name . PHP_EOL;
}

// Serialize back to JSON
echo json_encode($schema, JSON_PRETTY_PRINT);

Development

With Docker

make build
make install
make ci

Without Docker

composer install
composer ci

Composer scripts

Standards

• Style: PSR-12 (PHPCS)
• Static analysis: PHPStan level 8
• Tests: PHPUnit 12
• Refactoring: Rector (local only)

See docs/testing.md for command details and docs/php-standards.md for standards.

Releases

Tag with SemVer (no v prefix), e.g. git tag 1.0.0 && git push origin 1.0.0. See docs/releases.md.

License

MIT — see LICENSE.