pg_select(3) [php man page]

PG_SELECT(3)															      PG_SELECT(3)

pg_select - Select records

SYNOPSIS

       mixed pg_select (resource  $connection, string  $table_name, array  $assoc_array, [int  $options = PGSQL_DML_EXEC])

DESCRIPTION

       pg_select(3)  selects  records  specified by assoc_array which has field=>value. For a successful query, it returns an array containing all
       records and fields that match the condition specified by assoc_array.

       If options is specified, pg_convert(3) is applied to assoc_array with the specified flags.

PARAMETERS

	      o $connection
		- PostgreSQL database connection resource.

	      o $table_name
		- Name of the table from which to select rows.

	      o $assoc_array
		- An array whose keys are field names in the table $table_name, and whose values are the conditions that a row	must  meet  to	be
		retrieved.

	      o $options
		-  Any	number	of PGSQL_CONV_FORCE_NULL, PGSQL_DML_NO_CONV, PGSQL_DML_ESCAPE, PGSQL_DML_EXEC, PGSQL_DML_ASYNC or PGSQL_DML_STRING
		combined. If PGSQL_DML_STRING is part of the $options then query string is returned. When PGSQL_DML_NO_CONV or PGSQL_DML_ESCAPE is
		set, it does not call pg_convert(3) internally.

RETURN VALUES

	Returns TRUE on success or FALSE on failure. Returns string if PGSQL_DML_STRING is passed via $options.

EXAMPLES

       Example #1

	      pg_select(3) example

	      <?php
		$db = pg_connect('dbname=foo');
		// This is safe, since $_POST is converted automatically
		$rec = pg_select($db, 'post_log', $_POST);
		if ($rec) {
		    echo "Records selected
";
		    var_dump($rec);
		} else {
		    echo "User must have sent wrong inputs
";
		}
	      ?>

CHANGELOG

       +-------------+---------------------------------------------------+
       |  Version    |							 |
       |	     |							 |
       |	     |			  Description			 |
       |	     |							 |
       +-------------+---------------------------------------------------+
       |   5.6.0     |							 |
       |	     |							 |
       |	     |	No  longer  experimental. Added PGSQL_DML_ESCAPE |
       |	     | constant, TRUE/ FALSE and NULL data type support. |
       |	     |							 |
       |5.5.3/5.4.19 |							 |
       |	     |							 |
       |	     |	Direct SQL injection to $table_name and Indirect |
       |	     | SQL injection to identifiers are fixed.		 |
       |	     |							 |
       +-------------+---------------------------------------------------+
SEE ALSO

       pg_convert(3).

PHP Documentation Group 													      PG_SELECT(3)

Check Out this Related Man Page

PG_CONVERT(3)															     PG_CONVERT(3)

pg_convert - Convert associative array values into suitable for SQL statement

SYNOPSIS

       array pg_convert (resource  $connection, string	$table_name, array  $assoc_array, [int	$options])

DESCRIPTION

       pg_convert(3)  checks  and  converts  the values in $assoc_array into suitable values for use in an SQL statement. Precondition for pg_con-
       vert(3) is the existence of a table $table_name which has at least as many columns as $assoc_array has elements.  The  fieldnames  in  $ta-
       ble_name  must  match  the  indices in $assoc_array and the corresponding datatypes must be compatible. Returns an array with the converted
       values on success, FALSE otherwise.

       Note

	       If there are boolean fields in $table_name don't use the constant TRUE in $assoc_array. It will be converted to the  string  'TRUE'
	      which is no valid entry for boolean fields in PostgreSQL. Use one of t, true, 1, y, yes instead.

       Warning

	      This  function is EXPERIMENTAL. The behaviour of this function, its name, and surrounding documentation may change without notice in
	      a future release of PHP. This function should be used at your own risk.

PARAMETERS

	      o $connection
		- PostgreSQL database connection resource.

	      o $table_name
		- Name of the table against which to convert types.

	      o $assoc_array
		- Data to be converted.

	      o $options
		- Any number of PGSQL_CONV_IGNORE_DEFAULT, PGSQL_CONV_FORCE_NULL or PGSQL_CONV_IGNORE_NOT_NULL, combined.

RETURN VALUES

	An array of converted values, or FALSE on error.

EXAMPLES

       Example #1

	      pg_convert(3) example

	      <?php
		$dbconn = pg_connect('dbname=foo');

		$tmp = array(
		    'author' => 'Joe Thackery',
		    'year' => 2005,
		    'title' => 'My Life, by Joe Thackery'
		);

		$vals = pg_convert($dbconn, 'authors', $tmp);
	      ?>

SEE ALSO

       pg_meta_data(3).

PHP Documentation Group 													     PG_CONVERT(3)

Linux and UNIX Man Pages

pg_select(3) [php man page]

Check Out this Related Man Page