Spec-Zone.ru › CakePHP 3.3

Интерфейс StatementInterface

Представляет базу данных оператора. Конкретные реализации могут использовать либо PDOStatement, либо родной драйвер

Прямые реализации

  • Cake\Database\Statement\StatementDecorator

Косвенные реализации

  • Cake\Database\Statement\BufferedStatement
  • Cake\Database\Statement\CallbackStatement
  • Cake\Database\Statement\PDOStatement
Пространство имён: Cake\Database
Расположение: Database/StatementInterface.php

Краткое описание методов

  • bind() public
    Связывает набор значений с объектом оператора с соответствующим типом
  • bindValue() public

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

  • closeCursor() public

    Закрывает курсор в базе данных, освобождая все ресурсы и память, выделенные для него. В большинстве случаев вам не нужно вызывать этот метод, так как он автоматически вызывается после извлечения всех результатов из набора результатов.

  • columnCount() public
    Возвращает количество столбцов, которые будут содержать результаты данного оператора
  • count() public

    Операторы могут быть переданы в качестве аргумента для count() для возврата количества затронутых строк из последнего выполнения

  • errorCode() public
    Возвращает код ошибки для последней ошибки, произошедшей при выполнении этого оператора
  • errorInfo() public

    Возвращает информацию об ошибке для последней ошибки, произошедшей при выполнении этого оператора

  • execute() public

    Выполняет оператор, отправляя SQL-запрос в базу данных. Он может необязательно принимать массив или аргументы, которые будут привязаны к переменным запроса. Обратите внимание, что привязка параметров из этого метода не будет выполнять никакой пользовательской преобразования типов, как это обычно происходит при вызове bindValue

  • fetch() public

    Возвращает следующую строку набора результатов после выполнения данного оператора. Строки могут быть извлечены для того, чтобы содержать столбцы как имена, так и позиции. Если строк в наборе результатов больше нет, этот метод вернёт false

  • fetchAll() public
    Возвращает массив со всеми строками, полученными в результате выполнения данного оператора
  • lastInsertId() public
    Возвращает последний вставленный первичный ключ, используемый этим оператором
  • rowCount() public
    Возвращает количество строк, затронутых этим SQL-запросом

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

bind()source public

bind( array $params , array $types )

Связывает набор значений с объектом оператора с соответствующим типом

Параметры

массив $params
список значений для привязки
массив $types
список типов, которые необходимо использовать, ключи должны соответствовать ключам в $params

bindValue()source public

bindValue( string|integer $column , mixed $value , string $type 'string' )

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

Сочетание позиционных и именованных переменных в одном операторе недопустимо

Примеры:

$statement->bindValue(1, 'a title');
$statement->bindValue('active', true, 'boolean');
$statement->bindValue(5, new \DateTime(), 'date');

Параметры

строка|целое число $column
имя или позиция параметра для привязки
смешанное $value
значение, которое нужно привязать к переменной в запросе
строка $type необязательно 'string'
имя настроенного класса типа

closeCursor()source public

closeCursor( )

Закрывает курсор в базе данных, освобождая все ресурсы и память, выделенные для него. В большинстве случаев вам не нужно вызывать этот метод, так как он автоматически вызывается после извлечения всех результатов из набора результатов.

columnCount()source public

columnCount( )

Возвращает количество столбцов, которые будут содержать результаты данного оператора

Пример:

$statement = $connection->prepare('SELECT id, title from articles');
 $statement->execute();
 echo $statement->columnCount(); // outputs 2

Возвращает

целое число

count()source public

count( )

Операторы могут быть переданы в качестве аргумента для count() для возврата количества затронутых строк из последнего выполнения

Возвращает

целое число

errorCode()source public

errorCode( )

Возвращает код ошибки для последней ошибки, произошедшей при выполнении этого оператора

Возвращает

целое число|строка

errorInfo()source public

errorInfo( )

Возвращает информацию об ошибке для последней ошибки, произошедшей при выполнении этого оператора

Возвращает

массив

execute()source public

execute( array|null $params null )

Выполняет оператор, отправляя SQL-запрос в базу данных. Он может необязательно принимать массив или аргументы, которые будут привязаны к переменным запроса. Обратите внимание, что привязка параметров из этого метода не будет выполнять никакой пользовательской преобразования типов, как это обычно происходит при вызове bindValue

Параметры

массив|null $params необязательно null
список значений, которые необходимо привязать к запросу

Возвращает

булево
истина при успехе, ложь в противном случае

fetch()source public

fetch( string $type 'num' )

Возвращает следующую строку набора результатов после выполнения данного оператора. Строки могут быть извлечены для того, чтобы содержать столбцы как имена, так и позиции. Если строк в наборе результатов больше нет, этот метод вернёт false

Пример:

$statement = $connection->prepare('SELECT id, title from articles');
 $statement->execute();
 print_r($statement->fetch('assoc')); // will show ['id' => 1, 'title' => 'a title']

Параметры

строка $type необязательно 'num'
'num' для позиционных столбцов, assoc для именованных столбцов

Возвращает

массив|ложь

Результирующий массив, содержащий столбцы и значения, или ложь, если результатов больше нет


fetchAll()source public

fetchAll( string $type 'num' )

Возвращает массив со всеми строками, полученными в результате выполнения данного оператора

Пример:

$statement = $connection->prepare('SELECT id, title from articles');
 $statement->execute();
 print_r($statement->fetchAll('assoc')); // will show [0 => ['id' => 1, 'title' => 'a title']]

Параметры

строка $type необязательно 'num'
num для извлечения столбцов как позиционных ключей или assoc для имён столбцов как ключей

Возвращает

массив
список всех результатов из базы данных для данного оператора

lastInsertId()source public

lastInsertId( string|null $table null , string|null $column null )

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

Параметры

строка|null $table необязательно null
имя таблицы или последовательности, чтобы получить последнее значение вставки из
строка|null $column необязательно null
имя столбца, представляющего первичный ключ

Возвращает

строка

rowCount()source public

rowCount( )

Возвращает количество строк, затронутых этим SQL-запросом.

Пример:

$statement = $connection->prepare('SELECT id, title from articles');
 $statement->execute();
 print_r($statement->rowCount()); // will show 1

Возвращает

целое число

© 2005–2017 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.3/class-Cake.Database.StatementInterface.html

Spec-Zone.ru

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