Setzt Optionen

# mysqli::options

# mysqli_options

(PHP 5, PHP 7, PHP 8)

mysqli::options -- mysqli_options — Setzt Optionen

### Beschreibung

Objektorientierter Stil

public function mysqli::options(int `$option`, string|int `$value`): bool

Prozeduraler Stil

function mysqli_options(mysqli `$mysql`, int `$option`, string|int `$value`): bool

Wird verwendet, um zusätzliche Verbindungsoptionen festzulegen und das Verhalten einer Verbindung zu beeinflussen.

Diese Funktion kann mehrfach aufgerufen werden, um mehrere Optionen zu setzen.

mysqli_options() muss nach mysqli_init() und vor mysqli_real_connect() aufgerufen werden.

### Parameter-Liste

`mysql`

  Nur bei prozeduralem Aufruf: ein von mysqli_connect() oder mysqli_init() zurückgegebenes mysqli-Objekt.

`option`

  Die Option, die gesetzt werden soll. Es kann einer der folgenden Werte sein:

  Gültige Optionen
  Name | Beschreibung
  --- | ---
  `MYSQLI_OPT_CONNECT_TIMEOUT` | Zeitlimit für den Verbindungsaufbau (in Sekunden)
  `MYSQLI_OPT_READ_TIMEOUT` | Zeitlimit für die Ausführung eines Befehls (in Sekunden). Verfügbar seit PHP 7.2.0.
  `MYSQLI_OPT_LOCAL_INFILE` | Aktivieren/Deaktivieren von `LOAD LOCAL INFILE`
  `MYSQLI_INIT_COMMAND` | Der Befehl, der nach dem Aufbau einer Verbindung zum MySQL-Server ausgeführt wird
  `MYSQLI_SET_CHARSET_NAME` | Der Zeichensatz, der als Standard gesetzt werden soll
  `MYSQLI_READ_DEFAULT_FILE` | Optionen aus der benannten Optionsdatei lesen statt aus my.cnf; wird von mysqlnd nicht unterstützt.
  `MYSQLI_READ_DEFAULT_GROUP` | Liest die Optionen der benannten Gruppe aus der Datei my.cnf oder der Datei, die mit `MYSQL_READ_DEFAULT_FILE` angegeben wurde; wird von mysqlnd nicht unterstützt.
  `MYSQLI_SERVER_PUBLIC_KEY` | Die öffentliche RSA-Schlüsseldatei, die für die SHA-256-basierte Authentifizierung verwendet wird.
  `MYSQLI_OPT_NET_CMD_BUFFER_SIZE` | Die Größe des internen Befehls-/Netzwerkpuffers; gilt nur für mysqlnd.
  `MYSQLI_OPT_NET_READ_BUFFER_SIZE` | Maximale zu lesende Blockgröße (in Bytes), wenn der Textkörper eines MySQL-Befehlspakets gelesen wird; gilt nur für mysqlnd.
  `MYSQLI_OPT_INT_AND_FLOAT_NATIVE` | Wenn nicht-vorbereitete Anweisungen verwendet werden, werden Spalten mit Integer- und Float-Werten wieder in PHP-Zahlen umgewandelt; gilt nur für mysqlnd.
  `MYSQLI_OPT_SSL_VERIFY_SERVER_CERT` | Gibt an, ob das Serverzertifikat verifiziert werden soll oder nicht.

`value`

  Der Wert für die Option

### Rückgabewerte

Gibt bei Erfolg `true` zurück. Bei einem Fehler wird `false` zurückgegeben.

### Fehler/Exceptions

If mysqli error reporting is enabled (`MYSQLI_REPORT_ERROR`) and the requested operation fails, a warning is generated. If, in addition, the mode is set to `MYSQLI_REPORT_STRICT`, a mysqli_sql_exception is thrown instead.

### Beispiele

Siehe mysqli_real_connect().

### Anmerkungen

> Hinweis:

> MySQLnd nimmt immer den Standardzeichensatz des Servers an. Dieser Zeichensatz wird während des Aufbaus der Verbindung bzw. der Authentifizierung übermittelt und danach von MySQLnd verwendet.

> Libmysqlclient verwendet als Standardzeichensatz den, der in der Datei my.cnf angegeben oder durch einen Aufruf von mysqli_options() vor dem Aufruf von mysqli_real_connect() aber nach mysqli_init() gesetzt wurde.

### Siehe auch

- mysqli_init() - Initialisiert MySQLi und liefert ein Objekt zur Verwendung mit mysqli_real_connect()
- mysqli_real_connect() - Baut eine Verbindung zu einem MySQL-Server auf

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open