ket-php/utils-truth

Lightweight PHP utility for converting values to boolean without errors.

1.0.1 2025-12-24 18:41 UTC

Requires

• php: ^8.1
• ext-mbstring: *
• ket-php/utils-safe: ^1.2

Requires (Dev)

• phpunit/phpunit: ^10.5

Suggests

• ext-mbstring: Recommended for multibyte string safety

Conflicts

• ket-php/utils-safe: <=1.2

MIT

• Alexander Mikhno

• php
• helpers
• utility
• boolean
• truthy
• ketphp
• ket-php

README

Installation

Install via Composer:

composer require ket-php/utils-truth

Usage

use KetPHP\Utils\Truth;

// Non-strict mode (default)
var_dump(Truth::of(1)); // true
var_dump(Truth::of('on')); // true
var_dump(Truth::of('no')); // false
var_dump(Truth::of(null)); // false

// Strict mode
//
// In strict mode, any truthy list is ignored (both global and per-call custom lists). The ONLY values considered true are: 1, '1', true, 'true'
var_dump(Truth::of('true', true)); // true
var_dump(Truth::of('on', true)); // false
var_dump(Truth::of(1, true)); // true
var_dump(Truth::of(0, true)); // false

// Using a callable
var_dump(Truth::of(fn() => 'yes')); // true
var_dump(Truth::of(fn() => 'no')); // false

// Custom truthy list for a single call
$custom = ['foo', 'bar', 123];

var_dump(Truth::of('foo', false, $custom)); // true
var_dump(Truth::of('baz', false, $custom)); // false

// Configure global truthy values
Truth::configure(['sure', 'ok']);

var_dump(Truth::of('ok')); // true
var_dump(Truth::of('yes')); // false (old default removed)