leocavalcante/shape

Run-time type checks against plain old PHP arrays

Maintainers

Details

github.com/leocavalcante/shape

Source

Issues

Installs: 47 025

Dependents: 2

Suggesters: 0

Security: 0

Stars: 14

Watchers: 3

Forks: 2

Open Issues: 0

dev-master 2020-02-14 13:34 UTC

Requires

  • php: >=7.0

Requires (Dev)

MIT b29c7de10b95e260e8437d70486be7b747022139

  • leocavalcante <lc.woop@leocavalcante.com>

This package is auto-updated.

Last update: 2024-04-14 22:43:11 UTC

README

Run-time type checks against plain old PHP arrays.

composer require leocavalcante/shape dev-master

Why

Validate basic data structures

use function Shape\shape;
use const Shape\int;

$pointShape = shape([
    'x' => int,
    'y' => int,
]);

$validPoint = ['x' => 1, 'y' => 2];

$pointShape($validPoint); // Shape

$invalidPoint = ['x' => 1, 'y' => 'two'];

$pointShape($invalidPoint); // TypeError: Key y passed to shape() must be of the type integer, string given

Mimic tuples

use const Shape\string;
use const Shape\int;
use function Shape\shape;

function string_int_tuple(array $tuple)
{
    // assert it is a (String, Int) tuple
    shape([string, int])($tuple);

    return true;
}

var_dump(string_int_tuple(['one', 1])); // bool(true)

var_dump(string_int_tuple(['one', 'two'])); // TypeError: Key 1 passed to shape() must be of the type integer, string given

shape() function returns a Closure, so you can easily use it to assert vector arrays

use const Shape\int;
use function Shape\shape;

$points = [
    ['x' => 1, 'y' => 2],
    ['x' => 3, 'y' => 4],
];

array_map(shape(['x' => int, 'y' => int]), $points);

Inspiration