pg_connect
Open a PostgreSQL connection
&reftitle.description;
resourcepg_connect
stringconnection_string
intconnect_type
pg_connect opens a connection to a
PostgreSQL database specified by the
connection_string.
If a second call is made to pg_connect with
the same connection_string as an existing connection, the
existing connection will be returned unless you pass
PGSQL_CONNECT_FORCE_NEW as
connect_type.
The old syntax with multiple parameters
$conn = pg_connect("host", "port", "options", "tty", "dbname")
has been deprecated.
&reftitle.parameters;
connection_string
The connection_string can be empty to use all default parameters, or it
can contain one or more parameter settings separated by whitespace.
Each parameter setting is in the form keyword = value. Spaces around
the equal sign are optional. To write an empty value or a value
containing spaces, surround it with single quotes, e.g., keyword =
'a value'. Single quotes and backslashes within the value must be
escaped with a backslash, i.e., \' and \\.
The currently recognized parameter keywords are:
host, hostaddr, port,
dbname (defaults to value of user),
user,
password, connect_timeout,
options, tty (ignored), sslmode,
requiressl (deprecated in favor of sslmode), and
service. Which of these arguments exist depends
on your PostgreSQL version.
The options parameter can be used to set command line parameters
to be invoked by the server.
connect_type
If PGSQL_CONNECT_FORCE_NEW is passed, then a new connection
is created, even if the connection_string is identical to
an existing connection.
If PGSQL_CONNECT_ASYNC is given, then the
connection is established asynchronously. The state of the connection
can then be checked via pg_connect_poll or
pg_connection_status.
&reftitle.returnvalues;
PostgreSQL connection resource on success, &false; on failure.
&reftitle.changelog;
&Version;
&Description;
5.6.0
Support for giving the PGSQL_CONNECT_ASYNC
constant as the connect_type was added.
&reftitle.examples;
Using pg_connect
]]>
&reftitle.seealso;
pg_pconnect
pg_close
pg_host
pg_port
pg_tty
pg_options
pg_dbname