PHP Classes

PHP Type Tools: Helpers to perform operations about variable types

Recommend this page to a friend!
  Info   View files Documentation   View files View files (36)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog (1)    
Ratings Unique User Downloads Download Rankings
Not yet rated by the usersTotal: 40 This week: 1All time: 10,831 This week: 571Up
Version License PHP version Categories
type-tools-php 1.0MIT/X Consortium ...7.4Tools, Libraries, Data types, PHP 7
Description 

Author

This package provides helpers to perform operations about variable types.

It provides several types that can perform valuable operations with variable value types.

Currently, it provides classes that can:

- Generate unique strings from variable values

- Cast an object into an object of another given class

- Access any variable of an object using reflection

- Access entry values of arrays or objects of classes that can be accessed like arrays

Innovation Award
PHP Programming Innovation award nominee
March 2023
Number 3
PHP is a language that is very flexible when it comes to manipulating the types of variable values.

This package provides a combination of tools in the form of practical classes that can perform several types of variable data type access, like generating unique strings from any variable values, type casting, and introspection of objects or array values.

Manuel Lemos
Picture of Smoren  Freelight
  Performance   Level  
Name: Smoren Freelight <contact>
Classes: 36 packages by
Country: Russian Federation Russian Federation
Age: 34
All time rank: 290379 in Russian Federation Russian Federation
Week rank: 50 Up3 in Russian Federation Russian Federation Up
Innovation award
Innovation award
Nominee: 15x

Documentation

PHP Type Tools

Packagist PHP Version Support Scrutinizer Code Quality Coverage Status Build and test License: MIT

Helpers for different operations with PHP data types, variables and containers.

How to install to your project

composer require smoren/type-tools

Quick Reference

Unique Extractor

| Method | Description | Code Snippet | |----------------------------|------------------------------------------------------|---------------------------------------------| | getString | Returns unique string of the given variable | UniqueExtractor::getString($var, $strict) | | getHash | Returns unique md5 hash string of the given variable | UniqueExtractor::getHash($var, $strict) |

Object Type Caster

| Method | Description | Code Snippet | |-----------------|---------------------------------------|-------------------------------------------------------------| | cast | Cast object to another relative type | ObjectTypeCaster::cast($sourceObject, $destinationClass) |

Object Access

| Method | Description | Code Snippet | |-------------------------------------------------|-------------------------------------------------------------------|------------------------------------------------------------------| | getPropertyValue | Returns value of the object property | ObjectAccess::getPropertyValue($object, $propertyName) | | setPropertyValue | Sets value of the object property | ObjectAccess::setPropertyValue($object, $propertyName, $value) | | hasReadableProperty | Returns true if object has readable property by name or by getter | ObjectAccess::hasReadableProperty($object, $propertyName) | | hasWritableProperty | Returns true if object has writable property by name or by getter | ObjectAccess::hasWritableProperty($object, $propertyName) | | hasPublicProperty | Returns true if object has public property | ObjectAccess::hasPublicProperty($object, $propertyName) | | hasPublicMethod | Returns true if object has public method | ObjectAccess::hasPublicMethod($object, $methodName) | | hasProperty | Returns true if object has property | ObjectAccess::hasProperty($object, $propertyName) | | hasMethod | Returns true if object has method | ObjectAccess::hasMethod($object, $methodName) |

Map Access

| Method | Description | Code Snippet | |---------------------|--------------------------------------------------------|---------------------------------------------------| | get | Returns value from the container by key | MapAccess::get($container, $key, $defaultValue) | | set | Sets value to the container by key | MapAccess::set($container, $key, $value) | | exists | Returns true if accessible key exists in the container | MapAccess::exists($container, $key) |

Usage

Unique Extractor

Tool for extracting unique IDs and hashes of any PHP variables and data structures.

Works in two modes: strict and non-strict.

In strict mode: - scalars: unique strictly by type; - objects: unique by instance; - arrays: unique by serialized value; - resources: result is unique by instance.

In non-strict mode: - scalars: unique by value; - objects: unique by serialized value; - arrays: unique by serialized value; - resources: result is unique by instance.

Get String

Returns unique string of the given variable.


use Smoren\TypeTools\UniqueExtractor;

$intValue = 5; $floatValue = 5.0;

$intValueStrictUniqueId = UniqueExtractor::getString($intValue, true); $floatValueStrictUniqueId = UniqueExtractor::getString($floatValue, true);

var_dump($intValueStrictUniqueId === $floatValueStrictUniqueId); // false

$intValueNonStrictUniqueId = UniqueExtractor::getString($intValue, false); $floatValueNonStrictUniqueId = UniqueExtractor::getString($floatValue, false);

var_dump($intValueNonStrictUniqueId === $floatValueNonStrictUniqueId); // true


#### Get Hash

Returns unique md5 hash string of the given variable.

use Smoren\TypeTools\UniqueExtractor;

$intValue = 5;
$floatValue = 5.0;

$intValueStrictHash = UniqueExtractor::getHash($intValue, true);
$floatValueStrictHash = UniqueExtractor::getHash($floatValue, true);

var_dump($intValueStrictHash === $floatValueStrictHash);
// false

$intValueNonStrictHash = UniqueExtractor::getHash($intValue, false);
$floatValueNonStrictHash = UniqueExtractor::getHash($floatValue, false);

var_dump($intValueNonStrictHash === $floatValueNonStrictHash);
// true

Object Type Caster

Tool for casting types of objects.

Cast

Cast object to another relative type (upcast or downcast).


use Smoren\TypeTools\ObjectTypeCaster;

class ParentClass {

public int $a;
protected int $b;

public function __construct(int $a, int $b)
{
    $this->a = $a;
    $this->b = $b;
}

public function toArray(): array
{
    return [$this->a, $this->b];
}

}

class ChildClass extends ParentClass {

private $c = null;

public function __construct(int $a, int $b, int $c)
{
    parent::__construct($a, $b);
    $this->c = $c;
}

public function toArray(): array
{
    return [$this->a, $this->b, $this->c];
}

}

/Downcast/

$parentClassObject = new ParentClass(1, 2); print_r($parentClassObject->toArray()); // [1, 2]

$castedToChildClass = ObjectTypeCaster::cast($parentClassObject, ChildClass::class); print_r($castedToChildClass->toArray()); // [1, 2, null]

var_dump(get_class($castedToChildClass)); // ChildClass

/Upcast/

$childClassObject = new ChildClass(1, 2, 3); print_r($childClassObject->toArray()); // [1, 2, 3]

$castedToParentClass = ObjectTypeCaster::cast($childClassObject, ParentClass::class); print_r($castedToParentClass->toArray()); // [1, 2]

var_dump(get_class($castedToParentClass)); // ParentClass


### Object Access

Tool for reflecting and accessing object properties and methods.

#### Get Property Value

Returns value of the object property.

Can access property by its name or by getter.

Throws Smoren\TypeTools\Exceptions\KeyError if property is not accessible to read.

use Smoren\TypeTools\ObjectAccess;

class MyClass {
    public int $publicProperty = 1;
    private int $privateProperty = 2;
    
    public function getPrivateProperty(): int
    {
        return $this->privateProperty;
    }
}

$myObject = new MyClass();

// Getting by name:
var_dump(ObjectAccess::getPropertyValue($myObject, 'publicProperty'));
// 1

// Getting by getter (getPrivateProperty()):
var_dump(ObjectAccess::getPropertyValue($myObject, 'privateProperty'));
// 2

Set Property Value

Sets value of the object property.


Can access property by its name or by setter.

Throws `Smoren\TypeTools\Exceptions\KeyError` if property is not accessible to write.

use Smoren\TypeTools\ObjectAccess;

class MyClass {

public int $publicProperty = 1;
private int $privateProperty = 2;

public function setPrivateProperty(int $value): void
{
    $this->privateProperty = $value;
}

public function toArray(): array
{
    return [$this->publicProperty, $this->privateProperty];
}

}

$myObject = new MyClass();

// Setting by name: ObjectAccess::setPropertyValue($myObject, 'publicProperty', 11);

// Setting by setter (setPrivateProperty()): ObjectAccess::getPropertyValue($myObject, 'privateProperty', 22);

print_r($myObject->toArray()); // [11, 22]


#### Has Readable Property

Returns true if object has property that is readable by name or by getter.

use Smoren\TypeTools\ObjectAccess;

class MyClass {
    public int $publicProperty = 1;
    private int $privateProperty = 2;
    private int $notAccessibleProperty = 3;
    
    public function getPrivateProperty(): int
    {
        return $this->privateProperty;
    }
}

$myObject = new MyClass();

// Accessible by name:
var_dump(ObjectAccess::hasReadableProperty($myObject, 'publicProperty'));
// true

// Accessible by getter:
var_dump(ObjectAccess::hasReadableProperty($myObject, 'privateProperty'));
// true

// Not accessible:
var_dump(ObjectAccess::hasReadableProperty($myObject, 'notAccessibleProperty'));
// false

Has Writable Property

Returns true if object has property that is writable by name or by setter.


use Smoren\TypeTools\ObjectAccess;

class MyClass {

public int $publicProperty = 1;
private int $privateProperty = 2;
private int $notAccessibleProperty = 3;

public function setPrivateProperty(int $value): void
{
    $this->privateProperty = $value;
}

}

$myObject = new MyClass();

// Accessible by name: var_dump(ObjectAccess::hasWritableProperty($myObject, 'publicProperty')); // true

// Accessible by setter: var_dump(ObjectAccess::hasWritableProperty($myObject, 'privateProperty')); // true

// Not accessible: var_dump(ObjectAccess::hasWritableProperty($myObject, 'notAccessibleProperty')); // false


#### Has Public Property

Returns true if object has public property.

use Smoren\TypeTools\ObjectAccess;

class MyClass {
    public int $publicProperty = 1;
    private int $privateProperty = 2;
}

$myObject = new MyClass();

var_dump(ObjectAccess::hasPublicProperty($myObject, 'publicProperty'));
// true

var_dump(ObjectAccess::hasPublicProperty($myObject, 'privateProperty'));
// false

Has Public Method

Returns true if object has public method.


use Smoren\TypeTools\ObjectAccess;

class MyClass {

public function publicMethod(): int
{
    return 1;
}

private function privateMethod(): int
{
    return 2;
}

}

$myObject = new MyClass();

var_dump(ObjectAccess::hasPublicMethod($myObject, 'publicMethod')); // true

var_dump(ObjectAccess::hasPublicMethod($myObject, 'privateMethod')); // false


#### Has Property

Returns true if object has property.

use Smoren\TypeTools\ObjectAccess;

class MyClass {
    public int $publicProperty = 1;
    private int $privateProperty = 2;
}

$myObject = new MyClass();

var_dump(ObjectAccess::hasProperty($myObject, 'publicProperty'));
// true

var_dump(ObjectAccess::hasProperty($myObject, 'privateProperty'));
// true

var_dump(ObjectAccess::hasProperty($myObject, 'anotherProperty'));
// false

Has Method

Returns true if object has method.


use Smoren\TypeTools\ObjectAccess;

class MyClass {

public function publicMethod(): int
{
    return 1;
}

private function privateMethod(): int
{
    return 2;
}

}

$myObject = new MyClass();

var_dump(ObjectAccess::hasMethod($myObject, 'publicMethod')); // true

var_dump(ObjectAccess::hasMethod($myObject, 'privateMethod')); // true


### Map Access

Tool for map-like accessing of different containers by string keys.

Can access:
- properties of objects (by name or by getter);
- elements of arrays and ArrayAccess objects (by key).

#### Get

Returns value from the container by key or default value if key does not exist or not accessible.

Throws `Smoren\TypeTools\Exceptions\KeyError` if key is not accessible to read.

use Smoren\TypeTools\MapAccess;

$array = [
    'a' => 1,
];

var_dump(MapAccess::get($array, 'a', 0));
// 1

var_dump(MapAccess::get($array, 'b', 0));
// 0

var_dump(MapAccess::get($array, 'b'));
// null

class MyClass {
    public int $publicProperty = 1;
    private int $privateProperty = 2;
    private int $notAccessibleProperty = 3;
    
    public function getPrivateProperty(): int
    {
        return $this->privateProperty;
    }
}

$myObject = new MyClass();

// Accessible by name:
var_dump(MapAccess::get($myObject, 'publicProperty', 0));
// 1

// Accessible by getter:
var_dump(MapAccess::get($myObject, 'privateProperty'));
// 2

// Not accessible:
var_dump(MapAccess::get($myObject, 'notAccessibleProperty', -1));
// -1

var_dump(MapAccess::get($myObject, 'notAccessibleProperty'));
// null

// Nonexistent:
var_dump(MapAccess::get($myObject, 'nonexistentProperty', -1));
// -1

var_dump(MapAccess::get($myObject, 'nonexistentProperty'));
// null

Set

Sets value to the container by key.


Throws `Smoren\TypeTools\Exceptions\KeyError` if key is not accessible to write.

use Smoren\TypeTools\MapAccess;

$array = [

'a' => 1,

];

MapAccess::set($array, 'a', 11); MapAccess::set($array, 'b', 22);

print_r($array); // ['a' => 11, 'b' => 22]

class MyClass {

public int $publicProperty = 1;
private int $privateProperty = 2;

public function setPrivateProperty(int $value): void
{
    $this->privateProperty = $value;
}

public function toArray(): array
{
    return [$this->publicProperty, $this->privateProperty];
}

}

$myObject = new MyClass();

// Accessible by name: MapAccess::get($myObject, 'publicProperty', 11);

// Accessible by getter: MapAccess::get($myObject, 'privateProperty', 22);

print_r($myObject->toArray()); // [11, 22]


#### Exists

Returns true if accessible key exists in the container.

use Smoren\TypeTools\MapAccess;

$array = [
    'a' => 1,
];

var_dump(MapAccess::exists($array, 'a'));
// true

var_dump(MapAccess::exists($array, 'b'));
// false
class MyClass {
    public int $publicProperty = 1;
    private int $privateProperty = 2;
    private int $notAccessibleProperty = 3;
    
    public function getPrivateProperty(): int
    {
        return $this->privateProperty;
    }
}

$myObject = new MyClass();

// Accessible by name:
var_dump(MapAccess::exists($myObject, 'publicProperty'));
// true

// Accessible by getter:
var_dump(MapAccess::exists($myObject, 'privateProperty'));
// true

// Not accessible:
var_dump(MapAccess::get($myObject, 'notAccessibleProperty'));
// false

// Nonexistent:
var_dump(MapAccess::get($myObject, 'nonexistentProperty', -1));
// false

Unit testing

composer install
composer test-init
composer test

License

PHP Type Tools is licensed under the MIT License.


  Files folder image Files  
File Role Description
Files folder image.github (1 directory)
Files folder imagesrc (4 files, 1 directory)
Files folder imagetests (3 files, 2 directories)
Accessible without login Plain text file .scrutinizer.yml Data Auxiliary data
Accessible without login Plain text file codeception.yml Data Auxiliary data
Accessible without login Plain text file composer.json Data Auxiliary data
Accessible without login Plain text file LICENSE Lic. License text
Accessible without login Plain text file phpcs.xml Data Auxiliary data
Accessible without login Plain text file phpstan.neon Data Auxiliary data
Accessible without login Plain text file README.md Doc. Documentation

  Files folder image Files  /  .github  
File Role Description
Files folder imageworkflows (1 file)

  Files folder image Files  /  .github  /  workflows  
File Role Description
  Accessible without login Plain text file test_master.yml Data Auxiliary data

  Files folder image Files  /  src  
File Role Description
Files folder imageExceptions (1 file)
  Plain text file MapAccess.php Class Class source
  Plain text file ObjectAccess.php Class Class source
  Plain text file ObjectTypeCaster.php Class Class source
  Plain text file UniqueExtractor.php Class Class source

  Files folder image Files  /  src  /  Exceptions  
File Role Description
  Plain text file KeyError.php Class Class source

  Files folder image Files  /  tests  
File Role Description
Files folder imageunit (5 directories)
Files folder image_support (1 file)
  Accessible without login Plain text file coding_standard.xml Data Auxiliary data
  Accessible without login Plain text file unit.suite.yml Data Auxiliary data
  Accessible without login Plain text file _bootstrap.php Aux. Auxiliary script

  Files folder image Files  /  tests  /  unit  
File Role Description
Files folder imageFixtures (5 files)
Files folder imageMapAccess (3 files)
Files folder imageObjectAccess (8 files)
Files folder imageObjectTypeCaster (1 file)
Files folder imageUniqueExtractor (2 files)

  Files folder image Files  /  tests  /  unit  /  Fixtures  
File Role Description
  Plain text file ChildClass.php Class Class source
  Plain text file ClassWithAccessibleProperties.php Class Class source
  Plain text file IndependentClass.php Class Class source
  Plain text file ParentClass.php Class Class source
  Plain text file SerializableFixture.php Class Class source

  Files folder image Files  /  tests  /  unit  /  MapAccess  
File Role Description
  Plain text file ExistsTest.php Class Class source
  Plain text file GetTest.php Class Class source
  Plain text file SetTest.php Class Class source

  Files folder image Files  /  tests  /  unit  /  ObjectAccess  
File Role Description
  Plain text file GetPropertyValueTest.php Class Class source
  Plain text file HasMethodTest.php Class Class source
  Plain text file HasPropertyTest.php Class Class source
  Plain text file HasPublicMethodTest.php Class Class source
  Plain text file HasPublicPropertyTest.php Class Class source
  Plain text file HasReadablePropertyTest.php Class Class source
  Plain text file HasWritablePropertyTest.php Class Class source
  Plain text file SetPropertyValueTest.php Class Class source

  Files folder image Files  /  tests  /  unit  /  ObjectTypeCaster  
File Role Description
  Plain text file ObjectTypeCasterTest.php Class Class source

  Files folder image Files  /  tests  /  unit  /  UniqueExtractor  
File Role Description
  Plain text file NonStrictTest.php Class Class source
  Plain text file StrictTest.php Class Class source

  Files folder image Files  /  tests  /  _support  
File Role Description
  Plain text file UnitTester.php Class Class source

 Version Control Unique User Downloads Download Rankings  
 100%
Total:40
This week:1
All time:10,831
This week:571Up