configure.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 40667918dcff1d5c9f7ecdc88b5caca24ba0686c Maintainer: simp Status: ready -->
<!-- Credits: hholzgra -->
<section xml:id="mysql.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;

 <warning>
  &mysql.alternative.note;
 </warning>

 <para xml:id="mysql.configure">
  Verwenden Sie die Konfigurationsoption <option
  role="configure">--with-mysql[=DIR]</option>, um diese Erweiterung zu
  kompilieren. Der optionale Parameter <literal>[DIR]</literal> sollte dabei
  das Verzeichnis angeben, in dem Sie MySQL installiert haben.
 </para>
 <para>
  Die MySQL-Erweiterung ist zwar kompatibel mit aktuellen MySQL-Versionen, sie
  unterstützt aber nicht mehr alle zusätzlichen Funktionalitäten die seit
  MySQL 4.1.0 hinzugekommen sind. Wenn Sie diese benötigen, so verwenden Sie
  stattdessen die neuere
  <link linkend="book.mysqli">MySQLi</link>-Erweiterung.
 </para>
 <para>
  Wenn Sie beide MySQL-Erweiterungen gleichzeitig verwenden wollen, so sollten
  Sie diese mit der gleichen MySQL-Client-Bibliotheksversion erstellen, um
  mögliche Versionskonflikte zu vermeiden.
 </para>

 <section xml:id="mysql.installation.linux">
  <title>Installation auf Linux-Systemen</title>
  <para>
   Beachten sie: <literal>[DIR]</literal> ist der Pfad zu den
   MySQL-Client-Bibliotheksdateien (<emphasis>Header-Dateien und
   Bibliotheken</emphasis>), die von
   <link xlink:href="&url.mysql;">MySQL</link> heruntergeladen werden können.
  </para>
  <table xml:id="mysql.installation.compile.support">
   <title>Matrix der ext/mysql-Kompilierungsoptionen</title>
   <tgroup cols="5">
    <thead>
     <row>
      <entry>PHP &Version;</entry>
      <entry>&Default;</entry>
      <entry>&ConfigureOptions;: <link linkend="mysqlnd.overview">mysqlnd</link></entry>
      <entry>&ConfigureOptions;: <literal>libmysqlclient</literal></entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>4.x.x</entry>
      <entry>libmysqlclient</entry>
      <entry>&NotAvailable;</entry>
      <entry><option role="configure">--without-mysql</option> zum Deaktivieren</entry>
      <entry>
       MySQL ist standardmäßig aktiviert und die MySQL-Client-Bibliotheken
       sind gebündelt.
      </entry>
     </row>
     <row>
      <entry>5.0.x, 5.1.x, 5.2.x</entry>
      <entry>libmysqlclient</entry>
      <entry>&NotAvailable;</entry>
      <entry><option role="configure">--with-mysql=[DIR]</option></entry>
      <entry>
       MySQL ist nicht mehr standardmäßig aktiviert und die
       MySQL-Client-Bibliotheken sind nicht mehr gebündelt.
      </entry>
     </row>
     <row>
      <entry>5.3.x</entry>
      <entry>libmysqlclient</entry>
      <entry><option role="configure">--with-mysql=mysqlnd</option></entry>
      <entry><option role="configure">--with-mysql=[DIR]</option></entry>
      <entry>mysqlnd ist nun verügbar</entry>
     </row>
     <row>
      <entry>5.4.x</entry>
      <entry>mysqlnd</entry>
      <entry><option role="configure">--with-mysql</option></entry>
      <entry><option role="configure">--with-mysql=[DIR]</option></entry>
      <entry>mysqlnd ist nun der Standard</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </section>

 <section xml:id="mysql.installation.windows">
  <title>Installation auf Windows-Systemen</title>
  <section xml:id="mysql.installation.windows.php52">
   <title>PHP 5.0.x, 5.1.x, 5.2.x</title>
   <para>
    MySQL ist nicht mehr automatisch aktiviert, Sie müssen die DLL
    <filename>php_mysql.dll</filename> in Ihrer &php.ini; selbst einbinden.
    PHP benötigt darüber hinaus Zugriff auf die MySQL-Client-Bibliothek. Eine
    Datei mit Namen <filename>libmysql.dll</filename> ist in der
    PHP-Distribution für Windows enthalten. Diese muss für Ihr
    Windows-System über <envar>PATH</envar> zu finden sein, damit Sie
    MySQL-Datenbanken aus PHP heraus verwenden können. Der FAQ-Eintrag "<link
    linkend="faq.installation.addtopath">Wie füge ich unter Windows mein
    PHP-Verzeichnis zu <envar>PATH</envar> hinzu?</link>" bietet nähere
    Informationen zu diesem Thema. Sie können
    <filename>libmysql.dll</filename> zwar auch direkt in Ihr
    Windows-Systemverzeichnis kopieren (da dieses immer im
    <envar>PATH</envar>-Suchpfad enthalten ist), von diesem Vorgehen wird aber
    abgeraten.
   </para>
   <para>
    Die PHP-Direktive <link linkend="ini.extension-dir">extension_dir</link>
    sollte, wie bei jeder anderen Erweiterung auch, auf das Verzeichnis
    zeigen, in dem die PHP-Erweiterungen (wie
    <filename>php_mysql.dll</filename>) zu finden sind. Siehe hierzu auch
    <link linkend="install.windows.manual">Manuelle PHP-Installation auf Windows</link>.
    Ein Beispiel für einen Wert von extension_dir für PHP 5 ist
    <literal>c:\php\ext</literal>.
   </para>
   <note>
    <para>
     Erscheint beim Start des Webservers eine Fehlermeldung in der Art von
     <literal>"Unable to load dynamic library './php_mysql.dll'"</literal>, so
     liegt das daran, dass <filename>php_mysql.dll</filename> und/oder
     <filename>libmysql.dll</filename> vom System nicht gefunden werden
     konnten.
    </para>
   </note>
  </section>
  <section xml:id="mysql.installation.windows.php53">
   <title>PHP 5.3.0+</title>
   <para>
    Der <link linkend="mysqlnd.overview">MySQL Native Treiber</link> ist
    standardmäßig aktiviert. Binden sie <filename>php_mysql.dll</filename>
    ein, <filename>libmysql.dll</filename> wird jedoch nicht mehr benötigt
    oder verwendet.
   </para>
  </section>
 </section>

 <section xml:id="mysql.installation.notes">
  <title>MySQL-Installationshinweise</title>
   <warning>
    <para>
     Initialisierungsprobleme und Abstürze können vorkommen, wenn Sie diese
     Erweiterung zusammen mit der Erweiterung recode verwenden. Nähere
     Informationen hierzu finden Sie im Handbuch-Abschnitt zu <link
     linkend="ref.recode">recode</link>.
    </para>
   </warning>
   <note>
    <para>
     Wenn Sie andere Zeichensätze als den Standardzeichensatz
     <emphasis>latin</emphasis> verwenden sollen, so müssen Sie zum Erstellen
     der Erweiterung eine externe libmysqlclient verwenden die mit voller
     Zeichensatzunterstützung erstellt wurde. Die mit PHP 4 mitgelieferte
     libmysql bietet dies nicht.
    </para>
   </note>
 </section>
</section>

<!-- 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
-->