mehr-als-nix/preconditions

Preconditions for PHP

Preconditions

, _(*1)

Preconditions are meant to be an alternative way to ensure that a precondition for a specific method is given., _(*2)

Available checks

• checkArgument()
• checkArgNotNull()
• checkNotNull()
• checkElementIndex()
• checkPositionIndex()
• checkPositionIndexes()
• checkState()
• checkValue()

Additional exceptions

• IndexOutOfBoundsException
• NullPointerException
• IllegalStateException

Example

Instead of writing, _(*3)

    if ($count <= 0) {
        throw new \InvalidArgumentException("must be positive: " . $count);
    }

you could use a precondition like, _(*4)

    use \MehrAlsNix\Preconditions\PreconditionUtil;
    //...
    PreconditionUtil::checkArgument($count <= 0, 'must be positive: %s', $count);