mysql-pconnect.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5fabd07880ab15b0ad2cf7eb055c7c2b36d7120f Maintainer: simp Status: ready -->
<!-- Credits. hholzgra -->
<refentry xml:id="function.mysql-pconnect" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>mysql_pconnect</refname>
  <refpurpose>Öffnet eine persistente Verbindung zum MySQL-Server</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  <warning>
   &mysql.alternative.note;
   <simplelist role="alternatives">
    <member><function>mysqli_connect</function> mit <literal>p:</literal> Host-Präfix</member>
    <member><methodname>PDO::__construct</methodname> mit <constant>PDO::ATTR_PERSISTENT</constant> als Treiberoption</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>
   Baut eine persistente Verbindung zu einem MySQL-Server auf.
  </para>
  <!-- TODO: Integrate this information more nicely with features.persistent -->
  <para>
   <function>mysql_pconnect</function> verhält sich weitgehend wie
   <function>mysql_connect</function> mit zwei großen Unterschieden.
  </para>
  <para>
   Erstens: Vor dem Verbindungsaufbau wird zunächst versucht eine offene
   (persistente) Verbindung zum gleichen Host, mit dem gleichen Benutzernamen
   und Benutzerkennwort zu finden. Wenn das gelingt, wird die
   Verbindungskennung dieser Verbindung zurückgegeben statt eine neue
   Verbindung aufzubauen.
  </para>
  <para>
   Zweitens: Die Verbindung zum SQL-Server wird beim Beenden des PHP-Skripts
   nicht geschlossen. Sie bleibt zur zukünftigen Verwendung bestehen.
   (<function>mysql_close</function> schließt keine von
   <function>mysql_pconnect</function> geöffneten Verbindungen).
  </para>
  <para>
   Deshalb wird dieser Verbindungstyp "persistent" genannt.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>server</parameter></term>
     <listitem>
      <para>
       Der MySQL-Server. Er kann zudem eine Portnummer enthalten, &zb;
       "hostname:port" oder den Pfad zu einem lokalen Socket &zb;
       ":/pfad/zum/socket" für Zugriffe auf dem lokalen Rechner (localhost).
      </para>
      <para>
       Wenn die PHP-Direktive <link linkend="ini.mysql.default-host">
       mysql.default_host</link> nicht definiert ist (Standard), ist der
       Vorgabewert "localhost:3306".
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>username</parameter></term>
     <listitem>
      <para>
       Der Benutzername. Der Standardwert ist der Name des Benutzers, dem der
       Prozess gehört.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>password</parameter></term>
     <listitem>
      <para>
       Das Passwort. Der Standardwert ist ein leeres Passwort.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>client_flags</parameter></term>
     <listitem>
      <para>
       Der Parameter <parameter>client_flags</parameter> kann eine Kombination
       der folgenden Konstanten sein: 128 (aktiviert die Verwendung von
       <literal>LOAD DATA LOCAL</literal>),
       <constant>MYSQL_CLIENT_SSL</constant>,
       <constant>MYSQL_CLIENT_COMPRESS</constant>,
       <constant>MYSQL_CLIENT_IGNORE_SPACE</constant> und
       <constant>MYSQL_CLIENT_INTERACTIVE</constant>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Gibt im Erfolgsfall eine persitente MySQL-Verbindungskennung zurück.
   &return.falseforfailure;
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    Beachten Sie, dass diese Art der Verbindung nur funktioniert. wenn Sie PHP
    als Modul-Version verwenden. Für mehr Informationen schauen Sie unter
    <link linkend="features.persistent-connections">Persistente
    Datenbankverbindungen</link> nach.
   </para>
  </note>
  <warning>
   <para>
    Die Verwendung von persistenten Verbindungen verlangt unter Umständen eine
    feinere Abstimmung der Konfiguration von Apache und MySQL. Dadurch sollten
    Sie sicherstellen, dass Sie die Anzahl der Verbindungen, die MySQL maximal
    erlaubt, nicht überschreiten.
   </para>
  </warning>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>mysql_connect</function></member>
    <member><link linkend="features.persistent-connections">Persistente
    Datenbankverbindungen</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
-->