Загрузка type tools php - Загрузка исходного кода type tools php

Русский

中文(简体) 中文(繁体) 한국어 日本語 English Português Español Русский العربية Indonesia Deutsch Français ภาษาไทย

Главная страница>Исходный код PHP>Другие категории

type tools php

Другие категории

UniqueExtractor: extracting from resource logic fixed

Скачать

Инструменты типов PHP

Помощники для различных операций с типами данных PHP, переменными и контейнерами.

Как установить в свой проект

 composer require smoren/type-tools

Краткий справочник

Уникальный экстрактор

Метод	Описание	Фрагмент кода
`getString`	Возвращает уникальную строку заданной переменной	`UniqueExtractor::getString($var, $strict)`
`getHash`	Возвращает уникальную хеш-строку md5 заданной переменной.	`UniqueExtractor::getHash($var, $strict)`

Тип объекта Заклинатель

Метод	Описание	Фрагмент кода
`cast`	Привести объект к другому относительному типу	`ObjectTypeCaster::cast($sourceObject, $destinationClass)`

Доступ к объектам

Метод	Описание	Фрагмент кода
`getPropertyValue`	Возвращает значение свойства объекта	`ObjectAccess::getPropertyValue($object, $propertyName)`
`setPropertyValue`	Устанавливает значение свойства объекта	`ObjectAccess::setPropertyValue($object, $propertyName, $value)`
`hasReadableProperty`	Возвращает true, если объект имеет читаемое свойство по имени или по методу получения.	`ObjectAccess::hasReadableProperty($object, $propertyName)`
`hasWritableProperty`	Возвращает true, если объект имеет свойство, доступное для записи, по имени или по методу получения.	`ObjectAccess::hasWritableProperty($object, $propertyName)`
`hasPublicProperty`	Возвращает true, если объект имеет общедоступную собственность	`ObjectAccess::hasPublicProperty($object, $propertyName)`
`hasPublicMethod`	Возвращает true, если объект имеет общедоступный метод	`ObjectAccess::hasPublicMethod($object, $methodName)`
`hasProperty`	Возвращает true, если объект имеет свойство	`ObjectAccess::hasProperty($object, $propertyName)`
`hasMethod`	Возвращает true, если у объекта есть метод	`ObjectAccess::hasMethod($object, $methodName)`

Доступ к карте

Метод	Описание	Фрагмент кода
`get`	Возвращает значение из контейнера по ключу	`MapAccess::get($container, $key, $defaultValue)`
`set`	Устанавливает значение в контейнер по ключу	`MapAccess::set($container, $key, $value)`
`exists`	Возвращает true, если в контейнере существует доступный ключ.	`MapAccess::exists($container, $key)`

Использование

Уникальный экстрактор

Инструмент для извлечения уникальных идентификаторов и хешей любых переменных PHP и структур данных.

Работает в двух режимах: строгом и нестрогом.

В строгом режиме:

скаляры: уникальны строго по типу;
объекты: уникальные по экземпляру;
массивы: уникальные по сериализованному значению;
ресурсы: результат уникален для каждого экземпляра.

В нестрогом режиме:

скаляры: уникальные по значению;
объекты: уникальные по сериализованному значению;
массивы: уникальные по сериализованному значению;
ресурсы: результат уникален для каждого экземпляра.

Получить строку

Возвращает уникальную строку заданной переменной.

UniqueExtractor::getString(mixed $var, bool $strict): string

 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

Получить хэш

Возвращает уникальную хеш-строку md5 заданной переменной.

UniqueExtractor::getHash(mixed $var, bool $strict): string

 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

Тип объекта Заклинатель

Инструмент для приведения типов объектов.

Бросать

Приведите объект к другому относительному типу (восходящему приведению или нисходящему приведению).

ObjectTypeCaster::cast(object $sourceObject, string $destinationClass): mixed

 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

Доступ к объектам

Инструмент для отражения и доступа к свойствам и методам объекта.

Получить стоимость недвижимости

Возвращает значение свойства объекта.

ObjectAccess::getPropertyValue(object $object, string $propertyName): mixed

Может получить доступ к свойству по его имени или по методу получения.

Выдает SmorenTypeToolsExceptionsKeyError если свойство недоступно для чтения.

 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

Установить значение свойства

Устанавливает значение свойства объекта.

ObjectAccess::setPropertyValue(object $object, string $propertyName, mixed $value): void

Доступ к свойству можно получить по его имени или с помощью установщика.

Выдает SmorenTypeToolsExceptionsKeyError если свойство недоступно для записи.

 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]

Имеет читаемое свойство

Возвращает true, если объект имеет свойство, которое можно прочитать по имени или методом получения.

ObjectAccess::hasReadableProperty(object $object, string $propertyName): bool

 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

Имеет свойство, доступное для записи

Возвращает true, если объект имеет свойство, доступное для записи по имени или установщику.

ObjectAccess::hasWritableProperty(object $object, string $propertyName): bool

 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

Имеет государственную собственность

Возвращает true, если объект имеет общедоступное свойство.

ObjectAccess::hasPublicProperty(object $object, string $propertyName): bool

 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

Имеет общедоступный метод

Возвращает true, если объект имеет общедоступный метод.

ObjectAccess::hasPublicMethod(object $object, string $methodName): bool

 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

Имеет собственность

Возвращает true, если объект имеет свойство.

ObjectAccess::hasProperty(object $object, string $propertyName): bool

 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

Имеет метод

Возвращает true, если у объекта есть метод.

ObjectAccess::hasMethod(object $object, string $methodName): bool

 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

Доступ к карте

Инструмент для доступа к различным контейнерам в виде карты с помощью строковых ключей.

Может получить доступ:

свойства объектов (по имени или по геттеру);
элементы массивов и объекты ArrayAccess (по ключу).

Получать

Возвращает значение из контейнера по ключу или значению по умолчанию, если ключ не существует или недоступен.

Выдает SmorenTypeToolsExceptionsKeyError если ключ недоступен для чтения.

MapAccess::get(mixed $container, string $key, mixed $defaultValue = null): mixed

 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

Набор

Устанавливает значение в контейнер по ключу.

MapAccess::set(mixed $container, string $key, mixed $value): void

Выдает SmorenTypeToolsExceptionsKeyError если ключ недоступен для записи.

 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]

Существует

Возвращает true, если в контейнере существует доступный ключ.

MapAccess::exists(mixed $container, string $key): bool

 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

Модульное тестирование

 composer install
composer test-init
composer test

Лицензия

PHP Type Tools лицензируется по лицензии MIT.

Расширять

Дополнительная информация

Версия UniqueExtractor: extracting from resource logic fixed
Тип Другие категории
Время обновления 2024-12-30
размер 29.8KB
От Github

Связанные приложения

language tools

2024-11-11
biliLive tools

2024-11-03
sra tools

2024-11-01
PDF24 инструменты

2023-07-13
Подвижный тип

2011-08-08
Подвижный тип

2009-05-21