Spec-Zone.ru › Phalcon 3

Класс Phalcon\Db\Adapter\Pdo\Postgresql

расширяет абстрактный класс Phalcon\Db\Adapter\Pdo

реализует Phalcon\Db\AdapterInterface, Phalcon\Events\EventsAwareInterface

Исходный код на GitHub

Специальные функции для системы баз данных Postgresql

use Phalcon\Db\Adapter\Pdo\Postgresql;

$config = [
    "host"     => "localhost",
    "dbname"   => "blog",
    "port"     => 5432,
    "username" => "postgres",
    "password" => "secret",
];

$connection = new Postgresql($config);

Методы

public connect ([array $descriptor])

Этот метод автоматически вызывается в конструкторе Phalcon\Db\Adapter\Pdo. Вызывайте его, когда вам нужно восстановить подключение к базе данных.

public describeColumns (mixed $table, [mixed $schema])

Возвращает массив объектов Phalcon\Db\Column, описывающих таблицу

print_r(
    $connection->describeColumns("posts")
);

public createTable (mixed $tableName, mixed $schemaName, array $definition)

Создаёт таблицу

public modifyColumn (mixed $tableName, mixed $schemaName, Phalcon\Db\ColumnInterface $column, [Phalcon\Db\ColumnInterface $currentColumn])

Модифицирует столбец таблицы на основе определения

public useExplicitIdValue ()

Проверяет, требует ли система баз данных явного значения для столбцов идентификаторов

public getDefaultIdValue ()

Возвращает значение по умолчанию для столбца идентификатора, которое необходимо вставить

// Inserting a new robot with a valid default value for the column 'id'
$success = $connection->insert(
    "robots",
    [
        $connection->getDefaultIdValue(),
        "Astro Boy",
        1952,
    ],
    [
        "id",
        "name",
        "year",
    ]
);

public supportSequences ()

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

public __construct (array $descriptor) унаследован от Phalcon\Db\Adapter\Pdo

Конструктор для Phalcon\Db\Adapter\Pdo

public prepare (mixed $sqlStatement) унаследован от Phalcon\Db\Adapter\Pdo

Возвращает подготовленное выражение PDO, которое будет выполнено с помощью «executePrepared»

use Phalcon\Db\Column;

$statement = $db->prepare(
    "SELECT * FROM robots WHERE name = :name"
);

$result = $connection->executePrepared(
    $statement,
    [
        "name" => "Voltron",
    ],
    [
        "name" => Column::BIND_PARAM_INT,
    ]
);

public PDOStatement executePrepared (PDOStatement $statement, array $placeholders, array $dataTypes) унаследован от Phalcon\Db\Adapter\Pdo

Выполняет подготовленное выражение с привязкой. Эта функция использует целочисленные индексы, начиная с нуля

use Phalcon\Db\Column;

$statement = $db->prepare(
    "SELECT * FROM robots WHERE name = :name"
);

$result = $connection->executePrepared(
    $statement,
    [
        "name" => "Voltron",
    ],
    [
        "name" => Column::BIND_PARAM_INT,
    ]
);

public query (mixed $sqlStatement, [mixed $bindParams], [mixed $bindTypes]) унаследован от Phalcon\Db\Adapter\Pdo

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

// Querying data
$resultset = $connection->query(
    "SELECT * FROM robots WHERE type = 'mechanical'"
);

$resultset = $connection->query(
    "SELECT * FROM robots WHERE type = ?",
    [
        "mechanical",
    ]
);

public execute (mixed $sqlStatement, [mixed $bindParams], [mixed $bindTypes]) унаследован от Phalcon\Db\Adapter\Pdo

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

// Inserting data
$success = $connection->execute(
    "INSERT INTO robots VALUES (1, 'Astro Boy')"
);

$success = $connection->execute(
    "INSERT INTO robots VALUES (?, ?)",
    [
        1,
        "Astro Boy",
    ]
);

public affectedRows () унаследован от Phalcon\Db\Adapter\Pdo

Возвращает количество изменённых строк последним выполненным INSERT/UPDATE/DELETE запросом в системе баз данных

$connection->execute(
    "DELETE FROM robots"
);

echo $connection->affectedRows(), " were deleted";

public close () унаследован от Phalcon\Db\Adapter\Pdo

Закрывает активное подключение, возвращая успешность. Phalcon автоматически закрывает и уничтожает активные подключения по окончании запроса

public escapeString (mixed $str) унаследован от Phalcon\Db\Adapter\Pdo

Экранирует значение, чтобы избежать SQL-инъекций в соответствии с активной кодировкой символов в подключении

$escapedStr = $connection->escapeString("some dangerous value");

public convertBoundParams (mixed $sql, [array $params]) унаследован от Phalcon\Db\Adapter\Pdo

Преобразует связанные параметры, такие как :name: или ?1, в параметры привязки PDO ?

print_r(
    $connection->convertBoundParams(
        "SELECT * FROM robots WHERE name = :name:",
        [
            "Bender",
        ]
    )
);

public int | boolean lastInsertId ([string $sequenceName]) унаследован от Phalcon\Db\Adapter\Pdo

Возвращает идентификатор вставки для столбца auto_increment/serial, вставленного в последнем выполненном SQL-запросе

// Inserting a new robot
$success = $connection->insert(
    "robots",
    [
        "Astro Boy",
        1952,
    ],
    [
        "name",
        "year",
    ]
);

// Getting the generated id
$id = $connection->lastInsertId();

public begin ([mixed $nesting]) унаследован от Phalcon\Db\Adapter\Pdo

Инициализирует транзакцию в подключении

public rollback ([mixed $nesting]) унаследован от Phalcon\Db\Adapter\Pdo

Отменяет активную транзакцию в подключении

public commit ([mixed $nesting]) унаследован от Phalcon\Db\Adapter\Pdo

Подтверждает активную транзакцию в подключении

public getTransactionLevel () унаследован от Phalcon\Db\Adapter\Pdo

Возвращает текущий уровень вложенности транзакции

public isUnderTransaction () унаследован от Phalcon\Db\Adapter\Pdo

Проверяет, находится ли подключение в транзакции

$connection->begin();

// true
var_dump(
    $connection->isUnderTransaction()
);

public getInternalHandler () унаследован от Phalcon\Db\Adapter\Pdo

Возвращает внутренний обработчик PDO

public array getErrorInfo () унаследован от Phalcon\Db\Adapter\Pdo

Возвращает информацию об ошибке, если таковая имеется

public getDialectType () унаследован от Phalcon\Db\Adapter

Имя используемого диалекта

public getType () унаследован от Phalcon\Db\Adapter

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

public getSqlVariables () унаследован от Phalcon\Db\Adapter

Активные переменные связанных SQL-параметров

public setEventsManager (Phalcon\Events\ManagerInterface $eventsManager) унаследован от Phalcon\Db\Adapter

Устанавливает менеджер событий

public getEventsManager () унаследован от Phalcon\Db\Adapter

Возвращает внутренний менеджер событий

public setDialect (Phalcon\Db\DialectInterface $dialect) унаследован от Phalcon\Db\Adapter

Устанавливает диалект, используемый для создания SQL

public getDialect () унаследован от Phalcon\Db\Adapter

Возвращает внутренний экземпляр диалекта

public fetchOne (mixed $sqlQuery, [mixed $fetchMode], [mixed $bindParams], [mixed $bindTypes]) унаследован от Phalcon\Db\Adapter

Возвращает первую строку в результате запроса SQL

// Getting first robot
$robot = $connection->fetchOne("SELECT * FROM robots");
print_r($robot);

// Getting first robot with associative indexes only
$robot = $connection->fetchOne("SELECT * FROM robots", \Phalcon\Db::FETCH_ASSOC);
print_r($robot);

public array fetchAll (string $sqlQuery, [int $fetchMode], [array $bindParams], [array $bindTypes]) унаследован от Phalcon\Db\Adapter

Выгружает весь результат запроса в массив

// Getting all robots with associative indexes only
$robots = $connection->fetchAll(
    "SELECT * FROM robots",
    \Phalcon\Db::FETCH_ASSOC
);

foreach ($robots as $robot) {
    print_r($robot);
}

 // Getting all robots that contains word "robot" withing the name
$robots = $connection->fetchAll(
    "SELECT * FROM robots WHERE name LIKE :name",
    \Phalcon\Db::FETCH_ASSOC,
    [
        "name" => "%robot%",
    ]
);
foreach($robots as $robot) {
    print_r($robot);
}

public string | ** fetchColumn (string $sqlQuery, [array $placeholders], [int | string $column]) унаследован от Phalcon\Db\Adapter

Возвращает n-ый столбец первой строки в результате запроса SQL

// Getting count of robots
$robotsCount = $connection->fetchColumn("SELECT count(*) FROM robots");
print_r($robotsCount);

// Getting name of last edited robot
$robot = $connection->fetchColumn(
    "SELECT id, name FROM robots order by modified desc",
    1
);
print_r($robot);

public boolean insert (string | array $table, array $values, [array $fields], [array $dataTypes]) inherited from Phalcon\Db\Adapter

Вставляет данные в таблицу с использованием пользовательского синтаксиса SQL RDBMS

%%%CODE_BLOCK_15%%<%

public boolean insertAsDict (string $table, array $data, [array $dataTypes]) inherited from Phalcon\Db\Adapter

Вставляет данные в таблицу с использованием пользовательского синтаксиса SQL RBDM

%%%CODE_BLOCK_16%%<%

public boolean update (string | array $table, array $fields, array $values, [string | array $whereCondition], [array $dataTypes]) inherited from Phalcon\Db\Adapter

Обновляет данные в таблице с использованием пользовательского синтаксиса SQL RBDM

%%%CODE_BLOCK_17%%<%

Предупреждение! Если $whereCondition является строкой, она не экранируется.

public boolean updateAsDict (string $table, array $data, [string $whereCondition], [array $dataTypes]) inherited from Phalcon\Db\Adapter

Обновляет данные в таблице с использованием пользовательского синтаксиса SQL RBDM. Другой, более удобный синтаксис

%%%CODE_BLOCK_18%%<%

public boolean delete (string | array $table, [string $whereCondition], [array $placeholders], [array $dataTypes]) inherited from Phalcon\Db\Adapter

Удаляет данные из таблицы с использованием пользовательского синтаксиса SQL RBDM

%%%CODE_BLOCK_19%%<%

public escapeIdentifier (array | string $identifier) inherited from Phalcon\Db\Adapter

Экранирует имя столбца/таблицы/схемы

%%%CODE_BLOCK_20%%<%

public string getColumnList (array $columnList) inherited from Phalcon\Db\Adapter

Получает список столбцов

public limit (mixed $sqlQuery, mixed $number) inherited from Phalcon\Db\Adapter

Добавляет в $sqlQuery аргумент оператор LIMIT

%%%CODE_BLOCK_21%%<%

public tableExists (mixed $tableName, [mixed $schemaName]) inherited from Phalcon\Db\Adapter

Генерирует SQL, проверяющий существование схемы.таблицы

%%%CODE_BLOCK_22%%<%

public viewExists (mixed $viewName, [mixed $schemaName]) inherited from Phalcon\Db\Adapter

Генерирует SQL, проверяющий существование схемы.представления

%%%CODE_BLOCK_23%%<%

public forUpdate (mixed $sqlQuery) inherited from Phalcon\Db\Adapter

Возвращает SQL, модифицированный с помощью оператора FOR UPDATE

public sharedLock (mixed $sqlQuery) inherited from Phalcon\Db\Adapter

Возвращает SQL, модифицированный с помощью оператора LOCK IN SHARE MODE

public dropTable (mixed $tableName, [mixed $schemaName], [mixed $ifExists]) inherited from Phalcon\Db\Adapter

Удаляет таблицу из схемы/базы данных

public createView (mixed $viewName, array $definition, [mixed $schemaName]) inherited from Phalcon\Db\Adapter

Создает представление

public dropView (mixed $viewName, [mixed $schemaName], [mixed $ifExists]) inherited from Phalcon\Db\Adapter

Удаляет представление

public addColumn (mixed $tableName, mixed $schemaName, Phalcon\Db\ColumnInterface $column) inherited from Phalcon\Db\Adapter

Добавляет столбец в таблицу

public dropColumn (mixed $tableName, mixed $schemaName, mixed $columnName) inherited from Phalcon\Db\Adapter

Удаляет столбец из таблицы

public addIndex (mixed $tableName, mixed $schemaName, Phalcon\Db\IndexInterface $index) inherited from Phalcon\Db\Adapter

Добавляет индекс в таблицу

public dropIndex (mixed $tableName, mixed $schemaName, mixed $indexName) inherited from Phalcon\Db\Adapter

Удаляет индекс из таблицы

public addPrimaryKey (mixed $tableName, mixed $schemaName, Phalcon\Db\IndexInterface $index) inherited from Phalcon\Db\Adapter

Добавляет первичный ключ в таблицу

public dropPrimaryKey (mixed $tableName, mixed $schemaName) inherited from Phalcon\Db\Adapter

Удаляет первичный ключ таблицы

public addForeignKey (mixed $tableName, mixed $schemaName, Phalcon\Db\ReferenceInterface $reference) inherited from Phalcon\Db\Adapter

Добавляет внешний ключ в таблицу

public dropForeignKey (mixed $tableName, mixed $schemaName, mixed $referenceName) inherited from Phalcon\Db\Adapter

Удаляет внешний ключ из таблицы

public getColumnDefinition (Phalcon\Db\ColumnInterface $column) inherited from Phalcon\Db\Adapter

Возвращает определение столбца SQL из столбца

public listTables ([mixed $schemaName]) inherited from Phalcon\Db\Adapter

Список всех таблиц в базе данных

%%%CODE_BLOCK_24%%<%

public listViews ([mixed $schemaName]) inherited from Phalcon\Db\Adapter

Список всех представлений в базе данных

%%%CODE_BLOCK_25%%<%

public Phalcon\Db\Index[] describeIndexes (string $table, [string $schema]) inherited from Phalcon\Db\Adapter

Список индексов таблицы

%%%CODE_BLOCK_26%%<%

public describeReferences (mixed $table, [mixed $schema]) inherited from Phalcon\Db\Adapter

Список ссылок таблицы

%%%CODE_BLOCK_27%%<%

public tableOptions (mixed $tableName, [mixed $schemaName]) inherited from Phalcon\Db\Adapter

Получает параметры создания таблицы

%%%CODE_BLOCK_28%%<%

public createSavepoint (mixed $name) inherited from Phalcon\Db\Adapter

Создает новую точку сохранения

public releaseSavepoint (mixed $name) inherited from Phalcon\Db\Adapter

Освобождает заданную точку сохранения

public rollbackSavepoint (mixed $name) inherited from Phalcon\Db\Adapter

Откатывает заданную точку сохранения

public setNestedTransactionsWithSavepoints (mixed $nestedTransactionsWithSavepoints) inherited from Phalcon\Db\Adapter

Устанавливает, должны ли вложенные транзакции использовать точки сохранения

public isNestedTransactionsWithSavepoints () inherited from Phalcon\Db\Adapter

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

public getNestedTransactionSavepointName () inherited from Phalcon\Db\Adapter

Возвращает имя точки сохранения для использования вложенных транзакций

public getDefaultValue () унаследовано от Phalcon\Db\Adapter

Возвращает значение по умолчанию, чтобы RBDM использовал значение по умолчанию, объявленное в определении таблицы

// Inserting a new robot with a valid default value for the column 'year'
$success = $connection->insert(
    "robots",
    [
        "Astro Boy",
        $connection->getDefaultValue()
    ],
    [
        "name",
        "year",
    ]
);

public getDescriptor () унаследовано от Phalcon\Db\Adapter

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

public string getConnectionId () унаследовано от Phalcon\Db\Adapter

Получает уникальный идентификатор активного подключения

public getSQLStatement () унаследовано от Phalcon\Db\Adapter

Активное SQL-утверждение в объекте

public getRealSQLStatement () унаследовано от Phalcon\Db\Adapter

Активное SQL-утверждение в объекте без замены связанных параметров

public array getSQLBindTypes () унаследовано от Phalcon\Db\Adapter

Активное SQL-утверждение в объекте

© 2011–2017 Phalcon Framework Team
Licensed under the Creative Commons Attribution License 3.0.
https://docs.phalconphp.com/en/latest/api/Phalcon_Db_Adapter_Pdo_Postgresql.html

Spec-Zone.ru

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