PHP MIT

phpstan-webmozart-assert

PHPStan extension for webmozart/assert

P

phpstan

Dernière activité 28 sept. 2026
phpstan/phpstan-webmozart-assert

184

étoiles

32

forks

9

issues ouvertes

assertphpphp7phpstanstatic-analysisstatic-code-analysis

Ce README est souvent en anglais.

PHPStan webmozart/assert extension

Build Latest Stable Version License

Description

The main scope of this extension is to help PHPStan to detect the type of object after the Webmozart\Assert\Assert validation.

<?php declare(strict_types = 1);

use Webmozart\Assert\Assert;

function demo(?int $a) {
	// ...

	Assert::integer($a);
	// PHPStan is now aware that $a can no longer be `null` at this point

	return ($a === 10);
}

Supported assertions

This extension understands the following Assert::* methods and narrows types accordingly.

All assertions also work with the nullOr*(), all*(), and allNullOr*() prefixes (e.g. Assert::nullOrString(), Assert::allInteger(), Assert::allNullOrNotEmpty()).

Type checks

integer, positiveInteger, natural, float, numeric, integerish, boolean, scalar, string, stringNotEmpty, object, resource, isCallable, isArray, isIterable, isTraversable, isList, isNonEmptyList, isMap, isNonEmptyMap, isCountable, isArrayAccessible

Instance and class checks

isInstanceOf, isInstanceOfAny, notInstanceOf, isAOf, isAnyOf, isNotA, subclassOf, implementsInterface, classExists, interfaceExists

Comparison

same, notSame, eq, notEq, greaterThan, greaterThanEq, lessThan, lessThanEq, range, true, false, null, notNull, notFalse, inArray, oneOf

String assertions

contains, startsWith, endsWith, startsWithLetter, unicodeLetters, alpha, digits, alnum, lower, upper, uuid, ip, ipv4, ipv6, email, notWhitespaceOnly, length, minLength, maxLength, lengthBetween

Count assertions

count, minCount, maxCount, countBetween

Object and array

keyExists, keyNotExists, validArrayKey, methodExists, propertyExists

Negative all* assertions

allNotNull, allNotInstanceOf, allNotSame

Installation

To use this extension, require it in Composer:

composer require --dev phpstan/phpstan-webmozart-assert

If you also install phpstan/extension-installer then you're all set!

Manual installation

If you don't want to use phpstan/extension-installer, include extension.neon in your project's PHPStan config:

includes:
    - vendor/phpstan/phpstan-webmozart-assert/extension.neon

Projets similaires

Symfony extension for PHPStan

PHPphpphp7phpstan
Pphpstan
804 étoiles104

PHPUnit extensions and rules for PHPStan

PHPphpphp7phpstan
Pphpstan
545 étoiles58

PHP Static Analysis Tool - discover bugs in your code without running it!

PHPphpphp7phpstan
Pphpstan
14,1 k étoiles960