-
Notifications
You must be signed in to change notification settings - Fork 58
/
Copy pathmysql-pconnect.xml
177 lines (170 loc) · 6.31 KB
/
mysql-pconnect.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5fabd07880ab15b0ad2cf7eb055c7c2b36d7120f Maintainer: carlos Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<refentry xml:id="function.mysql-pconnect" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysql_pconnect</refname>
<refpurpose>Abre una conexión persistente a un servidor MySQL</refpurpose>
</refnamediv>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_connect</function> con <literal>p:</literal> host prefix</member>
<member><methodname>PDO::__construct</methodname> con <constant>PDO::ATTR_PERSISTENT</constant> como una opción de controlador</member>
</simplelist>
</warning>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>resource</type><methodname>mysql_pconnect</methodname>
<methodparam choice="opt"><type>string</type><parameter>server</parameter><initializer>ini_get("mysql.default_host")</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>username</parameter><initializer>ini_get("mysql.default_user")</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>password</parameter><initializer>ini_get("mysql.default_password")</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>client_flags</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<!-- Undocumented confusing syntax:
<methodsynopsis>
<type>resource</type><methodname>mysql_pconnect</methodname>
<methodparam choice="opt"><type>string</type><parameter>server</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>new_link</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>client_flags</parameter></methodparam>
</methodsynopsis>
-->
<para>
Establece una conexión persistente a un servidor MySQL.
</para>
<!-- TODO: Integrate this information more nicely with features.persistent -->
<para>
<function>mysql_pconnect</function> se parece mucho a
<function>mysql_connect</function> con dos grandes diferencias.
</para>
<para>
En primer lugar, cuando se conecta, la función primero intenta encontrar un
enlace (persistente) que ya esté abierto con el mismo anfitrión,
nombre de usuario y contraseña. Si se encuentra uno, se devolverá un identificador
para él, en lugar de abrir una nueva conexión.
</para>
<para>
Segundo, la conexión al servidor SQL no será cerrada cuando
la ejecución del script finalice. En su lugar, el enlace permanecerá
abierto para su uso futuro (<function>mysql_close</function> no
cerrará los enlaces establecidos mediante <function>mysql_pconnect</function>).
</para>
<para>
Por eso a este tipo de enlace se le llama 'persistente'.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>server</parameter></term>
<listitem>
<para>
El servidor de MySQL. También puede incluir un número de puerto. P.ej.
"nombre_anfitrión:puerto" o una ruta a un socket local, p.ej. ":/ruta/al/socket" para
el localhost.
</para>
<para>
Si la directiva de PHP <link linkend="ini.mysql.default-host">
mysql.default_host</link> no se ha definido (predeterminado), entonces el
valor por defecto es 'localhost:3306'
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>username</parameter></term>
<listitem>
<para>
El nombre de usuario. El valor por defecto es el nombre del usuario al que pertenece el
proceso del servidor.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>password</parameter></term>
<listitem>
<para>
La contraseña. El valor por defecto es una contraseña vacia.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>client_flags</parameter></term>
<listitem>
<para>
El parámetro <parameter>client_flags</parameter> puede ser una combinación
de las siguientes constantes:
128 (habilita el manejo de <literal>LOAD DATA LOCAL</literal>),
<constant>MYSQL_CLIENT_SSL</constant>,
<constant>MYSQL_CLIENT_COMPRESS</constant>,
<constant>MYSQL_CLIENT_IGNORE_SPACE</constant> o
<constant>MYSQL_CLIENT_INTERACTIVE</constant>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un identificador de enlace persistente a MySQL en caso de éxito o &false; en
caso de error.
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Tenga en cuenta que este tipo de enlaces solo funcionan si se está usando
una versión de módulo de PHP. Véase la
sección <link linkend="features.persistent-connections">Conexiones
persistentes a bases de datos</link> para más información.
</para>
</note>
<warning>
<para>
El uso de conexiones persistentes puede requerir ajustar un poco las configuraciones
de Apache y de MySQL para asegurarse de que no se excede el número de conexiones
permitidas por MySQL.
</para>
</warning>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mysql_connect</function></member>
<member><link linkend="features.persistent-connections">Conexiones
persistentes a bases de datos</link></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->