# Valinor

PHP library that maps raw input such as JSON or arrays into typed objects and validates it on the way.


Source: https://findsoftware.frbit.cloud/valinor/
Last reviewed: 2026-11-17
Listed since: 2026-11-17

## Record

### Links

- home: https://valinor-php.dev
- repository: https://github.com/CuyZ/Valinor
- docs: https://valinor-php.dev/latest/getting-started/

### Identity

- status: active
- maintainer: Romain Canon
- maintainerType: unknown
- parent: unknown
- firstRelease: 2021
- hqCountry: unknown

### Kind

- category: library
- hosting: php
- language: php
- runtime: php
- runtimeMin: php 8.2
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: error messages can be translated

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: composer

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 2
- latestReleaseDate: 2026-11-12

### Adoption

- githubStargazers: 1536
- packagistDownloads: 22405548
- npmWeeklyDownloads: not applicable
- contributors: 53
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 21
- dependentPackages: 44

### Sources

- urls: https://valinor-php.dev/latest/ (read 2026-11-17)
- urls: https://valinor-php.dev/latest/getting-started/ (read 2026-11-17)
- urls: https://api.github.com/repos/CuyZ/Valinor (read 2026-11-17)
- maintainer: https://raw.githubusercontent.com/CuyZ/Valinor/master/LICENSE.md (read 2026-11-17)
- category: https://raw.githubusercontent.com/CuyZ/Valinor/master/README.md (read 2026-11-17)
- language: https://api.github.com/repos/CuyZ/Valinor (read 2026-11-17)
- runtime: https://raw.githubusercontent.com/CuyZ/Valinor/2.7.0/composer.json (read 2026-11-17)
- runtimeMin: https://raw.githubusercontent.com/CuyZ/Valinor/2.7.0/composer.json (read 2026-11-17)
- license: https://api.github.com/repos/CuyZ/Valinor (read 2026-11-17)
- licenseModel: https://raw.githubusercontent.com/CuyZ/Valinor/master/LICENSE.md (read 2026-11-17)
- currentMajor: https://github.com/CuyZ/Valinor/releases/tag/2.7.0 (read 2026-11-17)
- latestReleaseDate: https://github.com/CuyZ/Valinor/releases/tag/2.7.0 (read 2026-11-17)
- firstRelease: https://github.com/CuyZ/Valinor/releases/tag/0.1.0 (read 2026-11-17)
- packagistDownloads: https://packagist.org/packages/cuyz/valinor.json (read 2026-11-17)
- githubStargazers: https://api.github.com/repos/CuyZ/Valinor (read 2026-11-17)
- contributors: https://api.github.com/repos/CuyZ/Valinor/contributors?per_page=1 (read 2026-11-17)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/packagist.org/packages/cuyz%2Fvalinor (read 2026-11-17)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/packagist.org/packages/cuyz%2Fvalinor (read 2026-11-17)
- installMethod: https://raw.githubusercontent.com/CuyZ/Valinor/master/README.md (read 2026-11-17)
- i18n: https://valinor-php.dev/latest/how-to/customize-error-messages/ (read 2026-11-17)

## Notes

Valinor is a PHP library that builds typed objects from raw input such as JSON or plain arrays, and validates that input while it does so. The README says the mapper handles native PHP types and the advanced types that PHPStan and Psalm support, such as shaped arrays and generics, and reports human-readable errors for values that do not fit. The error messages can be translated. A normalization mechanism turns objects back into a data format such as JSON or CSV while keeping their structure.

The documentation names a Symfony bundle and a Mezzio package as separate framework integrations. Its alternatives page lists other mapping packages, among them laravel-data.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
