Spec-Zone.ru › CakePHP 3.1

Интерфейс StatementInterface

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

Прямые известные реализаторы

Cake\Database\Statement\StatementDecorator

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

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

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

bindsource public

bind( array $params , array $types )

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

Параметры

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

bindValuesource public

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

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

Не разрешается комбинировать позиционные и именованные переменные в одном statement

Примеры:

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

Параметры

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

closeCursorsource public

closeCursor( )

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

columnCountsource public

columnCount( )

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

Пример:

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

Возвращает

integer
целое число

countsource public

count( )

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

Возвращает

integer
целое число

errorCodesource public

errorCode( )

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

Возвращает

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

errorInfosource public

errorInfo( )

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

Возвращает

array
массив

executesource public

execute( array $params null )

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

Параметры

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

Возвращает

boolean
true при успехе, false в противном случае

fetchsource public

fetch( string $type 'num' )

Возвращает следующую строку набора результатов после выполнения данного statement. Строки можно извлечь, чтобы содержать столбцы как имена, так и позиции. Если строк в наборе результатов больше нет, этот метод вернет 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 для именованных столбцов

Возвращает

array|false
Массив результатов, содержащий столбцы и значения, или false, если результатов больше нет

fetchAllsource public

fetchAll( string $type 'num' )

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

Пример:

$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 для имен столбцов в качестве ключей

Возвращает

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

lastInsertIdsource public

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

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

Параметры

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

Возвращает

string
строка

rowCountsource public

rowCount( )

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

Пример:

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

Возвращает

integer
целое число

© 2005–2016 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.
http://api.cakephp.org/3.1/class-Cake.Database.StatementInterface.html

Spec-Zone.ru

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