pg_escape_string

    (PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

    pg_escape_string — Экранирование спецсимволов в строке запроса

    Описание

    pg_escape_string(PgSql\Connection$connection = ?, string$data): string

    Функция pg_escape_string() экранирует спецсимволы в строке запроса для базы данных. Она возвращает экранированную строку в формате PostgreSQL. Функция pg_escape_string() является наиболее предпочтительным способом экранирования SQL параметров для PostgreSQL, в то время как addslashes() не должна использоваться с PostgreSQL. Если тип столбца bytea, то должна использоваться функция pg_escape_bytea() вместо pg_escape_string. Функция pg_escape_identifier() должна использоваться для экранирования идентификаторов (например, имена таблиц или полей).

    Замечание:

    Функция поддерживается PostgreSQL версии 7.2 и выше.

    Список параметров

    connection

    Экземпляр класса PgSql\Connection. Если параметр connection не указали, функция выберет соединение по умолчанию. Соединение по умолчанию — это последнее соединение, которое установила функция pg_connect() или pg_pconnect().

    Внимание

    Начиная с версии PHP 8.1.0 использование соединения по умолчанию устарело.

    data

    Исходная экранируемая строка.

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

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

    Список изменений

    ВерсияОписание
    8.1.0 Параметр connection теперь ожидает экземпляр класса PgSql\Connection; раньше параметр ждал ресурс (resource).

    Примеры

    Пример #1 Пример использования pg_escape_string()

    <?php
    // Подключение к базе данных
    $dbconn = pg_connect('dbname=foo');

    // Чтение текстового файла (содержащего апострофы и обратные слеши)
    $data = file_get_contents('letter.txt');

    // Экранирование спецсимволов в строке
    $escaped = pg_escape_string($data);

    // Вставка в таблицу базы данных
    pg_query("INSERT INTO correspondence (name, data) VALUES ('My letter', '{$escaped}')");
    ?>

    Смотрите также

    • pg_escape_bytea() - Экранирует спецсимволы в строке для вставки в поле типа bytea
    To Top