simplesamlphp/assert

A wrapper around webmozart/assert to make it useful beyond checking method arguments

v1.4.0 2024-10-28 22:10 UTC

Requires

• php: ^8.1
• ext-date: *
• ext-filter: *
• ext-pcre: *
• ext-spl: *
• league/uri-interfaces: ^7.4
• webmozart/assert: ^1.11

Requires (Dev)

• ext-intl: *
• simplesamlphp/simplesamlphp-test-framework: ^1.7

LGPL-2.1-or-later

• Tim van Dijen
• Jaime Perez Crespo

README

Background

A wrapper around webmozart/assert to make it useful beyond checking method arguments. One of the major reasons to come up with this fork was our requirement to be able to throw custom exceptions, instead of everything being thrown as a generic InvalidArgumentException.

Using a __callStatic wrapper we are able to wrap the webmozart-methods allowing for an extra exception parameter, and catch the InvalidArgumentException by the original library, then throw the desired exception, or fall back to our custom AssertionFailedException.

In practise, this means that every assertion provided by the original library can be used an provided with an additional parameter. If you provide it, and it translates into a Throwable class, that is what will be thrown as soon as the assertion fails. If you don't pass the the extra parameter, we will throw the more generic AssertionFailedException (which in our opinion is still better than the even more generic InvalidArgumentException).

We also felt that InvalidArgumentException is incorrect to use in this case. This exception was intended by PHP to be thrown when a function parameter is of the wrong type. Our custom AssertionFailedException therefore inherits from UnexpectedValueException which is intended to verify values against valid value sets, possibly during the internal computations of a function. We deem this much more appropriate for use in assertions.

Custom Assertions

Another reason to fork is the ability to add a few custom assertions that may only make sense for XML / SAML2 related things.

Currently this library provides the following additional assertions:

Assertions