pg_escape_identifier

    (PHP 5 >= 5.4.4, PHP 7, PHP 8)

    pg_escape_identifier — Escape a identifier for insertion into a text field

    Descrição

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

    pg_escape_identifier() escapes a identifier (e.g. table, field names) for querying the database. It returns an escaped identifier string for PostgreSQL server. pg_escape_identifier() adds double quotes before and after data. Users should not add double quotes. Use of this function is recommended for identifier parameters in query. For SQL literals (i.e. parameters except bytea), pg_escape_literal() or pg_escape_string() must be used. For bytea type fields, pg_escape_bytea() must be used instead.

    Nota:

    This function has internal escape code and can also be used with PostgreSQL 8.4 or less.

    Parâmetros

    connection

    Uma instância de PgSql\Connection. Quando o parâmetro connection não for especificado, a conexão padrão será usada. A conexão padrão é a última conexão feita por pg_connect() ou pg_pconnect().

    Aviso

    A partir do PHP 8.1.0, usar a conexão padrão tornou-se defasado.

    data

    A string containing text to be escaped.

    Valor Retornado

    A string containing the escaped data.

    Registro de Alterações

    VersãoDescrição
    8.1.0 O parâmetro connection agora espera uma instância de PgSql\Connection; anteriormente, um resource era esperado.

    Exemplos

    Exemplo #1 pg_escape_identifier() example

    <?php
    // Connect to the database
    $dbconn = pg_connect('dbname=foo');

    // Escape the table name data
    $escaped = pg_escape_identifier($table_name);

    // Select rows from $table_name
    pg_query("SELECT * FROM {$escaped};");
    ?>

    Veja Também

    To Top