PHPackages qdenka/easyvalidation - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. qdenka/easyvalidation ActiveLibrary[Mail & Notifications](/categories/mail) qdenka/easyvalidation ===================== EasyValidation โ€” a package for simple, fast, and extendable data validation (email, URL, number, date, credit card, IP, phone, etc.). 1.1(6mo ago)31MITPHPPHP >=7.4CI passing Since May 14Pushed 6mo ago1 watchersCompare [ Source](https://github.com/QDenka/EasyValidation)[ Packagist](https://packagist.org/packages/qdenka/easyvalidation)[ Docs](https://github.com/qdenka/easyvalidation)[ RSS](/packages/qdenka-easyvalidation/feed)WikiDiscussions main Synced 2w ago READMEChangelog (2)Dependencies (3)Versions (5)Used By (0) EasyValidation ============== [](#easyvalidation) [![Latest Stable Version](https://camo.githubusercontent.com/e1f669e681376124522176f86ee09064d5e333f1d7a72c9d58d0a6b0bdafd2c9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7164656e6b612f6561737976616c69646174696f6e)](https://packagist.org/packages/qdenka/easyvalidation) [![License](https://camo.githubusercontent.com/4d6ec7a76bb3d6ebaded85173d65d9259b4c3924edf204daced0559c0ba48fab/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7164656e6b612f6561737976616c69646174696f6e)](LICENSE) ![Total Downloads](https://camo.githubusercontent.com/5437a7c09c4dc7cf093b33ce6d24614ed5ab1d148aed529a62ec92ae4601c67e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7164656e6b612f6561737976616c69646174696f6e) **EasyValidation** is a lightweight PHP library for validating common data types. Built with DDD, SOLID, and DRY principles, it offers both a factory-based API and convenient static helper methods. --- ๐Ÿ“‹ Table of Contents ------------------- [](#-table-of-contents) - [โœจ Features](#-features) - [โš™๏ธ Requirements](#%EF%B8%8F-requirements) - [๐Ÿš€ Installation](#-installation) - [๐Ÿ› ๏ธ Usage](#%EF%B8%8F-usage) - [Factory API](#factory-api) - [Static Helpers](#static-helpers) - [๐Ÿ“‘ Available Validators](#-available-validators) - [โš™๏ธ Configuration](#%EF%B8%8F-configuration) - [๐Ÿงฉ Extending](#-extending) - [๐Ÿงช Testing](#-testing) - [๐Ÿค Contributing](#-contributing) - [๐Ÿ“„ License](#-license) --- โœจ Features ---------- [](#-features) - โœ… Validate emails (standard, Gmail-only, disposable) - โœ… Validate URLs, numbers, dates - โœ… Validate IPs (IPv4 & IPv6) - โœ… Validate UUIDs (v1โ€“v5) - โœ… Validate JSON and Base64 strings - โœ… Validate international phone numbers (E.164) - ๐Ÿ“ฆ PSR-4 autoloading - ๐Ÿ”„ Factory-based API + static helpers - โš™๏ธ Easily extendable with new validators --- โš™๏ธ Requirements --------------- [](#๏ธ-requirements) - PHP ^7.4 || ^8.0 --- ๐Ÿš€ Installation -------------- [](#-installation) Install with Composer: ``` composer require qdenka/easyvalidation ``` Autoloading is configured via PSR-4 (`QDenka\EasyValidation\`). --- ๐Ÿ› ๏ธ Usage -------- [](#๏ธ-usage) ### Factory API [](#factory-api) Use `ValidatorFactory` to retrieve any validator by its type key: ``` use QDenka\EasyValidation\Application\Validators\ValidatorFactory; $types = ['email','google_email','disposable_email','url','number','date','ip','uuid','json','base64','phone']; foreach ($types as $type) { $validator = ValidatorFactory::create($type); $value = 'test_value_for_' . $type; if ($validator && $validator->validate($value)) { echo "[$type] valid\n"; } else { echo "[$type] invalid\n"; } } ``` ### Static Helpers [](#static-helpers) For quick checks, use the `Validator` facade: ``` use QDenka\EasyValidation\Infrastructure\Factories\Validator; if (Validator::isValidEmail('user@example.com')) { echo "Valid email"; } if (Validator::isGoogleMail('user@gmail.com')) { echo "It's a Gmail address"; } if (Validator::isDisposableEmail('temp@mailinator.com')) { echo "Disposable email detected"; } // Other helpers: Validator::isValidUrl('https://example.com'); Validator::isValidNumber('123.45'); Validator::isValidDate('2023-04-23'); Validator::isValidIp('2001:db8::1'); Validator::isValidUuid('550e8400-e29b-41d4-a716-446655440000'); Validator::isValidJson('{"foo":1}'); Validator::isValidBase64(base64_encode('hello')); Validator::isValidPhone('+1234567890'); ``` --- ๐Ÿ“‘ Available Validators ---------------------- [](#-available-validators) TypeStatic HelperDescription`email``isValidEmail()`RFC-compliant email`google_email``isGoogleMail()`Gmail & Googlemail domains`disposable_email``isDisposableEmail()`Blacklisted disposable domains`url``isValidUrl()`HTTP/HTTPS URLs`number``isValidNumber()`Numeric values`date``isValidDate()`Date in `Y-m-d` (configurable format)`ip``isValidIp()`IPv4 & IPv6 addresses`uuid``isValidUuid()`UUID v1โ€“v5`json``isValidJson()`JSON string parsing`base64``isValidBase64()`Base64-encoded data`phone``isValidPhone()`International E.164 phone numbers--- โš™๏ธ Configuration ---------------- [](#๏ธ-configuration) ### Disposable Domains List [](#disposable-domains-list) Customize disposable email domains by editing `config/disposable_domains.php`: ``` return [ 'mailinator.com', '10minutemail.com', // add your domains here ]; ``` Ensure all domains are lowercase. --- ๐Ÿงฉ Extending ----------- [](#-extending) To add a new validator: 1. Implement `ValidatorInterface` in `src/Domain/YourType/YourValidator.php`. 2. Register your class in `ValidatorFactory` (`src/Application/Validators/ValidatorFactory.php`). 3. (Optional) Add a static helper in `Validator` facade (`src/Infrastructure/Factories/Validator.php`). 4. Write tests under `tests/` following existing patterns. --- ๐Ÿงช Testing --------- [](#-testing) Run PHPUnit: ``` vendor/bin/phpunit --colors ``` All tests must pass before merging. --- ๐Ÿค Contributing -------------- [](#-contributing) 1. Fork repository 2. Create a feature branch (`git checkout -b feature/NewValidator`) 3. Commit changes (`git commit -m 'Add NewValidator'`) 4. Push (`git push origin feature/NewValidator`) 5. Open a Pull Request Follow PSR-12 coding standards and include tests. --- ๐Ÿ“„ License --------- [](#-license) This project is licensed under the MIT License. See [LICENSE](LICENSE) for details. ### Health Score 32 โ€” LowBetter than 69% of packages Maintenance67 Regular maintenance activity Popularity5 Limited adoption so far Community9 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 83.3% of commits โ€” single point of failure How is this calculated?**Maintenance (25%)** โ€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** โ€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** โ€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** โ€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~269 days Total 2 Last Release 191d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/3339fb58d7742b5f4ce6a647b09c74739d28b9ecfc85ffb5de6d2f04b6985b82?d=identicon)[qdenka](/maintainers/qdenka) --- Top Contributors [![QDenka](https://avatars.githubusercontent.com/u/77678360?v=4)](https://github.com/QDenka "QDenka (15 commits)")[![denkaq](https://avatars.githubusercontent.com/u/125537746?v=4)](https://github.com/denkaq "denkaq (3 commits)") --- Tags urlvalidationemailphonedateregexIPcreditcardnumber ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/qdenka-easyvalidation/health.svg) ``` [![Health](https://phpackages.com/badges/qdenka-easyvalidation/health.svg)](https://phpackages.com/packages/qdenka-easyvalidation) ``` ### Alternatives [egulias/email-validator A library for validating emails against several RFCs 11.6k750.6M500](/packages/egulias-email-validator)[cakephp/cakephp The CakePHP framework 8.9k20.0M1.9k](/packages/cakephp-cakephp)[api-platform/state API Platform state interfaces 275.4M157](/packages/api-platform-state)[arubacao/tld-checker Top Level Domain (TLD) validation library for PHP 731.8M3](/packages/arubacao-tld-checker)[neverbounce/neverbounce-php This package provides convenient methods to integrate the NeverBounce API into your project. 241.2M4](/packages/neverbounce-neverbounce-php)[stymiee/email-validator A robust PHP 7.4+ email validation library that extends beyond basic validation with MX record checks, disposable email detection, and free email provider validation. Features include strict typing, custom validator support, internationalization (i18n), and an extensible architecture. Perfect for applications requiring thorough email verification with customizable validation rules. 33509.1k1](/packages/stymiee-email-validator) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)