Download the PHP package martijnvdb/type-vault without Composer
On this page you can find all versions of the php package martijnvdb/type-vault. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download martijnvdb/type-vault
More information about martijnvdb/type-vault
Files in martijnvdb/type-vault
Package type-vault
Short Description Validated types for PHP: Email, UUID, URL, and more
License MIT
Homepage https://github.com/martijnvdb87/type-vault-php
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 type-vault
🔒 Type Vault
Type Vault is a PHP utility package that provides robust and validated types for common structured values like UUIDs, URLs, ISO date-times, hex colors, and more. It helps enforce correctness at runtime while maintaining strong typing.
✨ Features
- ✅ Runtime and compile time validation
- 🧪 Built-in helpers for immutability
- 🔁 Types are
\Stringableand\JsonSerializable
📦 Installation
Install Type Vault from Packagist using Composer:
🧑💻 How to use
📥 Basic Usage
Create a validated Email instance and access or update its value:
🔒 Immutable Variant
Use ::immutable() or pass new TypeOptionsDTO(immutable: true) to prevent value changes after initialization:
🚨 Error Types
All validation-related errors extend TypeVaultValidationError.
InvalidValueError- Thrown when a value fails validation.ImmutableValueError- Thrown when mutating an immutable type value.InvalidPropertyError- Thrown when updating a non-existing DTO property (e.g. incopyWith).InvalidTypeError- Thrown for mismatched types in utilities likeCollection.
🧰 Supported Types
Type Vault offers a rich set of validated types. Each type enforces strict formatting and value constraints at runtime, and all values are stored in a normalized form to ensure consistency and predictability across your application.
🎨 Color Types
For working with color values in various formats:
ColorHex– Hexadecimal color code (e.g.'#ffcc00ff','#ffcc00'or'#fc0')ColorRgb– RGB color object (e.g.'rgb(255 128 0 / 100%)','rgb(255, 128, 0)'or'rgb(255 128 0 / 1)')ColorHsl– HSL color object (e.g.'hsl(360 0 0 / 1)'or'hsl(360deg 0% 0% / 100%)')ColorOklch– OKLCH color object (e.g.'oklch(70 0.4 120deg / 25%)','oklch(70% 100% 120deg / 0.25)'or'oklch(0.7 0.4 120 / 25%)')
🕒 Temporal Types
For representing and validating time-related values:
DateOnly– ISO date string without time (e.g.'2023-01-02'or'2023-1-2')DateTime– ISO UTC date-time string (e.g.'2023-01-02T01:23:45.123Z'or'2023-01-02T01:23:45Z')TimeOnly– ISO time string without date (e.g.'01:23:45.123'or'01:23:45')Duration– ISO 8601 duration string (e.g.'PT1H30M')Month– Valid month name or number (e.g.'january'ordecember)Weekday– Valid weekday name (e.g.'monday')Year– Valid four-digit year (e.g.'2025')
🌐 Communication Types
For validating contact and identity formats:
Email– RFC-compliant email address (e.g.'[email protected]')PhoneNumber– E.164 formatted phone number (e.g.'+31612345678')
✏️ Text & Numeric Types
For structured text, numbers, and identifiers:
Text– A valid text string (e.g.'foo','Lorem ipsum dolor sit amet'or'')Integer– Whole number (e.g.42)FloatingPoint– Decimal number (e.g.3.14)Percentage– Decimal number between 0 and 1 (e.g.0,0.5or1)Url– Valid absolute URL (e.g.'https://example.com')Uuid– RFC 4122 UUID string (e.g.'550e8400-e29b-41d4-a716-446655440000')
