mediagone/types-common

A collection of generic Value Objects you should (always) use instead of primitive types!

0.7.13 2024-04-26 13:41 UTC

Requires

• php: ^7.4|^8.0
• ext-iconv: *
• ext-json: *
• ext-mbstring: *

Requires (Dev)

• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^9.5.25

MIT

• Bruce Suire

• type
• ddd
• value objects

README

Value Objects are small and immutable classes representing typed values usually implemented using PHP primitive types. However, objects can embed validation to ensure that your data is always valid without adding any check elsewhere in your code. That's why you should ALWAYS use Value Objects rather than primitive types!

This package provides most common types you can use in any project.

Installation

This package requires PHP 7.4+

Add it as Composer dependency:

$ composer require mediagone/types-common

Available value-objects

All value-objects implement a common ValueObject interface and JsonSerializable.

Business

• Bic
• Iban

Crypto

• Hash (abstract class)
• HashBcrypt
• HashArgon2id
• RandomToken
• Sha512

Note: all Hash* types are based on Hash base class, so they are perfectly interoperable.

Geo

• Address
• City
• Country
• Latitude
• Longitude

Graphics

• Color

System

• Age
• Base64
• Binary
• Count
• Date
• DateTimeUTC
• DayOfMonth
• Duration
• Hex
• Quantity

Text

• Name
• NameDigit
• NameSpecial
• Slug
• SlugSnake
• Text
• TextMedium
• Title

Web

• EmailAddress
• Url
• UrlHost
• UrlPath

License

Types Common is licensed under MIT license. See LICENSE file.