Интерфейс StatementInterface
Представляет базу данных statement. Конкретные реализации могут использовать PDOStatement или родной драйвер
Прямые известные реализаторы
Cake\Database\Statement\StatementDecoratorКосвенные известные реализаторы
Cake\Database\Statement\BufferedStatement, Cake\Database\Statement\CallbackStatement, Cake\Database\Statement\PDOStatementПодробное описание методов
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 - список значений для привязки к запросу
Возвращает
booleantrue при успехе, 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