Download the PHP package uuf6429/php-castable without Composer
On this page you can find all versions of the php package uuf6429/php-castable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download uuf6429/php-castable
More information about uuf6429/php-castable
Files in uuf6429/php-castable
Package php-castable
Short Description Type casting functionality for PHP
License MIT
Informations about the package php-castable
🎭 PHP Castable
Basic groundwork for type-casting in PHP.
🔌 Installation
The recommended and easiest way to install this library is through Composer:
⭐️ Features / Functionality
- Works with simple types and objects
cast($value, $type)
function that converts a value to a target type.Castable
interface, exposes method that is called whenevercast()
is called on objects implementing this interface.- Error handling - all errors routed to
NotCastableException
. - Fixes type-hinting for IDEs understanding PHPDoc Generics.
While cast()
is just a regular PHP function, it would be the equivalent to type-casting operators in other languages (e.g. val as Type
, (Type)val
, val.to(Type)
, CAST(val, TYPE)
...).
🚀 Example
🔍 Casting Behaviour
The casting process follows these steps:
- If the value is an object or value of the desired type, then it is returned unchanged.
- If the value is an object that implements
Castable
interface,castTo()
is called and its value returned. - Otherwise, PHP's
settype()
is attempted.
At any point in time, errors or unsupported type-casting could occur, in which case a NotCastableException
is thrown.
💰 Motivation
In many cases, having specific castToX()
methods in your classes is enough, and it typically works adequately.
However, this could get very repetitive and somewhat error-prone, until a more dynamic solution is needed. This package helps to safely avoid all that boilerplate code.