endou-mame/php-value-object

📦 The PHP Value Object library offers immutable, type-safe, and self-validating objects to model domain values using the Value Object pattern.

v0.5.0 2026-02-16 14:30 UTC

Requires

• php: >=8.4
• endou-mame/php-monad: ^1.0

Requires (Dev)

• endou-mame/php-cs-fixer-config: ~8.4.4
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.1
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/php-code-coverage: ^11.0
• phpunit/phpunit: ^11.3

MIT

• Kakiuchi Shigenao

README

不変性、型安全性、自己検証を持つドメイン値オブジェクトを提供する PHP ライブラリです。

インストール

composer require endou-mame/php-value-object

使用例

カスタム値オブジェクトの作成

use EndouMame\PhpValueObject\String\StringValue;
use EndouMame\PhpValueObject\ValueObjectMeta;

#[ValueObjectMeta(name: '商品コード')]
final readonly class ProductCode extends StringValue
{
    protected static function minLength(): int { return 5; }
    protected static function maxLength(): int { return 5; }
    protected static function regex(): string { return '/^P[0-9]{4}$/'; }
}

$code = ProductCode::from('P1234');

Result 型によるエラーハンドリング

use EndouMame\PhpMonad\Result;

$result = ProductCode::tryFrom('invalid');

$code = $result
    ->map(fn($code) => $code->value())
    ->unwrapOr('デフォルト');

ドキュメント

詳細なガイドと API リファレンスは ドキュメントサイト を参照してください。

要件

• PHP 8.4 以上

ライセンス

MIT License