oihana/php-standards

The Oihana PHP Standards library

1.0.0 2025-08-13 09:29 UTC

Requires

• php: >=8.4
• oihana/php-core: dev-main
• oihana/php-reflect: dev-main

Requires (Dev)

• nunomaduro/collision: ^8.8
• phpunit/phpunit: ^12

MPL-2.0

• Marc Alcaraz

• php
• iso
• uncefact
• unm49

README

Oihana PHP – Standards is a library of constants, enumerations, and helpers based on major international standards (ISO, UN, UN/CEFACT, etc.).

It is designed for strong typing, validation, and easy lookups in your PHP applications.

📑 Table of Contents

1. Installation
2. Features
   • Namespace Overview
   • Available Enumerations
3. Core Helper Methods
4. Usage Examples
5. License
6. Author

📦 Installation

Requires PHP 8.4+

Install via Composer:

composer require oihana/php-standards

✨ Features

• Ready-to-use enumerations for currencies, languages, scripts, country codes, measurement units, package types, and more.
• Built-in helpers for validation, lookups, and cross-conversions (e.g., code ↔ name ↔ symbol).
• Clear namespace organization for quick navigation and maintainability.

🗂 Namespace Overview

Namespace	Description
org\iso	ISO-related enumerations (currencies, languages, scripts).
org\unstats	United Nations M49 country and area codes (alpha-3).
org\unece\uncefact	UN/CEFACT recommendations (units of measure, package types) with cross lookups.

📚 Available Enumerations

Class	Description	Example
org\iso\ISO4217	ISO 4217 currency codes (alpha-3)	ISO4217::USD // 'USD'
org\iso\ISO6391	ISO 639-1 language codes (alpha-2)	ISO6391::EN // 'en'
org\iso\ISO15924	ISO 15924 script codes	ISO15924::LATN // 'Latn'
org\unstats\UNM49	UN M49 country/area codes (alpha-3)	UNM49::FRA // 'FRA'
org\unece\uncefact\MeasureCode	UN/CEFACT Rec. 20 unit codes	MeasureCode::KILOGRAM // 'KGM'
org\unece\uncefact\MeasureName	UN/CEFACT unit names	MeasureName::KILOGRAM // 'Kilogram'
org\unece\uncefact\MeasureSymbol	UN/CEFACT unit symbols	MeasureSymbol::KILOGRAM // 'kg'
org\unece\uncefact\PackageCode	UN/CEFACT Rec. 21 package type codes	PackageCode::BOX // 'BX'
org\unece\uncefact\PackageName	UN/CEFACT package type names	PackageName::BOX // 'Box'

🔧 Core Helper Methods (ConstantsTrait)

All constant classes use oihana\reflections\traits\ConstantsTrait, which provides:

Method	Description
getAll()	Returns a [name => value] map of constants.
enums(int $flags = SORT_STRING)	Returns unique sorted values.
includes(mixed $value, bool $strict = false, ?string $separator = null)	Checks if a value exists.
get(mixed $value, mixed $default = null)	Returns the value if valid, otherwise $default.
validate(mixed $value, bool $strict = true, ?string $separator = null)	Validates or throws an exception.
`getConstant(string $value, array	string
resetCaches()	Clears internal caches.

💡 Usage Examples

Basic Enum Access

use org\iso\ISO4217;
use org\iso\ISO6391;

$usd = ISO4217::USD; // 'USD'
$en  = ISO6391::EN;  // 'en'

Validation & Listing

use org\iso\ISO4217;

ISO4217::validate('EUR');             // OK
$isValid = ISO4217::includes('JPY');  // true
$all     = ISO4217::getAll();         // ['AED' => 'AED', ...]
$values  = ISO4217::enums();          // ['AED', 'AFN', ...]

UN/CEFACT Unit Cross-Lookups

use org\unece\uncefact\MeasureCode;
use org\unece\uncefact\MeasureName;
use org\unece\uncefact\MeasureSymbol;

$code   = MeasureCode::KILOGRAM;        // 'KGM'
$name   = MeasureCode::getName($code);  // 'Kilogram'
$symbol = MeasureCode::getSymbol($code);// 'kg'

// Reverse lookups
$fromName   = MeasureCode::getFromName('Kilogram'); // 'KGM'
$fromSymbol = MeasureCode::getFromSymbol('kg');     // 'KGM'

UN/CEFACT Package Conversion

use org\unece\uncefact\PackageCode;
use org\unece\uncefact\PackageName;

$bx   = PackageCode::BOX;            // 'BX'
$name = PackageCode::getName($bx);   // 'Box'
$code = PackageName::getCode('Box'); // 'BX'

UN M49 Country Codes

use org\unstats\UNM49;

$fr = UNM49::FRA; // 'FRA'

📜 License

MPL 2.0 — Mozilla Public License Version 2.0

👤 Author

• Marc ALCARAZ (aka eKameleon)
• 📧 [e-mail]
• 🌐 http://www.ooop.fr