jessegall/php-types

Named typed constants and predicates — give meaning to magic literals like '', [], '{}', 0, true and null.

v1.5.1 2026-06-16 19:52 UTC

Requires

• php: ^8.2

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.0|^11.0

MIT

• Jesse Gall

• php
• constants
• types
• predicates
• value-objects

README

Named typed constants and predicates — give meaning to magic literals.

A raw '', [], '{}', 0, true, or null carries an unstated intent and gets re-checked defensively all over a codebase (if ($this->delimiter === '')). These tiny static classes give that intent a name and the check a single home.

use JesseGall\PhpTypes\T_String;

$prefix = T_String::empty();              // '' with a name
if (T_String::isEmpty($delimiter)) { … }  // reads as intent

// as a first-class callable
$nonEmpty = array_filter($parts, T_String::isNotEmpty(...));

Types

Class	Constant(s)	Factory	Predicates
T_String	EMPTY, SPACE, NEWLINE, PARAGRAPH, CARRIAGE_RETURN, CRLF, TAB, NULL_BYTE, COMMA, COMMA_SPACE, SLASH, DOT, DASH	empty()	isEmpty(), isNotEmpty(), isBlank(), isNotBlank()
T_Array	EMPTY, MATRIX	empty(), matrix()	isEmpty(), isNotEmpty()
T_Json	EMPTY_OBJECT, EMPTY_ARRAY	emptyObject(), emptyArray()	isEmptyObject(), isEmptyArray()
T_Int	ZERO, ONE, MINUS_ONE	zero()	isZero(), isNotZero()
T_Float	ZERO	zero()	isZero(), isNotZero()
T_Bool	TRUE, FALSE	—	isTrue(), isFalse()
T_Null	—	—	isNull(), isNotNull()

T_Json predicates are semantic — isEmptyObject('{ }') and isEmptyObject("{\n}") are true (they decode to an empty object), while isEmptyObject('[]') and invalid JSON are false.

Install

composer require jessegall/php-types

Requires PHP 8.2+. Zero runtime dependencies.

Test

composer test