<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.pg-pconnect" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>pg_pconnect</refname>

<refpurpose>

Establece una conexión PostgreSQL persistente

</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>PgSql\Connection</type><type>false</type></type><methodname>pg_pconnect</methodname>

<methodparam><type>string</type><parameter>connection_string</parameter></methodparam>

<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>

</methodsynopsis>

<para>

<function>pg_pconnect</function> devuelve una instancia <classname>PgSql\Connection</classname>

de conexión persistente.

</para>

<para>

Si se realiza una segunda llamada a <function>pg_pconnect</function> con el mismo

<parameter>connection_string</parameter> como una conexión

existente, se devolverá la conexión existente a menos que se pase

<constant>PGSQL_CONNECT_FORCE_NEW</constant> a

<parameter>flags</parameter>.

</para>

<para>

Para activar las conexiones persistentes, la directiva de configuración

<link linkend="ini.pgsql.allow-persistent"><option>pgsql.allow_persistent</option></link>

del &php.ini; debe establecerse en <literal>On</literal> (que es su valor por omisión).

El número máximo de conexiones puede limitarse mediante

la directiva de configuración

<link linkend="ini.pgsql.max-persistent"><option>pgsql.max_persistent</option></link>

en el archivo &php.ini; (por omisión, su valor es <literal>-1</literal>, es decir, sin límite).

El número total de conexiones puede configurarse con la directiva

<link linkend="ini.pgsql.max-links"><option>pgsql.max_links</option></link> del archivo

&php.ini;.

</para>

<para>

<function>pg_close</function> no cerrará las conexiones persistentes

generadas por <function>pg_pconnect</function>.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>connection_string</parameter></term>

<listitem>

<para>

La cadena <parameter>connection_string</parameter> puede estar vacía para

utilizar todos los parámetros por omisión o puede contener uno o

varios parámetros de configuración separados por espacios.

Cada parámetro de configuración tiene la forma <literal>code =

valor</literal>. Los espacios alrededor del signo igual son opcionales.

Para escribir un valor vacío o un valor que contenga espacios,

rodee este valor con comillas simples, por ejemplo: <literal>code =

'un valor'</literal>. Las comillas simples y las barras invertidas dentro

del valor deben escaparse con una barra invertida, es decir

<literal>\'</literal> y <literal>\\</literal>.

</para>

<para>

Las palabras clave actualmente reconocidas son :

<parameter>host</parameter>, <parameter>hostaddr</parameter>,

<parameter>port</parameter>,

<parameter>dbname</parameter>, <parameter>user</parameter>,

<parameter>password</parameter>,

<parameter>connect_timeout</parameter>,

<parameter>options</parameter>, <parameter>tty</parameter> (ignorado),

<parameter>sslmode</parameter>,

<parameter>requiressl</parameter> (obsoleto, utilice

<parameter>sslmode</parameter>) y

<parameter>service</parameter>.

La lista de estos argumentos depende de la versión del servidor PostgreSQL.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>flags</parameter></term>

<listitem>

<para>

Si <constant>PGSQL_CONNECT_FORCE_NEW</constant> se pasa como argumento,

entonces se creará una nueva conexión, incluso si la cadena

<parameter>connection_string</parameter> es idéntica a la de la conexión existente.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Devuelve una instancia de <classname>PgSql\Connection</classname> en caso de éxito, &return.falseforfailure;.

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.1.0</entry>

<entry>

Ahora devuelve una instancia de <classname>PgSql\Connection</classname> ;

anteriormente, se devolvía un &resource;.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Ejemplo con <function>pg_pconnect</function></title>

<programlisting role="php">

</programlisting>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>pg_connect</function></member>

<member>

<link linkend="features.persistent-connections">

Conexiones Persistentes</link>

</member>

</simplelist>

</para>

</refsect1>

</refentry>