2017 © Pedro Peláez
 

library arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

image

heartsentwined/arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  • Wednesday, July 6, 2016
  • by heartsentwined
  • Repository
  • 3 Watchers
  • 7 Stars
  • 20,790 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 5 Forks
  • 0 Open issues
  • 12 Versions
  • 3 % Grown

The README.md

Yalesov\ArgValidator

Build Status, (*1)

Solving several function argument validation/typehinting issues in PHP:, (*2)

Primitive typehints:, (*3)

function foo(string $foo) {}

Mixed / advanced typehints:, (*4)

function foo(array|string|null $foo, int/*between 3-10*/ $bar) {}

"array of X" typehints:, (*5)

function foo(Array_of_strings $foo) {}

Validating / typehinting "pseudo named function paramters" through array members:, (*6)

/**
 * @param array $params
 *  - 'foo' => string
 *  - 'bar' => int
 */
function foo(array $params) {}

Declaring required constants in classes (interface-style function):, (*7)

class Foo {
  /* const BAR required */
  /* const BAZ required */
}

Installation

Composer:, (*8)

{
  "require": {
    "yalesov/arg-validator": "2.*"
  }
}

Usage

Simple argument validation

Validates that $foo is an integer, throwing an InvalidArgumentException if validation failed., (*9)

use Yalesov\ArgValidator\ArgValidator;

function foo($foo)
{
  ArgValidator::assert($foo, 'int');
  // throw InvalidArgumentException if $foo is not int
  // do something
}

Validates that $foo is an integer, return boolean., (*10)

use Yalesov\ArgValidator\ArgValidator;

function foo($foo)
{
  $result = ArgValidator::assert($foo, 'int', false);
  // $result = false if invalid
  // do something
}

Full function signature:, (*11)

public static function assert($arg, $checks, $exception = true)

Valid argument types are specified through the $checks parameter. A string, or an array of the following accepted. $arg will be considered valid if it satisfies any one of the specified checks., (*12)

  • Flags
    • arrayof: will check for an array of remaining specified types, instead of plain types, e.g. array('arrayOf', 'string', 'int') = an array of string, or an array of int. Note: Empty array will be considered valid
    • min, max
    • combine with int, float: min and max value
    • combine with string: min and max length
    • combine with array: min and max count
  • Types
    • int
    • float
    • numeric
    • string
    • array
    • null
    • callable
    • bool
    • resource
    • notEmpty: equivalent to !empty()
    • (an array of scalars for in_array check), e.g. array('foo', 'bar') will check for in_array($arg, array('foo', 'bar')). Note: ArgValidator::assert($arg, array('foo', 'bar')) will be interpreted as instanceof checks against foo and bar. To specify an in_array check, wrap it in another array: ArgValidator::assert($arg, array(array('foo', 'bar'))).
    • (a string): assumed to be an instanceof check, should be a fully-qualified name of Class/Interface

"Named parameters" validation

use Yalesov\ArgValidator\ArgValidator;

function foo(array $params)
{
  ArgValidator::arrayAssert($params, array(
    'foo' => 'float',
    'bar' => array('string', 'notSet'),
    'baz' => array('int', 'string', 'min' => 2),
  ));
  // $params['foo'] should be a float
  // $params['bar'] should be a string, if set, or not set at all
  // $params['baz'] can be either an int (>=2), or a string (strlen >= 2)
}

Full function signature:, (*13)

public static function arrayAssert(array $arg, array $checks, $exception = true)

Valid argument types are same as above, except with the addition of a notSet type., (*14)

Check class constants

namespace Foo;

use Yalesov\ArgValidator\ArgValidator;

class FooClass {
  const FOO = 'foo';
  const BAR = 2;
}

ArgValidator::assertClassConstant('Foo\FooClass', array('FOO', 'BAR'));
// \Foo\FooClass must have the constants 'FOO' and 'BAR' set

Full function signature:, (*15)

public static function assertClassConstant($className, $constants, $exception = true)

$className should be a fully-qualified class name; $constants should be an array of strings, each member being the constant name., (*16)

ArgValidator::assertClassConstant() will check for:, (*17)

  1. the class $className exists
  2. the class has declared the required constants specified in $constants

Misc

To centralize exception handling on argument validations, ArgValidator also provides two helper functions:, (*18)

Assert that a class exists, throw InvalidArgumentException otherwise:, (*19)

public static function assertClass($className, $exception = true)

Throw an InvalidArgumentException about the given variable name is not set:, (*20)

public static function throwIssetException($argName)

Note: this function doesn't actually perform the isset check. I can't find a way to abstract the isset check away, without the variable being set in the first place (in order to act as argument to call this function with)., (*21)

The Versions

06/07 2016

dev-master

9999999-dev https://github.com/yalesov/php-arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

ISC

The Requires

  • php >=5.3.3

 

The Development Requires

by Yulij Andreevich Lesov

validator validate argument typehint typehinting

06/07 2016

v2.1.1

2.1.1.0 https://github.com/yalesov/php-arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

ISC

The Requires

  • php >=5.3.3

 

The Development Requires

by Yulij Andreevich Lesov

validator validate argument typehint typehinting

05/07 2016

v2.1.0

2.1.0.0 https://github.com/yalesov/php-arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

ISC

The Requires

  • php >=5.3.3

 

The Development Requires

by Yulij Andreevich Lesov

validator validate argument typehint typehinting

05/07 2016

v2.0.3

2.0.3.0 https://github.com/yalesov/php-arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

ISC

The Requires

  • php >=5.3.3

 

The Development Requires

by Yulij Andreevich Lesov

validator validate argument typehint typehinting

05/07 2016

v2.0.2

2.0.2.0 https://github.com/yalesov/php-arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

ISC

The Requires

  • php >=5.3.3

 

by Yulij Andreevich Lesov

validator validate argument typehint typehinting

05/07 2016

v2.0.1

2.0.1.0 https://github.com/yalesov/php-arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

ISC

The Requires

  • php >=5.3.3

 

by Yulij Andreevich Lesov

validator validate argument typehint typehinting

05/07 2016

v2.0.0

2.0.0.0 https://github.com/yalesov/php-arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

ISC

The Requires

  • php >=5.3.3

 

by Yulij Andreevich Lesov

validator validate argument typehint typehinting

03/10 2012

1.1.3

1.1.3.0 https://github.com/heartsentwined/arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

GPL-3.0

The Requires

  • php >=5.3.3

 

by Avatar heartsentwined

validator validate argument typehint typehinting

28/09 2012

1.1.2

1.1.2.0 https://github.com/heartsentwined/arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

GPL-3.0

The Requires

  • php >=5.3.3

 

by Avatar heartsentwined

validator validate argument typehint typehinting

27/09 2012

1.1.1

1.1.1.0 https://github.com/heartsentwined/arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

GPL-3.0

The Requires

  • php >=5.3.3

 

by Avatar heartsentwined

validator validate argument typehint typehinting

06/09 2012

1.1.0

1.1.0.0 https://github.com/heartsentwined/arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

GPL-3.0

The Requires

  • php >=5.3.3

 

by Avatar heartsentwined

validator validate argument typehint typehinting

06/09 2012

1.0.0

1.0.0.0 https://github.com/heartsentwined/arg-validator

Validate function arguments, extending typehinting capabilities of PHP.

  Sources   Download

GPL-3.0

The Requires

  • php >=5.3.3

 

by Avatar heartsentwined

validator validate argument typehint typehinting