pg_set_client_encoding(3) [php man page]

PG_SET_CLIENT_ENCODING(3)												 PG_SET_CLIENT_ENCODING(3)

pg_set_client_encoding - Set the client encoding

SYNOPSIS

       int pg_set_client_encoding ([resource  $connection], string  $encoding)

DESCRIPTION

       pg_set_client_encoding(3) sets the client encoding and returns 0 if success or -1 if error.

	PostgreSQL will automatically convert data in the backend database encoding into the frontend encoding.

       Note

	       The function used to be called pg_setclientencoding(3).

PARAMETERS

	      o $connection
		- PostgreSQL database connection resource. When $connection is not present, the default connection is used. The default connection
		is the last connection made by pg_connect(3) or pg_pconnect(3).

	      o $encoding
		- The required client encoding. One of SQL_ASCII, EUC_JP, EUC_CN, EUC_KR, EUC_TW, UNICODE, MULE_INTERNAL, LATINX (X=1...9),  KOI8,
		WIN,  ALT,  SJIS,  BIG5 or WIN1250.  The exact list of available encodings depends on your PostgreSQL version, so check your Post-
		greSQL manual for a more specific list.

RETURN VALUES

	Returns 0 on success or -1 on error.

EXAMPLES

       Example #1

	      pg_set_client_encoding(3) example

	      <?php

	      $conn = pg_pconnect("dbname=publisher");
	      if (!$conn) {
		echo "An error occurred.
";
		exit;
	      }

	      // Set the client encoding to UNICODE.  Data will be automatically
	      // converted from the backend encoding to the frontend.
	      pg_set_client_encoding($conn, "UNICODE");

	      $result = pg_query($conn, "SELECT author, email FROM authors");
	      if (!$result) {
		echo "An error occurred.
";
		exit;
	      }

	      // Write out UTF-8 data
	      while ($row = pg_fetch_row($result)) {
		echo "Author: $row[0]  E-mail: $row[1]";
		echo "<br />
";
	      }

	      ?>

SEE ALSO

       pg_client_encoding(3).

PHP Documentation Group 												 PG_SET_CLIENT_ENCODING(3)

PG_ESCAPE_STRING(3)													       PG_ESCAPE_STRING(3)

pg_escape_string - Escape a string for query

SYNOPSIS

       string pg_escape_string ([resource  $connection], string  $data)

DESCRIPTION

       pg_escape_string(3)  escapes  a	string	for  querying  the database. It returns an escaped string in the PostgreSQL format without quotes.
       pg_escape_literal(3) is more preferred way to escape SQL parameters for PostgreSQL. addslashes(3) must not be used with PostgreSQL. If  the
       type  of the column is bytea, pg_escape_bytea(3) must be used instead. pg_escape_identifier(3) must be used to escape identifiers (e.g. ta-
       ble names, field names)

       Note

	       This function requires PostgreSQL 7.2 or later.

PARAMETERS

	      o $connection
		- PostgreSQL database connection resource. When $connection is not present, the default connection is used. The default connection
		is the last connection made by pg_connect(3) or pg_pconnect(3).

	      o $data
		- A string containing text to be escaped.

RETURN VALUES

	A string containing the escaped data.

CHANGELOG

       +--------+-------------------+
       |Version |		    |
       |	|		    |
       |	|    Description    |
       |	|		    |
       +--------+-------------------+
       | 5.2.0	|		    |
       |	|		    |
       |	| $connection added |
       |	|		    |
       +--------+-------------------+
EXAMPLES

       Example #1

	      pg_escape_string(3) example

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

		// Read in a text file (containing apostrophes and backslashes)
		$data = file_get_contents('letter.txt');

		// Escape the text data
		$escaped = pg_escape_string($data);

		// Insert it into the database
		pg_query("INSERT INTO correspondence (name, data) VALUES ('My letter', '{$escaped}')");
	      ?>

SEE ALSO

       pg_escape_bytea(3).

PHP Documentation Group 												       PG_ESCAPE_STRING(3)