PHPackages vinogradova/sanitizer - 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. [Validation & Sanitization](/categories/validation) 4. / 5. vinogradova/sanitizer ActiveLibrary[Validation & Sanitization](/categories/validation) vinogradova/sanitizer ===================== Sanitizer - валидатор для струкртур данных из формата \[key => value\] v1.0.4(2y ago)08PHPPHP >=8.0.0 Since Jun 10Pushed 2y ago1 watchersCompare [ Source](https://github.com/vinogrartati/sanitizer)[ Packagist](https://packagist.org/packages/vinogradova/sanitizer)[ RSS](/packages/vinogradova-sanitizer/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (1)Versions (6)Used By (0) Sanitizer ========= [](#sanitizer) [![Maintainability](https://camo.githubusercontent.com/52a93d8d62d282c7030ec185789870f5c110d57401289b0259c8b763d39dd808/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f63643764396439356166313966383530353431642f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/vinogrartati/sanitizer/maintainability) [![Test Coverage](https://camo.githubusercontent.com/087bbbbb142c0ab29d5b069f562f5a1b882fe80c614c89821306b971ea58ebd5/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f63643764396439356166313966383530353431642f746573745f636f766572616765)](https://codeclimate.com/github/vinogrartati/sanitizer/test_coverage) Техническое задание ------------------- [](#техническое-задание) Предположим, что перед нами стоит задача обработать HTTP-запрос от клиента или ответ от стороннего API, содержащий данные в формате JSON. Нужно написать библиотеку "санитайзер", которая занимается валидацией и нормализацией данных в соответствии с переданной спецификацией. Требования: - Самостоятельное выполнение задания без оглядки на существующие решения - Язык PHP/Python/JavaScript/TypeScript без использования сторонних библиотек (кроме библиотек для тестирования) - Поддержка следующих типов данных: - Строка - Целое число - Число с плавающей точкой - Российский федеральный номер телефона - Структура (ассоциативный массив с заранее известными ключами) - Массив из однотипных элементов - Должна быть возможность указать типы элементов массивов и структур - Значения элементов в структурах и массивах могут быть любого из поддерживаемых типов (в том числе другие массивы, структуры, массивы структур, структуры массивов, массивы массивов структур и так далее) - Генерация списка всех ошибок для некорректных значений. Формат описания ошибок должен предоставлять возможность сопоставить каждую ошибку с исходным значением. Например, если входные данные были сгенерированы на основе HTML-формы с вложенными (табличными) полями, должно быть технически возможно сопоставить каждую ошибку конкретному полю формы - Тесты Примеры: 1. из JSON '{"foo": "123", "bar": "asd", "baz": "8 (950) 288-56-23"}' при указанных программистом типах полей "целое число", "строка" и "номер телефона" соответственно должен получиться ассоциативный массив с тремя полями: целочисленным foo = 123, строковым bar = "asd" и строковым "baz" = "79502885623" 2. при указании для строки "123абв" типа "целое число" должна быть сгенерирована ошибка 3. при указании для строки "260557" типа "номер телефона" должна быть сгенерирована ошибка Реализация ---------- [](#реализация) ``` $data = ['a' => [9502900655, 89502900655, 79502900655, "+7(950)290-06-55"]]; $typeData = ['a' => ['phone']]; $sanitizerV1 = new Sanitizer($data, $typeData); $sanitizerV1->sanitize(); // Результат // ['a' => ["79502900655", "79502900655", "79502900655", "79502900655"]] ``` ``` $data = [ 'a' => [9502912600, 89502912600, 79502912600, "+7(950)291-26-00"], 'b' => 234.5, 'c' => [ 'aa' => "abc", "bb" => 234, "cc" => [1, 2, 3], ], 'd' => [123, 123, 234], 'e' => [ 'array' => [123, 123, 123], ] ]; $typeData = [ 'a' => ['phone'], 'b' => 'float', 'c' => ['aa' => 'float', 'bb' => 'integer', 'cc' => ['integer']], 'd' => ['integer123'], 'e' => ['array' => ['phone']], ]; $sanitizerV2 = new Sanitizer($data, $typeData); $sanitizerV2->sanitize(); // Результат // [ // 'a' => ['79502912600', '79502912600', '79502912600', '79502912600'], // 'b' => 234.5, // 'c' => [ // 'aa' => '"abc" является типом string. Для него был указан тип: float.', // "bb" => 234, // "cc" => [1, 2, 3], // ], // 'd' => [ // 'Неизвестный тип данных: integer123.', // 'Неизвестный тип данных: integer123.', // 'Неизвестный тип данных: integer123.', // ], // 'e' => [ // 'array' => [ // 'Значение не соответстует формату номера телефона.', // 'Значение не соответстует формату номера телефона.', // 'Значение не соответстует формату номера телефона.', // ] // ] // ]; ``` Санитайзер принимает на входе данные и типы для них в формате: \['key' => value\]. Метод sanitize возвращает результат валидации данных. Поддерживаемые типы данных -------------------------- [](#поддерживаемые-типы-данных) - string - integer - float - phone - array - передаётся массив с типом данных внутри. Например, \['string'\] - object - передаётся ассоциативный массив, где ключи совпадают с ключами данных, а значения это типы данных. Например, \['a' => 'string'\] В массивы и объекты могут быть вложены другие массивы, другие объекты и т.д. ### Запуск тестов [](#запуск-тестов) ``` $ make test ``` ### Health Score 23 — LowBetter than 27% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community7 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~0 days Total 5 Last Release 1065d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/e871f1a5bd45f63847ccdd76d66a4fe0a581388a3e69c1dae58ed1ace3b13040?d=identicon)[vinogrartati](/maintainers/vinogrartati) --- Top Contributors [![vinogrartati](https://avatars.githubusercontent.com/u/42060750?v=4)](https://github.com/vinogrartati "vinogrartati (23 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/vinogradova-sanitizer/health.svg) ``` [![Health](https://phpackages.com/badges/vinogradova-sanitizer/health.svg)](https://phpackages.com/packages/vinogradova-sanitizer) ``` ### Alternatives [webmozart/assert Assertions to validate method input/output with nice error messages. 7.6k894.0M1.2k](/packages/webmozart-assert)[bensampo/laravel-enum Simple, extensible and powerful enumeration implementation for Laravel. 2.0k15.9M105](/packages/bensampo-laravel-enum)[swaggest/json-schema High definition PHP structures with JSON-schema based validation 48612.5M73](/packages/swaggest-json-schema)[stevebauman/purify An HTML Purifier / Sanitizer for Laravel 5325.6M19](/packages/stevebauman-purify)[ashallendesign/laravel-config-validator A package for validating your Laravel app's config. 217905.3k5](/packages/ashallendesign-laravel-config-validator)[crazybooot/base64-validation Laravel validators for base64 encoded files 1341.9M8](/packages/crazybooot-base64-validation) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)