From 65ff2edf07794f22a87948b9f439e9b169b7cd66 Mon Sep 17 00:00:00 2001 From: Volker Dusch Date: Fri, 17 Apr 2026 16:10:01 +0200 Subject: [PATCH] Batch sync functions and deprecations --- appendices/migration81/constants.xml | 12 +++++++++++- language/predefined/generator/rewind.xml | 19 +++++++++---------- language/predefined/iterator/rewind.xml | 15 ++++++++++++--- .../array/functions/array-key-exists.xml | 10 +++++++++- reference/dio/functions/dio-open.xml | 2 +- reference/gnupg/functions/gnupg-init.xml | 2 +- reference/hash/setup.xml | 16 +++++++--------- reference/image/functions/getimagesize.xml | 15 ++++++++++++++- reference/image/functions/imagedestroy.xml | 17 ++++++++++++++--- reference/image/functions/imagettfbbox.xml | 10 +++++++++- reference/image/functions/imagettftext.xml | 12 +++++++++++- reference/json/functions/json-last-error.xml | 12 +++++++++--- reference/json/setup.xml | 13 +++++-------- reference/mysqli/mysqli/error-list.xml | 2 +- reference/outcontrol/ini.xml | 2 +- reference/pcre/functions/preg-match-all.xml | 10 +++++----- reference/posix/functions/posix-getrlimit.xml | 8 +++++--- reference/random/functions/rand.xml | 8 +++++--- reference/sem/functions/shm-detach.xml | 12 +++++++++--- reference/uodbc/functions/odbc-field-num.xml | 2 +- 20 files changed, 139 insertions(+), 60 deletions(-) diff --git a/appendices/migration81/constants.xml b/appendices/migration81/constants.xml index 735dd804a4..b2dbb8d3af 100644 --- a/appendices/migration81/constants.xml +++ b/appendices/migration81/constants.xml @@ -1,5 +1,5 @@ - + Neue globale Konstanten @@ -142,6 +142,16 @@ + + Standard + + + + IMAGETYPE_AVIF + + + + Tokenizer diff --git a/language/predefined/generator/rewind.xml b/language/predefined/generator/rewind.xml index ccdca4cd84..ee79c3f399 100644 --- a/language/predefined/generator/rewind.xml +++ b/language/predefined/generator/rewind.xml @@ -1,10 +1,10 @@ - + Generator::rewind - Setzt den Iterator zum ersten yield zurück + Führt den Generator bis einschließlich des ersten yield aus @@ -14,18 +14,17 @@ - Die Methode setzt den Generator wieder an den Punkt vor dem ersten - &yield;-Ausdruck zurück. - Wenn sich der Generator beim Aufruf dieser Methode nicht an einem ersten - &yield;-Ausdruck befindet, wird er vor dem Zurücksetzen zunächst zum ersten - &yield;-Ausdruck vorrücken lassen. - Befindet sich der Generator bereits am Anfang des zweiten - &yield;-Ausdrucks, wird eine Exception ausgelöst. + Führt den Generator bis einschließlich zum ersten + &yield; aus. + Wenn sich der Generator bereits am ersten &yield; + befindet, wird keine Aktion ausgeführt. + Sobald der Generator jemals über einen &yield;-Ausdruck hinaus fortgesetzt + wurde, löst diese Methode eine Exception aus. Dies ist die erste Methode, die aufgerufen wird, wenn - eine &foreach;-Schleife gestartet wird. Sie wird nicht + eine &foreach;-Schleife gestartet wird. Sie wird nicht nach &foreach;-Schleifen ausgeführt. diff --git a/language/predefined/iterator/rewind.xml b/language/predefined/iterator/rewind.xml index f7ccc467a1..425d6e6bc0 100644 --- a/language/predefined/iterator/rewind.xml +++ b/language/predefined/iterator/rewind.xml @@ -1,6 +1,6 @@ - + @@ -21,9 +21,18 @@ Dies ist die erste Methode, die aufgerufen wird, wenn - eine &foreach;-Schleife gestartet wird. Sie wird nicht - nach &foreach;-Durchläufen ausgeführt. + eine &foreach;-Schleife gestartet wird. Sie wird nicht + nach &foreach;-Durchläufen ausgeführt. + + Da &foreach; vor Beginn der Iteration immer rewind + aufruft, wird ein manuell vorgerückter Iteratorstand + (&zb; über SplFileObject::seek) zurückgesetzt. + + + Um ohne Zurücksetzen des Iterators zu iterieren, kann er in einen + NoRewindIterator verpackt werden. + diff --git a/reference/array/functions/array-key-exists.xml b/reference/array/functions/array-key-exists.xml index 137d385f90..3805cc3160 100644 --- a/reference/array/functions/array-key-exists.xml +++ b/reference/array/functions/array-key-exists.xml @@ -1,5 +1,5 @@ - + @@ -73,6 +73,14 @@ + + 8.5.0 + + Die Verwendung von null im Parameter + key ist veraltet; stattdessen sollte ein leerer + String verwendet werden. + + 8.0.0 diff --git a/reference/dio/functions/dio-open.xml b/reference/dio/functions/dio-open.xml index fd5df3a0ea..67a27022f8 100644 --- a/reference/dio/functions/dio-open.xml +++ b/reference/dio/functions/dio-open.xml @@ -1,6 +1,6 @@ - + diff --git a/reference/gnupg/functions/gnupg-init.xml b/reference/gnupg/functions/gnupg-init.xml index ca8b288aed..4868cb3550 100644 --- a/reference/gnupg/functions/gnupg-init.xml +++ b/reference/gnupg/functions/gnupg-init.xml @@ -1,6 +1,6 @@ - + diff --git a/reference/hash/setup.xml b/reference/hash/setup.xml index 50b6fbfa3a..d070fc6785 100755 --- a/reference/hash/setup.xml +++ b/reference/hash/setup.xml @@ -1,6 +1,6 @@ - + &reftitle.setup; @@ -9,18 +9,16 @@
&reftitle.install; - Von PHP 5.1.2 an wird die Hash-Erweiterung mitgeliefert und standardmäßig - in PHP einkompiliert. + Die Hash-Erweiterung ist eine PHP-Core-Erweiterung und daher immer aktiviert. - Sie kann mit dem --disable-hash Umschalter für configure explizit - deaktiviert werden. Frühere PHP-Versionen können die Hash-Erweiterung mit - der Installation des - PECL-Moduls nutzen. + Vor PHP 7.4.0 wurde die Hash-Erweiterung standardmäßig mitgeliefert und in + PHP einkompiliert, konnte aber mit + explizit deaktiviert werden. - Von PHP 7.4.0 an ist die Hash-Erweiterung eine Core-Erweiterung, so dass - sie immer aktiviert ist. + Vor PHP 5.1.2 wurde die Hash-Erweiterung als + PECL-Modul installiert.
diff --git a/reference/image/functions/getimagesize.xml b/reference/image/functions/getimagesize.xml index 1ea63b16aa..a6a4138b81 100644 --- a/reference/image/functions/getimagesize.xml +++ b/reference/image/functions/getimagesize.xml @@ -1,5 +1,5 @@ - + @@ -196,6 +196,10 @@ if ($size && $fp) { Lesefehler wird getimagesize einen Fehler der Stufe E_NOTICE hervorrufen. + + Ab PHP 8.0.0 wird eine ValueError-Ausnahme + ausgelöst, wenn filename leer ist. + @@ -210,6 +214,15 @@ if ($size && $fp) { + + 8.0.0 + + Eine ValueError-Ausnahme wird nun + ausgelöst, wenn filename leer ist; vorher + wurde einE_WARNING ausgegeben und die + Funktion gab &false; zurück. + + 8.2.0 diff --git a/reference/image/functions/imagedestroy.xml b/reference/image/functions/imagedestroy.xml index 9e0235319c..4b5d583e8d 100644 --- a/reference/image/functions/imagedestroy.xml +++ b/reference/image/functions/imagedestroy.xml @@ -1,5 +1,5 @@ - + @@ -8,10 +8,15 @@ Löscht ein Bild + + &warn.deprecated.function-8-5-0; + + &reftitle.description; - boolimagedestroy + #[\Deprecated] + trueimagedestroy GdImageimage ¬e.resource-migration-8.0-dead-function; @@ -35,7 +40,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; @@ -50,6 +55,12 @@ + + 8.5.0 + + Diese Funktion wurde als veraltet eingestuft. + + 8.0.0 diff --git a/reference/image/functions/imagettfbbox.xml b/reference/image/functions/imagettfbbox.xml index 7fb5a0cff9..88f684bb44 100644 --- a/reference/image/functions/imagettfbbox.xml +++ b/reference/image/functions/imagettfbbox.xml @@ -1,5 +1,5 @@ - + @@ -63,6 +63,14 @@ + + options + + + Wie bei imagettftext. + + + diff --git a/reference/image/functions/imagettftext.xml b/reference/image/functions/imagettftext.xml index b79e49fd75..e4fc2ce335 100644 --- a/reference/image/functions/imagettftext.xml +++ b/reference/image/functions/imagettftext.xml @@ -1,5 +1,5 @@ - + @@ -118,6 +118,15 @@ + + options + + + Ein Array mit dem Schlüssel linespacing, der einen + float-Wert enthält. + + + @@ -220,6 +229,7 @@ imagepng($im); imagettfbbox imagefttext + imagestring diff --git a/reference/json/functions/json-last-error.xml b/reference/json/functions/json-last-error.xml index fcbd4057d4..3999785bf9 100644 --- a/reference/json/functions/json-last-error.xml +++ b/reference/json/functions/json-last-error.xml @@ -1,6 +1,6 @@ - + json_last_error @@ -14,8 +14,9 @@ - Gibt (sofern vorhanden) den letzten Fehler zurück, der beim letzten Kodieren/Dekodieren - von JSON, das JSON_THROW_ON_ERROR nicht angab, aufgetreten ist. + Gibt den letzten Fehler zurück, der gegebenenfalls bei der letzten + JSON-Validierung, -Kodierung oder -Dekodierung auftrat, bei der + JSON_THROW_ON_ERROR nicht angegeben wurde. @@ -100,6 +101,11 @@ Deformierte UTF-16 Zeichen; möglicherweise fehlerhaft kodiert + + JSON_ERROR_NON_BACKED_ENUM + Der Wert enthält ein nicht-backed Enum, das nicht serialisiert werden kann. + Verfügbar ab PHP 8.1.0. + diff --git a/reference/json/setup.xml b/reference/json/setup.xml index c524d6df18..0f7c8c5ee5 100644 --- a/reference/json/setup.xml +++ b/reference/json/setup.xml @@ -1,6 +1,6 @@ - + &reftitle.setup; @@ -8,15 +8,12 @@
&reftitle.install; - Die JSON-Erweiterung ist standardmäßig mit PHP gebündelt und kompiliert. + Die JSON-Erweiterung ist eine PHP-Core-Erweiterung und daher immer aktiviert. - Ab PHP 8.0.0 ist die JSON-Erweiterung eine Kern-Erweiterung von PHP und - somit immer aktiviert. - - - &pecl.info; - &url.pecl.package;json + Vor PHP 8.0.0 wurde die JSON-Erweiterung standardmäßig mitgeliefert und in + PHP einkompiliert, konnte aber mit + explizit deaktiviert werden.
diff --git a/reference/mysqli/mysqli/error-list.xml b/reference/mysqli/mysqli/error-list.xml index 154f5ea0b8..d5b0cec54f 100644 --- a/reference/mysqli/mysqli/error-list.xml +++ b/reference/mysqli/mysqli/error-list.xml @@ -1,6 +1,6 @@ - + diff --git a/reference/outcontrol/ini.xml b/reference/outcontrol/ini.xml index ba7f4fd2f7..4314a41831 100644 --- a/reference/outcontrol/ini.xml +++ b/reference/outcontrol/ini.xml @@ -1,6 +1,6 @@ - +
diff --git a/reference/pcre/functions/preg-match-all.xml b/reference/pcre/functions/preg-match-all.xml index 48fb717409..d5194abc9f 100644 --- a/reference/pcre/functions/preg-match-all.xml +++ b/reference/pcre/functions/preg-match-all.xml @@ -1,6 +1,6 @@ - + @@ -65,6 +65,10 @@ flags + + Wenn kein Flag für die Anordnung angegeben ist, wird + PREG_PATTERN_ORDER angenommen. + Kann eine Kombination folgender Flags sein (es ist zu beachten, dass es keinen Sinn hat, PREG_PATTERN_ORDER zusammen mit @@ -260,10 +264,6 @@ Array - - Falls kein Flag für die Anordnung angegeben wurde, wird - PREG_PATTERN_ORDER angenommen. - diff --git a/reference/posix/functions/posix-getrlimit.xml b/reference/posix/functions/posix-getrlimit.xml index c660059125..d2ae600f14 100644 --- a/reference/posix/functions/posix-getrlimit.xml +++ b/reference/posix/functions/posix-getrlimit.xml @@ -1,6 +1,6 @@ - + @@ -30,8 +30,10 @@ resource - Falls &null;, werden die Limits aller Ressourcen abgerufen. Andernfalls - werden nur die Limits des angegebenen Ressourcentyps zurückgegeben. + Falls &null;, werden alle aktuellen Ressourcenlimits zurückgegeben. + Andernfalls ist die + Ressourcenlimit-Konstante + anzugeben, deren spezifisches Limit abgerufen werden soll. diff --git a/reference/random/functions/rand.xml b/reference/random/functions/rand.xml index dcf577690d..7de8acafcb 100644 --- a/reference/random/functions/rand.xml +++ b/reference/random/functions/rand.xml @@ -1,5 +1,5 @@ - + @@ -28,6 +28,7 @@ Aufruf dafür rand(5, 15). &caution.cryptographically-insecure; + &caution.mt19937-global-state; Vor PHP 7.1.0 war getrandmax auf manchen Plattformen @@ -151,8 +152,9 @@ echo rand(5, 15), "\n"; Der Bereich zwischen min und max muss innerhalb von - getrandmax liegen, &dh; (max - - min) <= getrandmax; + getrandmax liegen, &dh; + abs(max - min) <= + getrandmax. ansonsten wird rand möglicherweise Zufallszahlen schlechter Qualität zurückgeben. diff --git a/reference/sem/functions/shm-detach.xml b/reference/sem/functions/shm-detach.xml index a0eafbc3ff..f5d570c50d 100644 --- a/reference/sem/functions/shm-detach.xml +++ b/reference/sem/functions/shm-detach.xml @@ -1,6 +1,6 @@ - + @@ -11,7 +11,7 @@ &reftitle.description; - boolshm_detach + trueshm_detach SysvSharedMemoryshm @@ -41,7 +41,7 @@ &reftitle.returnvalues; - &return.success; + &return.true.always; @@ -56,6 +56,12 @@ + + 8.5.0 + + Der Rückgabetyp ist nun &true;; vorher war er bool. + + 8.0.0 diff --git a/reference/uodbc/functions/odbc-field-num.xml b/reference/uodbc/functions/odbc-field-num.xml index ecb8d3a3ea..9ee467e24e 100644 --- a/reference/uodbc/functions/odbc-field-num.xml +++ b/reference/uodbc/functions/odbc-field-num.xml @@ -1,5 +1,5 @@ - + odbc_field_num