webmozarts/assert

Webmozart Assert is a PHP library that provides assertions to validate method input and output with clear error messages.

The library solves the problem of writing repetitive validation code by offering a set of efficient assertions that throw InvalidArgumentException when they fail. Rather than manually checking conditions and constructing error messages throughout your codebase, you call assertion methods that handle both validation and messaging in a single step. The approach centers on consistent, readable error messages where placeholders follow a uniform pattern across all assertions: the first placeholder always represents the tested value, while subsequent numbered placeholders contain assertion-specific details like bounds or allowed values.

Developers should choose this tool when they want to reduce boilerplate validation code while maintaining clear, debuggable error messages. It suits any PHP project where method contracts need enforcement, from libraries to applications. The README explicitly compares it to beberlei/assert, noting that while both libraries serve similar purposes, Webmozart Assert addresses a usability issue with error message formatting. The key difference is consistent placeholder ordering: beberlei/assert varies the position of %s placeholders depending on the assertion type, whereas this library standardizes the pattern so %s always represents the tested value and additional placeholders follow predictably. This consistency makes it easier to write and understand custom error messages across different assertions.

The project maintains a steady stream of commits addressing bug fixes and minor improvements. Pull requests receive timely review and feedback from maintainers. Issues are actively triaged and responded to, with maintainers providing guidance on usage questions and evaluating feature requests against the library's scope. The codebase shows attention to code quality through consistent review practices.