pg_insert(3) [php man page]

PG_INSERT(3)															      PG_INSERT(3)

pg_insert - Insert array into table

SYNOPSIS

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

DESCRIPTION

       pg_insert(3) inserts the values of $assoc_array into the table specified by $table_name. If $options is specified, pg_convert(3) is applied
       to $assoc_array with the specified options.

PARAMETERS

	      o $connection
		- PostgreSQL database connection resource.

	      o $table_name
		- Name of the table into which to insert rows. The table $table_name must at least have as many columns as $assoc_array  has  ele-
		ments.

	      o $assoc_array
		-  An  array  whose  keys are field names in the table $table_name, and whose values are the values of those fields that are to be
		inserted.

	      o $options
		- Any number of PGSQL_CONV_OPTS, PGSQL_DML_NO_CONV, PGSQL_DML_ESCAPE, PGSQL_DML_EXEC,  PGSQL_DML_ASYNC	or  PGSQL_DML_STRING  com-
		bined.	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_insert(3) example

	      <?php
		$dbconn = pg_connect('dbname=foo');
		// This is safe, since $_POST is converted automatically
		$res = pg_insert($dbconn, 'post_log', $_POST);
		if ($res) {
		    echo "POST data is successfully logged
";
		} 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_INSERT(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_insert(3) [php man page]

Check Out this Related Man Page