pg_escape_string

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

pg_escape_string — Escapa uma string para consulta

Descrição

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

pg_escape_string() escapa uma string para consultar o banco de dados. Ele retorna uma string de escape no formato PostgreSQL sem aspas. pg_escape_literal() é a forma preferida de escapar dos parâmetros SQL para PostgreSQL. addslashes() não deve ser usado com PostgreSQL. Se o tipo da coluna for bytea, pg_escape_bytea() deverá ser usado no lugar. pg_escape_identifier() deve ser usado para escape de identificadores (por exemplo, nomes de tabelas, nomes de campos)

Nota:
Esta função requer PostgreSQL 7.2 ou posterior.

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

Uma string contendo texto a ser escapado.

Valor Retornado

Uma string contendo os dados escapados.

Registro de Alterações

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

Exemplos

Exemplo #1 Exemplo de pg_escape_string()

<?php
  // Conecta ao banco de dados
  $dbconn = pg_connect('dbname=foo');

  // Lê em um arquivo de texto (contendo apóstrofos e barras invertidas)
  $data = file_get_contents('letter.txt');

  // Escape dos dados de texto
  $escaped = pg_escape_string($data);

  // Insira-o no banco de dados
  pg_query("INSERT INTO correspondence (name, data) VALUES ('My letter', '{$escaped}')");
?>

Veja Também

pg_escape_bytea() - Escapa uma string para inserção em um campo bytea

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês) 7 notes

down

strata_ranger at hotmail dot com ¶

14 years ago

Forthose curious, the exact escaping performed on the string may vary slightly depending on your database configuration.

For example, if your database's standard_conforming_strings variable is OFF, backslashes are treated as a special character and pg_escape_string() will ensure they are properly escaped.  If this variable is ON, backslashes will be treated as ordinary characters, and pg_escape_string() will leave them as-is.  In either case, the behavior matches the configuration of the database connection.

down

ringerc at ringerc dot id dot au ¶

10 years ago

You should prefer to use pg_query_params, i.e. use parameterized queries, rather than using pg_escape_string. Or use the newer PDO interface with its parameterized query support.

If you must substitute values directly, e.g. in DDL commands that don't support execution as parameterized queries, do so with pg_escape_literal:

http://au1.php.net/manual/en/function.pg-escape-literal.php

Identifiers can't be used as query parameters. Always use pg_escape_identifier for these if they're substituted dynamically:

http://au1.php.net/manual/en/function.pg-escape-identifier.php

You should not need to change text encodings when using this function. Make sure your connection's client_encoding is set to the text encoding used by PHP, and the PostgreSQL client driver will take care of text encodings for you. No explicit utf-8 conversions should be necessary with a correctly set  client_encoding.

down

Nathan Bruer ¶

16 years ago

If your database is a UTF-8 database, you will run into problems trying to add some data into your database...



for securty issues and/or compatability you may need to use the: utf_encode() (http://php.net/utf8-encode) function.



for example:

<?php

$my_data = pg_escape_string(utf8_encode($_POST['my_data']));

?>

down

ppp ¶

13 years ago

pg_escape_string() won't cast array arguments to the "Array" string like php usually does; it returns NULL instead. The following statements all evaluate to true:

<?php
$a = array('foo', 'bar');

"$a" == 'Array';
(string)$a == 'Array';
$a . '' == 'Array';

is_null(pg_escape_string($a));
?>

down

johniskew2 at yahoo dot com ¶

18 years ago

For those who escape their single quotes with a backslash (ie \') instead of two single quotes in a row (ie '') there has recently been a SERIOUS sql injection vulnerability that can be employed taking advantage of your chosen escaping method.  More info here: http://www.postgresql.org/docs/techdocs.50
Even after the postgre update, you may still be limited to what you can do with your queries if you still insist on backslash escaping. It's a lesson to always use the PHP functions to do proper escaping instead of adhoc addslashes or magic quotes escaping.

down

meng ¶

18 years ago

Since php 5.1 the new function pg_query_params() was introduced. With this function you can use bind variables and don't have to escape strings. If you can use it, do so. If unsure why, check the changelog for Postgres 8.0.8.

down

otix ¶

18 years ago

Creating a double-tick is just fine. It works the same as the backslash-tick syntax. From the PostgreSQL docs:

The fact that string constants are bound by single quotes presents an obvious semantic problem, however, in that if the sequence itself contains a single quote, the literal bounds of the constant are made ambiguous. To escape (make literal) a single quote within the string, you may type two adjacent single quotes. The parser will interpret the two adjacent single quotes within the string constant as a single, literal single quote. PostgreSQL will also allow single quotes to be embedded by using a C-style backslash.

＋adicione uma nota