svn: /phpdoc/de/trunk/reference/mysqli/ configure.xml setup.xml

Modified: phpdoc/de/trunk/reference/mysqli/configure.xml
===================================================================
--- phpdoc/de/trunk/reference/mysqli/configure.xml	2018-04-24 13:37:17 UTC (rev 344822)
+++ phpdoc/de/trunk/reference/mysqli/configure.xml	2018-04-24 13:37:49 UTC (rev 344823)
@@ -1,98 +1,106 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 339132 Maintainer: sammywg Status: ready -->

 <section xml:id="mysqli.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

  &reftitle.install;

- <para xml:id="mysqli.configure">
-  Beginnend mit PHP 5.0 ist die Unterstützung für MySQL in den
-  Standarddistributionen nicht mehr automatisch aktiviert. Das bedeutet,
-  dass PHP explizit so konfiguriert werden muss, dass es die
-  MySQL-Erweiterungen nutzen kann.
- </para>
-
  <para>
-  Die meisten Unixdistributionen enthalten Binärversionen von PHP, die
-  installiert werden können. Obwohl diese Binärversionen typischerweise mit
-  aktivierter Unterstützung für die MySQL-Erweiterungen gebaut sind, müssen die
-  Bibliotheken selbst als zusätzliches Paket installiert werden. Prüfen Sie mit
-  dem Paketmanager Ihrer gewählten Distribution, ob entsprechende Pakete
-  verfügbar sind.
+  Die <literal>mysqli</literal> Extension wurde in PHP 5.0.0 eingeführt; der MySQL
+  Native Treiber mit PHP 5.3.0.
  </para>

- <para>
-  Falls Ihre Unixdistribution kein Binärpaket von PHP mit einer verfügbaren
-  <literal>mysqli</literal>-Erweiterung enthält, müssen Sie PHP aus dem
-  Sourcecode neu bauen. Dies erlaubt es Ihnen anzugeben, welche
-  MySQL-Erweiterungen Sie verwenden wollen, und auch, welche Client-Bibliothek
-  Sie für die jeweilige Erweiterung nutzen möchten.
- </para>
+ <section xml:id="mysqli.installation.linux">

- <para>
-  Um die <literal>mysqli</literal>-Erweiterung für PHP zu aktivieren, müssen
-  Sie den PHP-Sourcecode so konfigurieren, dass er <literal>mysqli</literal>
-  verwendet. Dies erreichen Sie, indem Sie das
-  <command>configure</command>-Skript mit der Option <option
-  role="configure">--with-mysqli=mysql_config_path/mysql_config</option>
-  aufrufen, bevor Sie den Build von PHP starten. Dadurch aktivieren Sie
-  <literal>mysqli</literal> und verwenden die MySQL-Client-Bibliothek (libmysql),
-  um mit dem MySQL-Server zu kommunizieren.
- </para>
+  <title>Installation on Linux</title>

- <note>
   <para>
-   Der <literal>mysql_config_path</literal> repräsentiert den Ort, an dem die
-   <literal>mysql_config</literal> liegt, die mit dem MySQL-Server
-   ausgeliefert wird.
+   Die üblichen Unix-Distributionen enthalten Binärversionen von PHP, die
+   installiert werden können. Obwohl diese Binärversionen typischerweise mit
+   Unterstützung für die MySQL Extensions erstellt wurden, müssen möglicherweise
+   die Extension-Bibliotheken selbst unter Verwendung eines zusätzlichen Pakets
+   installiert werden. Die Paketverwaltung der gewählten Distribution ist auf
+   Verfügbarkeit zu prüfen.
   </para>
- </note>

- <para>
-  Seit PHP-Version 5.3 können Sie alternativ den neuen MySQL-Native-Treiber
-  zusammen mit <literal>mysqli</literal> verwenden. Sie erhalten dadurch eine
-  Reihe von Vorteilen gegenüber der Verwendung der libmysql.
- </para>
+  <para>
+   Beispielsweise installiert unter Ubuntu das <literal>php5-mysql</literal>
+   Paket die PHP Extensions ext/mysql, ext/mysqli und pdo_mysql. Unter CentOS
+   installiert das <literal>php-mysql</literal> Paket ebenfalls diese drei
+   Extensions.
+  </para>

- <para>
-  Um den MySQL-Native-Treiber mit <literal>mysqli</literal> zu verwenden, müssen
-  Sie den PHP-Sourcecode mit <option
-  role="configure">--with-mysqli=mysqlnd</option> konfigurieren, bevor Sie den
-  PHP-Build starten.
- </para>
+  <para>
+   Alternativ kann diese Extension auch selbst kompiliert werden. Das
+   Kompilieren von PHP aus den Quellen erlaubt die Auswahl der MySQL Extensions,
+   die verwendet werden sollen, sowie die Wahl der Client-Bibliothek für jede
+   Extension.
+  </para>

- <para>
-  Dies ist die empfohlene Option, da die Verwendung des MySQL-Native-Treibers
-  zu einer verbesserten Performance führt und Zugriff auf Funktionen gewährt,
-  die bei der Verwendung der MySQL-Client-Bibliothek nicht zur Verfügung stehen.
-  Lesen Sie <link linkend="mysqli.overview.mysqlnd">Was versteht man unter
-  dem MySQL-Native-Treiber von PHP?</link>, um einen kurzen Überblick über die
-  Vorteile des MySQL-Native-Treibers zu erhalten.
- </para>
+  <para>
+   Der MySQL-Native-Treiber wird empfohlen, da er
+   zu einer verbesserten Performance führt und Zugriff auf Funktionen gewährt,
+   die bei der Verwendung der MySQL-Client-Bibliothek nicht zur Verfügung stehen.
+   Lesen Sie <link linkend="mysqli.overview.mysqlnd">Was versteht man unter
+   dem MySQL-Native-Treiber von PHP?</link>, um einen kurzen Überblick über die
+   Vorteile des MySQL-Native-Treibers zu erhalten.
+  </para>

- <para>
-  Es ist möglich, MySQL-Erweiterungen und Client-Bibliotheken
-  frei zu mischen. Zum Beispiel ist es denkbar, dass die MySQL-Erweiterung
-  die MySQL-Client-Bibliothek (libmysql) verwendet, während die
-  <literal>mysqli</literal>-Erweiterung so konfiguriert ist, dass sie den
-  MySQL-Native-Treiber verwendet. Alle Kombinationen von Erweiterungen und
-  Client-Bibliotheken sind möglich.
- </para>
+  <para>
+   <literal>/path/to/mysql_config</literal> stellt den Pfad des
+   <literal>mysql_config</literal> Programms dar, das mit MySQL Server ausgeliefert wird.
+  </para>

- <para>
-  Das folgende Beispiel baut die MySQL-Erweiterung unter Verwendung der
-  MySQL-Client-Bibliothek und <literal>mysqli</literal>- sowie
-  PDO-MYSQL-Erweiterungen, die den MySQL-Native-Treiber verwenden:
- </para>
+  <table>
+   <title>MySQLi Kompilierzeit Support-Matrix</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>5.4.x</entry>
+      <entry>mysqlnd</entry>
+      <entry><option role="configure">--with-mysqli</option></entry>
+      <entry><option role="configure">--with-mysqli=/path/to/mysql_config</option></entry>
+      <entry>mysqlnd ist nun standardmäßig aktiviert</entry>
+     </row>
+     <row>
+      <entry>5.3.x</entry>
+      <entry>libmysqlclient</entry>
+      <entry><option role="configure">--with-mysqli=mysqlnd</option></entry>
+      <entry><option role="configure">--with-mysqli=/path/to/mysql_config</option></entry>
+      <entry>mysqlnd wird unterstützt</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-mysqli=/path/to/mysql_config</option></entry>
+      <entry>mysqlnd wird nicht unterstützt</entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </table>

- <programlisting role="shell">
-./configure --with-mysql=/usr/bin/mysql_config  \
---with-mysqli=mysqlnd \
---with-pdo-mysql=mysqlnd
-[other options]
- </programlisting>
+  <para>
+   Es ist möglich, MySQL-Erweiterungen und Client-Bibliotheken
+   frei zu mischen. Zum Beispiel ist es denkbar, dass die MySQL-Erweiterung
+   die MySQL-Client-Bibliothek (libmysqlclient) verwendet, während die
+   <literal>mysqli</literal>-Erweiterung so konfiguriert ist, dass sie den
+   MySQL-Native-Treiber verwendet. Alle Kombinationen von Erweiterungen und
+   Client-Bibliotheken sind möglich.
+  </para>

+ </section>
+
  <section xml:id="mysqli.installation.windows">

   <title>Installation auf Windows-Systemen</title>
@@ -99,72 +107,86 @@

   <para>
    Unter Windows wird PHP in der Regel durch den Binärinstaller installiert.
-   Sobald PHP installiert wurde, sind einige Konfigurationseinstellungen
-   notwendig, um <literal>mysqli</literal> zu aktivieren und die
-   Client-Bibliothek anzugeben, die verwendet werden soll.
   </para>

-  <para>
-   Wie zuvor erwähnt, ist die <literal>mysqli</literal>-Erweiterung nicht
-   standardmäßig aktiviert, daher muss die
-   <filename>php_mysqli.dll</filename>-DLL in der &php.ini; aktiviert werden.
-   Um dies zu tun, müssen Sie die &php.ini;-Datei finden (typischerweise liegt
-   diese unter <filename>c:\php</filename>) und überprüfen, dass das
-   Kommentarzeichen (ein Semikolon) vom Anfang der Zeile
-   <literal>extension=php_mysqli.dll</literal> in der Sektion
-   <literal>[PHP_MYSQLI]</literal> entfernt wurde.
-  </para>
+  <section xml:id="mysqli.installation.windows.php53">

-  <para>
-   Wenn Sie die MySQL-Client-Bibliothek mit <literal>mysqli</literal> verwenden
-   wollen, stellen Sie sicher, dass PHP auf die Bibliothek zugreifen kann. Die
-   MySQL-Client-Bibliothek ist in einer Datei namens
-   <filename>libmysql.dll</filename> der PHP-Windowsdistribution enthalten. Um
-   sie erfolgreich laden zu können, muss sie innerhalb des Pfades liegen, der
-   von der Windows-Umgebungsvariablen <envar>PATH</envar> bestimmt wird. Lesen
-   Sie dazu auch den FAQ-Eintrag "<link
-   linkend="faq.installation.addtopath">Wie füge ich mein PHP-Verzeichnis der
-   PATH-Variablen unter Windows hinzu?</link>", um mehr Informationen darüber zu
-   erhalten. Das Kopieren <filename>libmysql.dll</filename> in das
-   Windows-Systemverzeichnis (typischerweise
-   <filename>c:\Windows\system</filename>) funktioniert ebenfalls, da das
-   Systemverzeichnis standardmäßig im <envar>PATH</envar> enthalten ist.
-   Allerdings raten wir von dieser Arbeitsweise stark ab.
-  </para>
+   <title>PHP 5.3.0+</title>

-  <para>
-   Unter Windows gilt für die PHP-Versionen 5.3 und neuer, dass die
-   <literal>mysqli</literal>-Erweiterung standardmäßig den MySQL-Native-Treiber
-   verwendet. Das bedeutet, dass Sie sich keine Gedanken über die Konfiguration
-   des Zugriffs auf die <filename>libmysql.dll</filename> machen brauchen; Sie
-   müssen nur sicherstellen, dass die Erweiterung in der &php.ini; aktiviert
-   ist.
-  </para>
+   <para>
+    Unter Windows gilt für die PHP-Versionen 5.3 und neuer, dass die
+    <literal>mysqli</literal>-Erweiterung standardmäßig aktiviert ist, und den MySQL-Native-Treiber
+    verwendet. Das bedeutet, dass Sie sich keine Gedanken über die Konfiguration
+    des Zugriffs auf die <filename>libmysql.dll</filename> machen brauchen.
+   </para>

-  <para>
-   Wie bei der Aktivierung jeder anderen PHP-Extension (wie z.B.
-   <filename>php_mysqli.dll</filename>) sollte auch hier die PHP-Direktive
-   <link linkend="ini.extension-dir">extension_dir</link> auf das Verzeichnis
-   zeigen, in dem die vorhandenen PHP-Extensions liegen. Lesen Sie dazu auch den
-   Abschnitt <link linkend="install.windows.legacy.manual">Manual Windows Installation
-   Instructions</link>. Ein entsprechender <literal>extension_dir</literal>-Wert
-   für PHP 5 ist zum Beispiel <filename>c:\php\ext</filename>.
-  </para>
+  </section>

-  <note>
+  <section xml:id="mysqli.installation.windows.php52">
+
+   <title>PHP 5.0, 5.1, 5.2</title>
+
    <para>
-    Wenn beim Starten des Webservers ein Fehler ähnlich dem folgenden auftritt:
-    <literal>"Unable to load dynamic library './php_mysqli.dll'"</literal>,
-    wird im Normalfall die <filename>php_mysqli.dll</filename> und/oder die
-    <filename>libmysql.dll</filename> nicht vom System gefunden.
+    Unter diesen alten, nicht mehr unterstützten PHP-Versionen (die
+    Unterstützung von PHP 5.2 wurde am 6. Januar 2011 eingestellt),
+    sind zusätzliche Konfigurationsschritte
+    notwendig, um <literal>mysqli</literal> zu aktivieren und die
+    Client-Bibliothek anzugeben, die verwendet werden soll.
    </para>
-  </note>

+   <para>
+    Die <literal>mysqli</literal>-Erweiterung ist standardmäßig
+    nicht aktiviert, daher muss die
+    <filename>php_mysqli.dll</filename>-DLL in der &php.ini; aktiviert werden.
+    Um dies zu tun, müssen Sie die &php.ini;-Datei finden (typischerweise liegt
+    diese unter <filename>c:\php</filename>) und überprüfen, dass das
+    Kommentarzeichen (ein Semikolon) vom Anfang der Zeile
+    <literal>extension=php_mysqli.dll</literal> in der Sektion
+    <literal>[PHP_MYSQLI]</literal> entfernt wurde.
+   </para>
+
+   <para>
+    Wenn Sie die MySQL-Client-Bibliothek mit <literal>mysqli</literal> verwenden
+    wollen, stellen Sie sicher, dass PHP auf die Bibliothek zugreifen kann. Die
+    MySQL-Client-Bibliothek ist in einer Datei namens
+    <filename>libmysql.dll</filename> der PHP-Windowsdistribution enthalten. Um
+    sie erfolgreich laden zu können, muss sie innerhalb des Pfades liegen, der
+    von der Windows-Umgebungsvariablen <envar>PATH</envar> bestimmt wird. Lesen
+    Sie dazu auch den FAQ-Eintrag "<link
+    linkend="faq.installation.addtopath">Wie füge ich mein PHP-Verzeichnis der
+    PATH-Variablen unter Windows hinzu?</link>", um mehr Informationen darüber zu
+    erhalten. Das Kopieren <filename>libmysql.dll</filename> in das
+    Windows-Systemverzeichnis (typischerweise
+    <filename>c:\Windows\system</filename>) funktioniert ebenfalls, da das
+    Systemverzeichnis standardmäßig im <envar>PATH</envar> enthalten ist.
+    Allerdings raten wir von dieser Arbeitsweise stark ab.
+   </para>
+
+   <para>
+    Wie bei der Aktivierung jeder anderen PHP-Extension (wie z.B.
+    <filename>php_mysqli.dll</filename>) sollte auch hier die PHP-Direktive
+    <link linkend="ini.extension-dir">extension_dir</link> auf das Verzeichnis
+    zeigen, in dem die vorhandenen PHP-Extensions liegen. Lesen Sie dazu auch den
+    Abschnitt <link linkend="install.windows.legacy.manual">Manual Windows Installation
+    Instructions</link>. Ein entsprechender <literal>extension_dir</literal>-Wert
+    für PHP 5 ist zum Beispiel <filename>c:\php\ext</filename>.
+   </para>
+
+   <note>
+    <para>
+     Wenn beim Starten des Webservers ein Fehler ähnlich dem folgenden auftritt:
+     <literal>"Unable to load dynamic library './php_mysqli.dll'"</literal>,
+     wird im Normalfall die <filename>php_mysqli.dll</filename> und/oder die
+     <filename>libmysql.dll</filename> nicht vom System gefunden.
+    </para>
+   </note>
+
+  </section>
+
  </section>

 </section>

-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/de/trunk/reference/mysqli/setup.xml
===================================================================
--- phpdoc/de/trunk/reference/mysqli/setup.xml	2018-04-24 13:37:17 UTC (rev 344822)
+++ phpdoc/de/trunk/reference/mysqli/setup.xml	2018-04-24 13:37:49 UTC (rev 344823)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: tihox Status: ready -->
+<!-- EN-Revision: 344819 Maintainer: tihox Status: ready -->
 <!-- Reviewed: no -->

 <chapter xml:id="mysqli.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -12,13 +12,26 @@
   <para>
    Um diese Erweitertung zu benutzen muss PHP mit Support für die mysqli Erweiterung compiliert werden.
   </para>
-  <note>
-   <para>
-    Die mysqli Erweiterung funktioniert mit den MySQL Version 4.1.13 oder neuer und  5.0.7 oder neuer.
-Für ältere Versionen schauen Sie sich bitte die <link
-    linkend="intro.mysql">MySQL</link> Erweiterung an.
-   </para>
-  </note>
+  <para>
+   <emphasis role="bold">MySQL 8</emphasis>
+  </para>
+  <para>
+   Bei der Verwendung von PHP vor 7.1.16 oder PHP 7.2 vor 7.2.4, ist als Standard
+   Passwort-Plugin des MySQL 8 Servers <emphasis>mysql_native_password</emphasis>
+   zu konfigurieren; andernfalls werden Fehlermeldungen in der Art
+   <emphasis>The server requested authentication method unknown to the client [caching_sha2_password]</emphasis>
+   auftreten, selbst wenn <emphasis>caching_sha2_password</emphasis> nicht verwendet
+   wird.
+  </para>
+  <para>
+   Das liegt daran, dass das Standard Passwort-Plugin von MySQL 8 caching_sha2_password ist,
+   ein Plugin, dass den älteren PHP (mysqlnd) Versionen nicht bekannt ist. Daher sollte
+   also <literal>default_authentication_plugin=mysql_native_password</literal> in
+   <filename>my.cnf</filename> konfiguriert werden. Das <emphasis>caching_sha2_password</emphasis>
+   Plugin wird in einer zukünftigen PHP-Version unterstützt werden. In der
+   Zwischenzeit wird es von der <link linkend="book.mysql-xdevapi">mysql_xdevapi</link>
+   Extension unterstützt.
+  </para>
  </section>
  <!-- }}} -->