From 1a7bccfdc45a9ac502e00a5cd14a5bda08270a9d Mon Sep 17 00:00:00 2001 From: Martin Samesch Date: Fri, 18 Oct 2024 22:31:08 +0200 Subject: [PATCH] Sync with EN --- language/generators.xml | 31 +++--- reference/mysqli/mysqli/change-user.xml | 114 +++++++++++------------ reference/mysqli/mysqli/kill.xml | 26 +++++- reference/mysqli/mysqli/ping.xml | 27 +++++- reference/mysqli/mysqli/refresh.xml | 26 +++++- reference/mysqli/mysqli/store-result.xml | 25 ++++- reference/mysqli/mysqli/thread-id.xml | 6 +- reference/pdo/pdostatement/execute.xml | 4 +- reference/spl/arrayobject.xml | 6 +- 9 files changed, 178 insertions(+), 87 deletions(-) diff --git a/language/generators.xml b/language/generators.xml index 23b0cb21e..97456ef22 100644 --- a/language/generators.xml +++ b/language/generators.xml @@ -1,6 +1,6 @@ - + Generatoren @@ -9,23 +9,24 @@ - Generatoren bieten eine einfache Möglichkeit, um einfache Iteratoren zu erstellen, ohne - den Overhead oder die Komplexität der Erstellung einer Klasse zu haben, - die das Iterator-Interface implementiert. + Generatoren bieten eine einfache Möglichkeit, um einfache + Iteratoren zu erstellen, + ohne den Overhead oder die Komplexität der Erstellung einer Klasse zu + haben, die das Iterator-Interface implementiert. - Ein Generator ermöglicht es Code zu schreiben, der &foreach; nutzt, um über - eine Datenmenge zu iterieren, ohne ein Array im Speicher zu erzeugen, - was zur Überschreitung des Speicherlimits führen kann oder beträchtliche - Prozessorzeit benötigt. Alternativ können Sie eine Generatorfunktion - schreiben, die einer normalen Funktion entspricht, bei der aber - keine einmalige Rückgabe - erfolgt, sondern der Generator so oft wie nötig einen Wert abgibt - (Stichwort: &yield;), um die Werte zu liefern, über die iteriert werden - soll. + Mit einem Generator können auf bequeme Weise Daten für &foreach; -Schleifen + bereitgestellt werden, ohne ein Array im Speicher zu erzeugen, was dazu + führen kann, dass das Programm ein Speicherlimit überschreitet oder + beträchtliche Prozessorzeit benötigt. Alternativ kann eine Generatorfunktion + verwendet werden, die einer normalen + Funktion entspricht, bei der + aber keine einmalige + Rückgabe erfolgt, sondern + der Generator so oft wie nötig einen Wert abgibt (Stichwort: &yield;), um + die Werte zu liefern, über die iteriert werden soll. + Wie bei Iteratoren ist ein wahlfreier Datenzugriff nicht möglich. diff --git a/reference/mysqli/mysqli/change-user.xml b/reference/mysqli/mysqli/change-user.xml index 9a1b9a245..cb6866cf1 100644 --- a/reference/mysqli/mysqli/change-user.xml +++ b/reference/mysqli/mysqli/change-user.xml @@ -1,12 +1,12 @@ - + mysqli::change_user mysqli_change_user - Ändert den Benutzer der angegebenen Datenbankverbindung + Ändert den Benutzer der Datenbankverbindung @@ -27,8 +27,13 @@ stringnulldatabase - Ändert den Benutzer der angegebenen Datenbankverbindung und legt die - aktuelle Datenbank fest. + Versucht, mit den angegebenen Anmeldeinformationen eine Verbindung zur + angegebenen Datenbank herzustellen. + + + Im Gegensatz zu mysqli::connect trennt diese + Methode die aktuelle Verbindung nicht, wenn die neue Verbindung nicht + geöffnet werden kann. Für einen erfolgreichen Benutzerwechsel müssen gültige Werte für die @@ -65,13 +70,9 @@ database - Die Datenbank, zu der gewechselt werden soll - - - Falls gewünscht, kann der Wert &null; übergeben werden, was dazu führt, - dass nur der Benutzer gewechselt und keine Datenbank ausgewählt wird. - Um in diesem Fall eine Datenbank auszuwählen, muss die Funktion - mysqli_select_db verwendet werden. + Der Name der Datenbank. Wenn &null; oder eine leere Zeichenkette + übergeben wird, wird die Verbindung zum Server ohne Standard-Datenbank + geöffnet. @@ -94,82 +95,51 @@ &reftitle.examples; - <methodname>mysqli::change_user</methodname>-Beispiel + Zurücksetzen der Verbindungs-Session &style.oop; query("SET @a:=1"); -/* alles zurücksetzen und eine neue Datenbank auswählen */ $mysqli->change_user("my_user", "my_password", "world"); -if ($result = $mysqli->query("SELECT DATABASE()")) { - $row = $result->fetch_row(); - printf("Standard-Datenbank: %s\n", $row[0]); - $result->close(); -} +$result = $mysqli->query("SELECT DATABASE()"); +$row = $result->fetch_row(); +printf("Standard-Datenbank: %s\n", $row[0]); -if ($result = $mysqli->query("SELECT @a")) { - $row = $result->fetch_row(); - if ($row[0] === NULL) { - printf("Der Wert der Variable a ist NULL\n"); - } - $result->close(); +$result = $mysqli->query("SELECT @a"); +$row = $result->fetch_row(); +if ($row[0] === null) { + printf("Der Wert der Variable a ist NULL\n"); } - -/* Verbindung schließen */ -$mysqli->close(); -?> ]]> &style.procedural; ]]> &examples.outputs; @@ -177,6 +147,30 @@ mysqli_close($link); + + + + Wenn <parameter>database</parameter> &null; ist, wird die Verbindung ohne Auswahl einer Standard-Datenbank geöffnet + &style.oop; + +change_user("my_user", "my_password", null); + +$result = $mysqli->query("SELECT DATABASE()"); +$row = $result->fetch_row(); +printf("Standard-Datenbank: %s\n", $row[0]); +]]> + + &examples.outputs; + + diff --git a/reference/mysqli/mysqli/kill.xml b/reference/mysqli/mysqli/kill.xml index d241ecf1e..20b3d59e3 100644 --- a/reference/mysqli/mysqli/kill.xml +++ b/reference/mysqli/mysqli/kill.xml @@ -1,6 +1,6 @@ - + @@ -55,6 +55,30 @@ &mysqli.conditionalexception; + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Sowohl mysqli::kill als auch + mysqli_kill sind nun veraltet. Stattdessen sollte + der SQL-Befehl KILL verwendet werden. + + + + + + + &reftitle.examples; diff --git a/reference/mysqli/mysqli/ping.xml b/reference/mysqli/mysqli/ping.xml index bf1b25895..b1097c7af 100644 --- a/reference/mysqli/mysqli/ping.xml +++ b/reference/mysqli/mysqli/ping.xml @@ -1,6 +1,6 @@ - + @@ -62,6 +62,31 @@ &mysqli.conditionalexception; + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Sowohl mysqli::ping als auch + mysqli_ping sind nun veraltet. + Die Funktionalität reconnect ist seit PHP 8.2.0 nicht + mehr verfügbar, wodurch diese Funktion überflüssig wurde. + + + + + + + &reftitle.examples; diff --git a/reference/mysqli/mysqli/refresh.xml b/reference/mysqli/mysqli/refresh.xml index d57951fdb..99ca39b15 100644 --- a/reference/mysqli/mysqli/refresh.xml +++ b/reference/mysqli/mysqli/refresh.xml @@ -1,6 +1,6 @@ - + @@ -59,6 +59,30 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Sowohl mysqli::refresh als auch + mysqli_refresh sind nun veraltet. Stattdessen + sollte der SQL-Befehl FLUSH verwendet werden. + + + + + + + &reftitle.seealso; diff --git a/reference/mysqli/mysqli/store-result.xml b/reference/mysqli/mysqli/store-result.xml index 7328d856d..e95ca255c 100644 --- a/reference/mysqli/mysqli/store-result.xml +++ b/reference/mysqli/mysqli/store-result.xml @@ -1,6 +1,6 @@ - + @@ -105,6 +105,29 @@ &mysqli.conditionalexception; + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + Die Übergabe des Parameters mode ist nun veraltet. + Der Parameter hat seit PHP 8.1.0 keine Wirkung mehr. + + + + + + + &reftitle.examples; diff --git a/reference/mysqli/mysqli/thread-id.xml b/reference/mysqli/mysqli/thread-id.xml index 6595e417f..d5e296e13 100644 --- a/reference/mysqli/mysqli/thread-id.xml +++ b/reference/mysqli/mysqli/thread-id.xml @@ -1,6 +1,6 @@ - + @@ -23,8 +23,8 @@ aktuellen Verbindung zurück, die dann mit der Funktion mysqli_kill beendet werden kann. Wenn die Verbindung unterbrochen wird und mit mysqli_ping wieder aufgebaut - wird, ist die Thread-ID eine andere. Daher sollte die Thread-ID nur - abgefragt werden, wenn sie benötigt wird. + wird, ändert sich die Thread-ID. Daher sollte die Thread-ID nur abgefragt + werden, wenn sie benötigt wird. diff --git a/reference/pdo/pdostatement/execute.xml b/reference/pdo/pdostatement/execute.xml index a96a6ec21..a0bf514bc 100644 --- a/reference/pdo/pdostatement/execute.xml +++ b/reference/pdo/pdostatement/execute.xml @@ -1,6 +1,6 @@ - + @@ -157,7 +157,7 @@ $sth->execute(); /* Führt ein Prepared Statement mit einem Array für eine IN-Klausel aus */ $params = array(1, 21, 63, 171); /* Erstelle einen String für die Parameter-Platzhalter, gefüllt bis zur Anzahl Parameter */ -$place_holders = implode(',', array_fill(0, count($params), '?')); +$place_holders = '?' . str_repeat(', ?', count($params) - 1); /* Das bereitet das Statement mit genügend unbenannten Platzhaltern diff --git a/reference/spl/arrayobject.xml b/reference/spl/arrayobject.xml index 4a0324e67..800dff65d 100644 --- a/reference/spl/arrayobject.xml +++ b/reference/spl/arrayobject.xml @@ -1,5 +1,5 @@ - + @@ -16,8 +16,8 @@ - Diese Klasse hat konzeptionelle Mängel, weshalb von ihrer Verwendung - abgeraten wird. + Diese Klasse als Wrapper für Objekte zu verwenden, ist grundsätzlich + problematisch, weshalb von ihrer Verwendung mit Objekten abgeraten wird.