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.Castableinterface, 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
Castableinterface,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.