gem-hunter
Language: PHP
Zod for PHP - Zod-style schema validation with static type inference
A PHP-first port of Zod that mirrors the fluent schema builder and validation pipeline familiar to TypeScript users.
Add the package to your project with Composer:
composer require nyra/zod
use Nyra\Zod\Z; $schema = Z::object([ 'id' => Z::number()->int()->positive(), 'email' => Z::string()->email(), 'roles' => Z::array(Z::string()->nonempty())->nonempty(), ]); $payload = $schema->parse([ 'id' => 42, 'email' => 'dev@example.com', 'roles' => ['admin'], ]);
Schemas are composed with fluent helpers. Every primitive has refinement methods, nullable/optional wrappers, unions, tuples, and objects.
use Nyra\Zod\Z; $userSchema = Z::object([ 'name' => Z::string()->min(2), 'age' => Z::coerce()->number()->int()->min(0)->default(18), 'email' => Z::string()->email()->optional(), 'address' => Z::object([ 'street' => Z::string()->nonempty(), 'zip' => Z::string()->regex('/^[0-9]{5}$/'), ])->passthrough(), ]);
Call parse() to validate and retrieve the typed value. Use safeParse() for success/error separation without exceptions.
$result = $userSchema->safeParse($input); if ($result->success) { $user = $result->data; // validated payload } else { // handle $result->error }
Pipeline helpers support preprocessing and transformation:
$trimmed = Z::string() ->preprocess(static fn ($value) => is_string($value) ? trim($value) : $value) ->nonempty(); $upper = Z::string()->transform('strtoupper');
parse() throws Nyra\Zod\Errors\ZodError. Each error contains one or more ZodIssue entries with codes, messages, and paths.
use Nyra\Zod\Errors\ZodError; try { $userSchema->parse($input); } catch (ZodError $error) { foreach ($error->getIssues() as $issue) { printf("[%s] %s at %s\n", $issue->code, $issue->message, implode('.', $issue->path)); } }
The library returns validated PHP values. Combine schema definitions with PHPDoc or static analysis to keep types aligned:
/** @var array{name: string, age: int, email?: string|null} $user */ $user = $userSchema->parse($input);
When using Psalm or PHPStan, you can declare custom provider extensions that map schema builders to precise array shapes, mirroring how Zod integrates with TypeScript's type inference.