Spec-Zone.ru › CakePHP 3.8

Класс Type

Оборачивает все функции преобразования значений из базы данных в PHP и из PHP в базу данных.

Cake\Database\Type реализует Cake\Database\TypeInterface

Прямые подклассы

  • Cake\Database\Type\BinaryType
  • Cake\Database\Type\BinaryUuidType
  • Cake\Database\Type\BoolType
  • Cake\Database\Type\DateTimeType
  • Cake\Database\Type\DecimalType
  • Cake\Database\Type\FloatType
  • Cake\Database\Type\IntegerType
  • Cake\Database\Type\JsonType
  • Cake\Database\Type\StringType

Непрямые подклассы

  • Cake\Database\Type\DateType
  • Cake\Database\Type\TimeType
  • Cake\Database\Type\UuidType
Пространство имен: Cake\Database
Расположение: Database/Type.php

Резюме свойств

  • $_basicTypes protected static
    array

    Список основных сопоставлений типов, используемый для предотвращения необходимости создания экземпляра класса для выполнения преобразований этих типов.

  • $_builtTypes protected static
    Cake\Database\Type[]
    Содержит карту экземпляров объектов типа, которые будут повторно использоваться при необходимости.
  • $_name protected
    string|null
    Идентификатор имени для этого типа
  • $_types protected static
    string[]|Cake\Database\Type[]

    Список поддерживаемых типов баз данных. В качестве ключа используется удобочитаемый идентификатор, а в качестве значения — полное имя пространственного класса, представляющее класс, который будет выполнять фактические преобразования типов.

Резюме методов

  • __construct() public
    Конструктор
  • __debugInfo() public

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

  • _basicTypeCast() protected deprecated

    Проверяет, является ли этот тип базовым и может ли он быть преобразован с помощью обратного вызова. Если это так, возвращает преобразованное значение.

  • boolval() public static deprecated
    Преобразователь типа для булевых значений.
  • build() public static
    Возвращает объект Type, способный преобразовывать тип, идентифицированный по имени.
  • buildAll() public static
    Возвращает массив со всеми сопоставленными объектами типа, индексированными по имени.
  • clear() public static
    Очищает все созданные экземпляры и сопоставленные классы типов, полезно для тестирования
  • getBaseType() public
    Возвращает базовое имя типа, от которого унаследован этот класс.
  • getMap() public static
    Получить сопоставленное имя класса или экземпляр для типа(ов).
  • getName() public
    Возвращает имя идентификатора типа для этого объекта.
  • map() public static

    Регистрирует новый идентификатор типа и сопоставляет его с полным именем пространственного класса. Если вызывается без аргументов, возвращает текущий массив отображений типов. Если $className опущен, возвращает сопоставленный класс для $type

  • marshal() public
    Преобразует плоские данные в объекты PHP.
  • newId() public
    Генерирует новое значение первичного ключа для заданного типа.
  • set() public static
    Возвращает объект Type, способный преобразовывать тип, идентифицированный по $name
  • setMap() public static
    Устанавливает сопоставление типа и имени класса.
  • strval() public static deprecated
    Преобразователь типа для строковых значений.
  • toDatabase() public
    Преобразует данное значение из типа PHP в тип, приемлемый для базы данных.
  • toPHP() public
    Преобразует данное значение из типа базы данных в эквивалент PHP
  • toStatement() public
    Преобразует данное значение в эквивалент Statement.

Подробности метода

__construct()source public

__construct( string|null $name = null )

Конструктор

Параметры

string|null $name optional null
Имя, идентифицирующее этот тип

__debugInfo()source public

__debugInfo( )

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

Возвращает

array

_basicTypeCast()source protected deprecated

_basicTypeCast( mixed $value )

Проверяет, является ли этот тип базовым и может ли он быть преобразован с помощью обратного вызова. Если это так, возвращает преобразованное значение.

Устарело

3.1 Все типы теперь должны быть отдельным классом

Параметры

mixed $value
Значение, которое нужно преобразовать в эквивалент PHP

Возвращает

mixed

boolval()source public static deprecated

boolval( mixed $value )

Преобразователь типа для булевых значений.

Преобразует строки true/false в булевы значения.

Устарело

3.1.8 Этот метод больше не используется.

Параметры

mixed $value
Значение для преобразования в булево.

Возвращает

boolean

build()source public static

build( string $name )

Возвращает объект Type, способный преобразовывать тип, идентифицированный по имени.

Параметры

string $name
идентификатор типа

Возвращает

Cake\Database\Type

Исключения

InvalidArgumentException
Если идентификатор типа неизвестен

buildAll()source public static

buildAll( )

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

Возвращает

array

clear()source public static

clear( )

Очищает все созданные экземпляры и сопоставленные классы типов, полезно для тестирования

getBaseType()source public

getBaseType( )

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

Возвращает

string
Базовое имя типа, от которого унаследован этот класс.

Реализация

Cake\Database\TypeInterface::getBaseType()
END_OF_DOCUMENT_MARKER

getMap()source public static

getMap( string|null $type = null )

Получить имя или экземпляр сопоставленного класса для типа(ов).

Параметры

string|null $type необязательный null
Имя типа, для которого нужно получить сопоставленный класс, или null, чтобы получить массив сопоставлений.

Возвращаемое значение

array|string|Cake\Database\TypeInterface|null
Настроенное имя или экземпляр класса для заданного $type или массив сопоставлений.

С версии

3.6.2

getName()source public

getName( )

Возвращает имя идентификатора типа для этого объекта.

Возвращаемое значение

string
Имя идентификатора типа для этого объекта.

Реализация

Cake\Database\TypeInterface::getName()

map()source public static

map( string|string[]|Cake\Database\Type[]|null $type = null , string|Cake\Database\Type|null $className = null )

Регистрирует новый идентификатор типа и сопоставляет его с полным именем класса с пространством имён. Если вызвана без аргументов, она вернёт текущий массив сопоставлений типов. Если $className опущен, она вернёт сопоставленный класс для $type.

Устарело начиная с 3.6.2: - Использование $type как string[]|\Cake\Database\Type[] устарело. Используйте Type::setMap() с string[] вместо этого. - Передача $className как \Cake\Database\Type экземпляр устарела, используйте только строку имени класса. - Использование этого метода в качестве геттера устарело. Используйте Type::getMap() вместо этого.

Параметры

string|string[]|Cake\Database\Type[]|null $type необязательный null
Если строка имени типа для сопоставления, если массив списков массивов для сопоставления
string|Cake\Database\Type|null $className необязательный null
Имя класса или экземпляр объекта для регистрации.

Возвращаемое значение

array|string|null

Если $type равен null, то массив с текущим сопоставлением, если $className равен null, строка настроенного имени класса для данного $type, в противном случае null.


marshal()source public

marshal( mixed $value )

Преобразует плоские данные в объекты PHP.

Параметры

mixed $value
Значение для преобразования.

Возвращаемое значение

mixed
Преобразованное значение.

Реализация

Cake\Database\TypeInterface::marshal()

newId()source public

newId( )

Генерирует новое значение первичного ключа для заданного типа.

Возвращаемое значение

mixed
Новое значение первичного ключа.

Реализация

Cake\Database\TypeInterface::newId()

set()source public static

set( string $name , Cake\Database\Type $instance )

Возвращает объект Type, способный преобразовывать тип, идентифицированный $name

Параметры

string $name
Идентификатор типа, который вы хотите установить.
Cake\Database\Type $instance
Экземпляр типа, который вы хотите установить.

setMap()source public static

setMap( array $map )

Устанавливает сопоставление типа с именем класса.

Параметры

array $map
Список типов для сопоставления.

С версии

3.6.2

strval()source public static устарело

strval( mixed $value )

Преобразователь типа для строковых значений.

Преобразует значения в строки

Устарело

3.1.8 Этот метод больше не используется.

Параметры

mixed $value
Значение для преобразования в строку.

Возвращаемое значение

string

toDatabase()source public

toDatabase( mixed $value , Cake\Database\Driver $driver )

Преобразует заданное значение из типа PHP в тип, допустимый для базы данных.

Параметры

mixed $value
Значение, которое нужно преобразовать в эквивалент базы данных.
Cake\Database\Driver $driver
Объект, из которого будут извлечены настройки и конфигурация базы данных.

Возвращаемое значение

mixed
Заданный тип PHP, преобразованный в допустимый для базы данных.

Реализация

Cake\Database\TypeInterface::toDatabase()

toPHP()source public

toPHP( mixed $value , Cake\Database\Driver $driver )

Преобразует заданное значение из типа базы данных в эквивалент PHP.

Параметры

mixed $value
Значение, которое нужно преобразовать в эквивалент PHP.
Cake\Database\Driver $driver
Объект, из которого будут извлечены настройки и конфигурация базы данных.

Возвращаемое значение

mixed

Реализация

Cake\Database\TypeInterface::toPHP()

toStatement()source public

toStatement( mixed $value , Cake\Database\Driver $driver )

Преобразует заданное значение в его эквивалент Statement.

Параметры

mixed $value
Значение, которое нужно преобразовать в PDO statement.
Cake\Database\Driver $driver
Объект, из которого будут извлечены настройки и конфигурация базы данных.

Возвращаемое значение

mixed
Преобразованное значение в эквивалент Statement.

Реализация

Cake\Database\TypeInterface::toStatement()

Подробное описание свойств

$_basicTypessource

protected static array

Список сопоставлений основных типов, используемый для избежания необходимости создания класса для преобразования этих типов.

Устарело

3.1 Все типы теперь будут использовать отдельный класс
[
    'string' => ['callback' => [Type::class, 'strval']],
    'text' => ['callback' => [Type::class, 'strval']],
    'boolean' => [
        'callback' => [Type::class, 'boolval'],
        'pdo' => PDO::PARAM_BOOL
    ],
]

$_builtTypessource

protected static Cake\Database\Type[]

Содержит сопоставление экземпляров объектов типа для повторного использования, если необходимо.

[]

$_namesource

protected string|null

Имя идентификатора типа

$_typessource

protected static string[]|Cake\Database\Type[]

Список поддерживаемых типов базы данных. В качестве ключа используется удобочитаемый идентификатор, а в качестве значения — полное имя класса с пространством имён, представляющее класс, который выполняет фактические преобразования типов.

[
    'tinyinteger' => 'Cake\Database\Type\IntegerType',
    'smallinteger' => 'Cake\Database\Type\IntegerType',
    'integer' => 'Cake\Database\Type\IntegerType',
    'biginteger' => 'Cake\Database\Type\IntegerType',
    'binary' => 'Cake\Database\Type\BinaryType',
    'binaryuuid' => 'Cake\Database\Type\BinaryUuidType',
    'boolean' => 'Cake\Database\Type\BoolType',
    'date' => 'Cake\Database\Type\DateType',
    'datetime' => 'Cake\Database\Type\DateTimeType',
    'decimal' => 'Cake\Database\Type\DecimalType',
    'float' => 'Cake\Database\Type\FloatType',
    'json' => 'Cake\Database\Type\JsonType',
    'string' => 'Cake\Database\Type\StringType',
    'text' => 'Cake\Database\Type\StringType',
    'time' => 'Cake\Database\Type\TimeType',
    'timestamp' => 'Cake\Database\Type\DateTimeType',
    'uuid' => 'Cake\Database\Type\UuidType',
]

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.8/class-Cake.Database.Type.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API