Download the PHP package lemmon/validator without Composer

Lemmon Validator

[!NOTE] This library is in active development. The API may change in future versions as we refine and improve the developer experience based on real-world usage and feedback.

Lemmon Validator is a comprehensive, fluent validation and data processing library for PHP that prioritizes developer experience, type safety, and real-world practicality. Inspired by modern validation libraries like Valibot and Zod, it brings a chainable, readable API to PHP for validation, transformation, and sanitization with intelligent error handling and form-safe defaults.

Installation

Requirements: PHP 8.3 or higher

About

Philosophy: "Simple and Minimal with Extensibility Over Reinvention"

Rather than reimplementing every possible transformation or validation rule, Lemmon Validator provides a solid foundation with generic transform() and pipe() methods that integrate seamlessly with PHP's ecosystem. Need complex string transformations? Plug in Laravel's Str class through our transformation system. Need advanced array operations? Connect Laravel Collections via our fluent API. The library focuses on what it does best: type-safe validation with excellent developer experience, while enabling you to leverage the entire PHP ecosystem.

Key Design Principles:

• Type-Safe Architecture: Modern PHP 8.1+ enums provide IDE autocomplete, refactoring safety, and eliminate magic strings throughout the codebase
• Smart Null Handling: Validations skip null unless required(). transform() and pipe() skip null by default for type safety. Use transform($fn, skipNull: false) to process null values.
• Form Safety First: Empty strings coerce to null (not dangerous 0/false) to prevent real-world issues like accidental zero bank balances
• Fluent API with Execution Order Guarantee: Validation rules read like natural language and execute in the exact order written -- Validator::isString()->pipe('trim')->nullifyEmpty()->required()
• Last-Resort Default: default() is a flag applied after the pipeline -- fills in null only as a last resort, before required() enforces presence
• Fail-Fast Per Field: Each validator stops at the first failing rule, while schema validation still aggregates errors across fields
• API-Friendly Error Format: Flattened errors with field paths ('_root' for root-level, dot notation for nested) perfect for frontend consumption
• Type-Aware Transformations: Intelligent transformation system that maintains type context and handles coercion automatically
• Extensible Architecture: Generic transformation methods work with any PHP callable or external library
• Strict Typing: All files use declare(strict_types=1);, keeping internal type hints strict; opt into coerce() when you need form-friendly conversions.

Features

• Type-safe architecture - PHP 8.1+ enums with IDE autocomplete, refactoring safety, and zero magic strings
• Smart null handling - validations skip null unless required(), transform()/pipe()/nullifyEmpty() skip null by default
• Type-safe validation for strings, integers, floats, arrays, and objects
• Fluent, chainable API with guaranteed execution order -- methods execute exactly as written in the chain
• Schema-level error aggregation with fail-fast behavior per field for clear, early feedback
• Structured errors - getStructuredErrors() returns ValidationError objects with a stable code (see ValidationCode), dotted path, message, and params for programmatic handling and i18n; match on codes rather than message text
• API-friendly flattened errors with field paths for easy frontend integration (getFlattenedErrors(), ValidationException::flattenErrors())
• Intuitive custom validation with satisfies() method and optional error messages
• Single-value validation with const() for exact value matching (available on all validators)
• PHP enum validation with enum() for BackedEnum (backed values) and UnitEnum (case instances or string case names) (available on all validators)
• Logical combinators (Validator::allOf(), Validator::anyOf(), Validator::not()) for complex validation logic
• Form-safe coercion - empty strings become null (not dangerous 0/false) for real-world safety
• Accurate schema validation - results only include provided fields and fields with defaults (no unexpected properties)
• Universal transformations (transform(), pipe()) for post-validation data processing
• Null-safe operations with nullifyEmpty() method for consistent empty value handling

Quick Start

All runtime classes live under the Lemmon\Validator namespace.

Documentation

Getting Started

• Installation & Setup
• Basic Usage
• Core Concepts

Validation Guides

• String Validation -- Email, URL, patterns, length constraints
• Numeric Validation -- Integers, floats, ranges, constraints
• Array Validation -- Indexed arrays and item validation
• Object & Schema Validation -- Complex nested structures
• Custom Validation -- User-defined functions and business logic
• Error Handling -- Working with validation errors

API Reference

• Validator Factory

Examples

• Form Validation

For AI Agents

• llms.txt - Complete technical specification with full API signatures, method parameters, and core concepts. Download this file and provide it to your AI agent for accurate code generation and assistance with the library.

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Links

• Packagist
• GitHub Repository
• Issue Tracker
• Changelog