PHPackages                             jrfnl/php-cast-to-type - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. jrfnl/php-cast-to-type

ActiveLibrary[Utility & Helpers](/categories/utility)

jrfnl/php-cast-to-type
======================

PHP Class to consistently cast variables to a specific type.

2.1.0(3y ago)13263.0k—3.2%14GPL-2.0-or-laterPHPPHP >=5.0CI passing

Since Jun 18Pushed 1w ago3 watchersCompare

[ Source](https://github.com/jrfnl/PHP-cast-to-type)[ Packagist](https://packagist.org/packages/jrfnl/php-cast-to-type)[ Docs](https://github.com/jrfnl/PHP-cast-to-type)[ RSS](/packages/jrfnl-php-cast-to-type/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (4)Dependencies (6)Versions (6)Used By (4)

[![GitHub license](https://camo.githubusercontent.com/99d280c5a1f6abf3596fc7a96de71d3ae1003f7e99ee55140aae35bb88ba705e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c76322d626c75652e737667)](https://raw.githubusercontent.com/jrfnl/PHP-cast-to-type/main/LICENSE.md)[![CS](https://github.com/jrfnl/PHP-cast-to-type/actions/workflows/cs.yml/badge.svg)](https://github.com/jrfnl/PHP-cast-to-type/actions/workflows/cs.yml)[![Lint](https://github.com/jrfnl/PHP-cast-to-type/actions/workflows/lint.yml/badge.svg)](https://github.com/jrfnl/PHP-cast-to-type/actions/workflows/lint.yml)

PHP-cast-to-type
================

[](#php-cast-to-type)

PHP Class to consistently cast variables to a specific type.

Returns either the value in the specified type or `null`.

### Features:

[](#features)

- Consistent results across PHP versions.
- Compatible with PHP4, PHP5 and PHP7 which makes it extra useful if you're coding for open source software where you don't know the library user's PHP version and the `filter_var()` functions may not be available.
- Optionally recursively cast all values in an array to the choosen type (similar to `filter_var_array()` behaviour).
- Optionally allow/disallow empty strings/arrays.
- Will succesfully cast any of the following string values to their boolean counterpart (similar to `filter_var()` behaviour, but less case-sensitive).
    - True: `'1', 'true', 'True', 'TRUE', 'y', 'Y', 'yes', 'Yes', 'YES', 'on', 'On', 'ON'`.
    - False: `'0', 'false', 'False', 'FALSE', 'n', 'N', 'no', 'No', 'NO', 'off', 'Off', 'OFF'`.
- Support for casting of `SplType` objects.

### Some Usage examples:

[](#some-usage-examples)

```
$value = 'example';
$value = CastToType::_bool( $value ); // null

$value = 'true';
$value = CastToType::_bool( $value ); // true

$value = '123';
$value = CastToType::_int( $value ); // 123

$value = array( '123' );
$value = CastToType::_int( $value ); // null
$value = CastToType::_int( $value, $array2null = false ); // array( 123 )
```

### Available methods:

[](#available-methods)

All methods are static.

- `CastToType::cast( $value, $type, $array2null = true, $allow_empty = true, $implode_array = false );`
- `CastToType::_bool( $value, $array2null = true, $allow_empty = true );`
- `CastToType::_int( $value, $array2null = true, $allow_empty = true );`
- `CastToType::_float( $value, $array2null = true, $allow_empty = true );`
- `CastToType::_string( $value, $array2null = true, $allow_empty = true );`
- `CastToType::_array( $value, $allow_empty = true );`
- `CastToType::_object( $value, $allow_empty = true );`
- `CastToType::_null( $value );`

#### Parameters:

[](#parameters)

ParamTypeDescription`$value`mixedValue to cast.`$type`stringType to cast to. Valid values: `'bool'`, `'boolean'`, `'int'`, `'integer'`, `'float'`, `'double'`, `'num'`, `'string'`, `'array'`, `'object'`.`$array2null`boolOptional. Whether to return `null` for arrays when casting to bool, int, float, num or string. If false, the individual values held in the array will recursively be cast to the specified type. Defaults to `true`.`$allow_empty`boolOptional. Whether to allow empty strings, empty arrays, empty objects. If false, `null` will be returned instead of the empty string/array/object. Defaults to `true`.### Installation

[](#installation)

#### Requirements

[](#requirements)

This package requires the PHP native [`ctype`](https://www.php.net/book.ctype) extension.

#### Stand-alone

[](#stand-alone)

1. Head to the [Releases](https://github.com/jrfnl/PHP-cast-to-type/releases) page and download the latest release zip.
2. Extract the files and place them somewhere in your project hierarchy.
3. Require the class loader using `require_once '/path/to/cast-to-type.php';`.

#### Composer

[](#composer)

If you are using PHP5+ (as you should), PHP-Cast-to\_Type is also available as a [package](https://packagist.org/packages/jrfnl/PHP-cast-to-type) installable via Composer:

```
composer require jrfnl/PHP-cast-to-type
```

### Changelog:

[](#changelog)

#### 2.1.0 (Nov 2022)

[](#210-nov-2022)

- Allow for `double` as an alias for `float` in the `CastToType::cast()` method. Thanks [@nsrosenqvist](https://github.com/nsrosenqvist) for the contribution.
- Bug fix: string `ON` not recognized as truthy when casting to boolean.
- The requirement for the `ctype` extension has been made explicit.
- The primary branch has been renamed from `master` to `main`.
- General housekeeping.

#### 2.0.1 (Jan 2018)

[](#201-jan-2018)

- Bugfix for PHP cross-version compatibility. This affected use of this class on PHP < 5.2.7.
- General housekeeping.

#### 2.0 (Jun 2015)

[](#20-jun-2015)

- Updated the object casting to be in line with the way this is done in PHP7 for cross-version compatibility. Previously arrays with numerical keys cast to objects would be added to the object as a property called `array` with the value being the complete array. Now - as in PHP7 - each numerical array key will be cast to an individual property. This breaks backward-compatibility with v1.0 for array to object cast results, so please review your code if you relied on the old behaviour.
- Fixed a bug in the object casting which would return `null` for non-objects cast to objects in PHP <= 5.1.
- Fixed a bug in the object casting where an empty string would not return `null` while `$allow_empty` was set to `false`.

#### 1.0 (2006 / Sept 2013)

[](#10-2006--sept-2013)

- Initial release.

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance64

Regular maintenance activity

Popularity41

Moderate usage in the ecosystem

Community19

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 95.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1353 days

Total

3

Last Release

1328d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c276f443673da81d365a16828d46818ea4e3136f7ce05491abcc70f43c82fa4c?d=identicon)[jrfnl](/maintainers/jrfnl)

---

Top Contributors

[![jrfnl](https://avatars.githubusercontent.com/u/663378?v=4)](https://github.com/jrfnl "jrfnl (138 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![nsrosenqvist](https://avatars.githubusercontent.com/u/1303475?v=4)](https://github.com/nsrosenqvist "nsrosenqvist (1 commits)")

---

Tags

type-castingtype jugglingcross version

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/jrfnl-php-cast-to-type/health.svg)

```
[![Health](https://phpackages.com/badges/jrfnl-php-cast-to-type/health.svg)](https://phpackages.com/packages/jrfnl-php-cast-to-type)
```

###  Alternatives

[zenstruck/redirect-bundle

Store redirects for your site and keeps statistics on redirects and 404 errors

2665.3k1](/packages/zenstruck-redirect-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)