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

<reference xml:id="ref.pdo-mysql" xmlns="http://docbook.org/ns/docbook">

<?phpdoc extension-membership="bundledexternal" ?>

<title>MySQL PDO-Treiber (PDO_MYSQL)</title>

<titleabbrev>MySQL PDO-Treiber</titleabbrev>

<partintro>

<section xml:id="ref.pdo-mysql.intro">

&reftitle.intro;

<para>

PDO_MYSQL ist ein Treiber, der die

<link linkend="intro.pdo">PHP Data Objects (PDO)-Schnittstelle</link>

implementiert, um von PHP aus auf MySQL Datenbanken zugreifen zu können.

</para>

<para>

PDO_MYSQL verwendet standardmäßig emulierte vorbereitete Anweisungen.

</para>

<para>

<emphasis role="bold">MySQL 8</emphasis>

</para>

<para>

Bei PHP-Versionen vor PHP 7.1.16 oder der 7.2-Serie vor 7.2.4 muss das

Standard-Passwort-Plugin des MySQL 8-Servers auf

<emphasis>mysql_native_password</emphasis> gesetzt werden, da sonst

Fehler angezeigt werden wie <emphasis>The server requested authentication

method unknown to the client [caching_sha2_password]</emphasis>, auch

wenn <emphasis>caching_sha2_password</emphasis> nicht verwendet wird.

</para>

<para>

Das liegt daran, dass MySQL 8 standardmäßig caching_sha2_password

verwendet und dieses Plugin von den älteren PHP- (mysqlnd) Versionen

nicht erkannt wird. Stattdessen muss die Voreinstellung durch den

Eintrag

<literal>default_authentication_plugin=mysql_native_password</literal> in

der Datei <filename>my.cnf</filename> geändert werden. Das Plugin

<emphasis>caching_sha2_password</emphasis> wird seit PHP 7.4.4

vollständig unterstützt. In älteren Versionen wird es von der Erweiterung

<link linkend="book.mysql-xdevapi">mysql_xdevapi</link> unterstützt.

</para>

<warning>

<para>

Vorsicht ist geboten: Einige MySQL-Tabellentypen (Speicher-Engines)

unterstützen keine Transaktionen. Wenn transaktionaler Datenbankcode für

einen Tabellentyp geschrieben wird, der keine Transaktionen unterstützt,

verhält sich MySQL so, als sei eine Transaktion erfolgreich initiiert

worden. Darüber hinaus werden alle ausgelösten DDL-Abfragen implizit

alle anstehenden Transaktionen festschreiben.

</para>

</warning>

<note>

<para>

Der MySQL-Treiber unterstützt die Konstante

<constant>PDO::PARAM_INPUT_OUTPUT</constant> über die Methode

<methodname>PDOStatement::bindParam</methodname> nicht korrekt; solche

Parameter können zwar verwendet werden, werden aber nicht aktualisiert

(&dh; die eigentliche Ausgabe wird ignoriert).

</para>

</note>

</section>

&reference.pdo-mysql.configure;

&reference.pdo-mysql.constants;

&reference.pdo-mysql.ini;

</partintro>

<refentry xml:id="ref.pdo-mysql.connection">

<refnamediv>

<refname>PDO_MYSQL DSN</refname>

<refpurpose>Verbinden mit MySQL-Datenbanken</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<para>

Der Data Source Name (Name der Datenquelle, DSN) von PDO_MYSQL setzt sich

aus den folgenden Elementen zusammen:

<variablelist>

<varlistentry>

<term>DSN-Präfix</term>

<listitem>

<para>

Das DSN-Präfix ist <userinput>mysql:</userinput>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>host</literal></term>

<listitem>

<para>

Der Name des Rechners, auf dem sich der Datenbankserver befindet

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>port</literal></term>

<listitem>

<para>

Die Nummer des Ports, an dem der Datenbankserver lauscht

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>dbname</literal></term>

<listitem>

<para>

Der Name der Datenbank

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>unix_socket</literal></term>

<listitem>

<para>

Der MySQL-Unix-Socket (sollte nicht mit <literal>host</literal> oder

<literal>port</literal> verwendet werden).

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>charset</literal></term>

<listitem>

<para>

Der Zeichensatz. Weitere Informationen enthält die Dokumentation zum

<link linkend="mysqlinfo.concepts.charset">Zeichensatz</link>-Konzept.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>DSN-Beispiele für PDO_MYSQL</title>

<para>

Das folgende Beispiel zeigt einen PDO_MYSQL-DSN für die Verbindung zu

einer MySQL-Datenbank:

<programlisting>

</programlisting>

Ein paar komplettere Beispiele:

<programlisting>

</programlisting>

</para>

</example>

</para>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<note>

<title>Nur Unix:</title>

<para>

Wenn der Hostname auf <literal>"localhost"</literal> gesetzt ist, wird

die Verbindung zum Server über einen Domain-Socket hergestellt. Wenn

PDO_MYSQL gegen libmysqlclient kompiliert wurde, ist der Speicherort der

Socket-Datei der einkompilierte Speicherort von libmysqlclient. Wenn

PDO_MYSQL gegen mysqlnd kompiliert wurde, kann der Standard-Socket mit

der Einstellung

<link linkend="ini.pdo-mysql.default-socket">pdo_mysql.default_socket</link>

festgelegt werden.

</para>

</note>

</refsect1>

</refentry>

</reference>