https://github.com/yulia633/php-oop-project-lvl1
The training project by Hexlet
https://github.com/yulia633/php-oop-project-lvl1
oop-php php phpunit studing-for-fun validator
Last synced: 4 days ago
JSON representation
The training project by Hexlet
- Host: GitHub
- URL: https://github.com/yulia633/php-oop-project-lvl1
- Owner: yulia633
- Created: 2022-07-05T17:24:35.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-08-07T17:24:08.000Z (over 3 years ago)
- Last Synced: 2025-12-27T07:11:47.451Z (4 months ago)
- Topics: oop-php, php, phpunit, studing-for-fun, validator
- Language: PHP
- Homepage:
- Size: 28.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### Hexlet tests and linter status:
[](https://github.com/yulia633/php-oop-project-lvl1/actions)
[](https://github.com/yulia633/php-oop-project-lvl1/actions)
[](https://codeclimate.com/github/yulia633/php-oop-project-lvl1/test_coverage)
[](https://codeclimate.com/github/yulia633/php-oop-project-lvl1/maintainability)
### О коде
Валидация строк, чисел и массивов в соответствии с предопределенными или пользовательскими правилами.
#### Проверка строк
```php
string();
// Каждый вызов возвращает новую схему,
// так как у нас может быть любое количество независимых проверок
$schema2 = $v->string(); // $schema != $schema2
$schema->isValid(''); // true
// Null валидное значение для всех валидаторов
// если не задан required
$schema->isValid(null); // true
$schema->isValid('what does the fox say'); // true
$schema->required();
$schema2->isValid(''); // По прежнему валидно, это другая схема
$schema->isValid(null); // А тут не валидно
$schema->isValid(''); // И тут тоже
$schema->isValid('hexlet'); // true
$schema->contains('what')->isValid('what does the fox say'); // true
$schema->contains('whatthe')->isValid('what does the fox say'); // false
// Если один валидатор вызывался несколько раз
// то последний имеет приоритет (перетирает предыдущий)
$v->string()->minLength(10)->minLength(5)->isValid('Hexlet'); // true
```
#### Проверка чисел
```php
number();
$schema->isValid(null); // true
$schema->required();
$schema->isValid(null); // false
// Достаточно работать с типом Integer
$schema->isValid(7); // true
$schema->positive()->isValid(10); // true
$schema->range(-5, 5);
$schema->isValid(-3); // false
$schema->isValid(5); // true
```
#### Проверка массивов
```php
array();
$schema->isValid(null); // true
$schema = $schema->required();
$schema->isValid([]); // true
$schema->isValid(['hexlet']); // true
$schema->sizeof(2); // true
$schema->isValid(['hexlet']); // false
$schema->isValid(['hexlet', 'code-basics']); // true
// Позволяет описывать валидацию для ключей массива
$schema->shape([
'name' => $v->string()->required(),
'age' => $v->number()->positive(),
]);
$schema->isValid(['name' => 'kolya', 'age' => 100]); // true
$schema->isValid(['name' => 'maya', 'age' => null]); // true
$schema->isValid(['name' => '', 'age' => null]); // false
$schema->isValid(['name' => 'ada', 'age' => -5]); // false
```
#### Добавление собственных валидаторов
```php
str_starts_with($value, $start);
// Метод добавления новых валидаторов
// addValidator($type, $name, $fn)
$v->addValidator('string', 'startWith', $fn);
// Новые валидаторы вызываются через метод test
$schema = $v->string()->test('startWith', 'H');
$schema->isValid('exlet'); // false
$schema->isValid('Hexlet'); // true
$fn = fn($value, $min) => $value >= $min;
$v->addValidator('number', 'min', $fn);
$schema = $v->number()->test('min', 5);
$schema->isValid(4); // false
$schema->isValid(6); // true
// Если валидатора нет, то бросаем исключение
$v->addValidator('wrong-name', 'startWith', $fn); // boom!
```