From a08b6d2a9892c318c83ee16afc4116f65113f840 Mon Sep 17 00:00:00 2001
From: Volker Dusch <volker@tideways-gmbh.com>
Date: Mon, 2 Feb 2026 15:13:02 +0100
Subject: [PATCH] Sync reference/filesystem/functions with EN

- Fix build failure in fgetcsv.xml
- Sync all currently open reference/filesystem/functions changes
---
 reference/filesystem/functions/fgetcsv.xml    | 26 ++++++++++---------
 .../functions/file-get-contents.xml           | 16 ++++++------
 reference/filesystem/functions/fopen.xml      | 10 ++++++-
 .../filesystem/functions/parse-ini-file.xml   | 10 ++++++-
 .../filesystem/functions/parse-ini-string.xml | 10 ++++++-
 5 files changed, 49 insertions(+), 23 deletions(-)

diff --git a/reference/filesystem/functions/fgetcsv.xml b/reference/filesystem/functions/fgetcsv.xml
index a44465cd3..ce2308c60 100644
--- a/reference/filesystem/functions/fgetcsv.xml
+++ b/reference/filesystem/functions/fgetcsv.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 781f2ec04ee8817687e5e333bc3e64ab973322d7 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 0a3648a71895f35f570573d31ca9e003786aa993 Maintainer: simp Status: ready -->
 <!-- Reviewed: yes -->
 <!-- Rev-Revision: 34e2e3541c52edc9f60a1ad9735b1f769254eb1e Reviewer: samesch -->
 <!-- Credits: khp -->
@@ -100,19 +100,21 @@
        Die leere Zeichenkette (<literal>""</literal>) deaktiviert den
        proprietären Maskierungsmechanismus.
       </para>
-      <note>
+      <warning xml:id="function.fgetcsv..warn.escape.parameter">
        <simpara>
-        Normalerweise wird ein <parameter>enclosure</parameter>-Zeichen in
-        einem Feld maskiert, indem es verdoppelt wird; allerdings kann
-        alternativ dazu das <parameter>escape</parameter>-Zeichen verwendet
-        werden. So haben die Werte <literal>""</literal> und
-        <literal>\"</literal> standardmäßig dieselbe Bedeutung. Abgesehen von
-        der Möglichkeit, das <parameter>enclosure</parameter>-Zeichen zu
-        maskieren, hat das Zeichen <parameter>escape</parameter> keine
-        besondere Bedeutung; es ist nicht einmal dazu geeignet, sich selbst zu
-        maskieren.
+        Im Eingabe Stream kann das <parameter>enclosure</parameter>-Zeichen
+        immer maskiert werden, indem es innerhalb einer in Anführungszeichen
+        gesetzten Zeichenkette verdoppelt wird, was zu einem einzelnen
+        <parameter>enclosure</parameter>-Zeichen im geparsten Ergebnis führt.
+        Das <parameter>escape</parameter>-Zeichen funktioniert anders:
+        wenn eine Sequenz aus <parameter>escape</parameter>- und
+        <parameter>enclosure</parameter>-Zeichen in der Eingabe erscheint,
+        werden beide Zeichen im geparsten Ergebnis vorhanden sein.
+        Für die Standardparameter wird also eine CSV-Zeile wie
+        <literal>"a""b","c\"d"</literal> die Felder als
+        <literal>a"b</literal> und <literal>c\"d</literal> parsen.
        </simpara>
-      </note>
+      </warning>
       <warning>
        <simpara>
         Seit PHP 8.4.0 ist es veraltet, sich auf den Standardwert von
diff --git a/reference/filesystem/functions/file-get-contents.xml b/reference/filesystem/functions/file-get-contents.xml
index f6f434ab6..de4f462c6 100644
--- a/reference/filesystem/functions/file-get-contents.xml
+++ b/reference/filesystem/functions/file-get-contents.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: ea62fb83196997032641b50fe44420305466195e Maintainer: wiesemann Status: ready -->
+<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 Maintainer: wiesemann Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file-get-contents" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>file_get_contents</refname>
@@ -212,13 +212,13 @@ string(14) "lle Bjori Ro"
 <![CDATA[
 <?php
 // Erzeugen eines Streams
-$opts = array(
-  'http'=>array(
-    'method'=>"GET",
-    'header'=>"Accept-language: en\r\n" .
-              "Cookie: foo=bar\r\n"
-  )
-);
+$opts = [
+  'http' => [
+    'method' => "GET",
+    'header' => "Accept-language: en\r\n" .
+                "Cookie: foo=bar",
+  ]
+];
 
 $context = stream_context_create($opts);
 
diff --git a/reference/filesystem/functions/fopen.xml b/reference/filesystem/functions/fopen.xml
index c99b78a30..6d9b2c01b 100644
--- a/reference/filesystem/functions/fopen.xml
+++ b/reference/filesystem/functions/fopen.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 74b2af242f2131cd43a8830fee3864f1f68ccbed Maintainer: khp Status: ready -->
+<!-- EN-Revision: 18bac8389b98d513c89e965000086acfcdfdd0a9 Maintainer: khp Status: ready -->
 <!-- Reviewed: yes -->
 <!-- Rev-Revision: d579464d52f6b579db3de974cd319c99dd3d71aa Reviewer: samesch -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fopen">
@@ -202,6 +202,14 @@ $handle = fopen("c:\\verzeichnis\\ressource.txt", "r");
             wurde.
            </entry>
           </row>
+          <row>
+           <entry><literal>'n'</literal></entry>
+           <entry>
+            Setzt das Flag non-blocking flag für den geöffneten Datei-Deskriptor.
+            Nur verfügbar, wenn PHP auf POSIX.1-2008-konformen System kompiliert
+            wurde.
+           </entry>
+          </row>
          </tbody>
         </tgroup>
        </table>
diff --git a/reference/filesystem/functions/parse-ini-file.xml b/reference/filesystem/functions/parse-ini-file.xml
index 0e8498c5f..d54038afe 100644
--- a/reference/filesystem/functions/parse-ini-file.xml
+++ b/reference/filesystem/functions/parse-ini-file.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: a5346daf2bb2fab250fa03f0f6639a408d0b2240 Maintainer: simp Status: ready -->
+<!-- EN-Revision: bb54309eff8a7d75ead0fdf48cc6dae99dd00367 Maintainer: simp Status: ready -->
 <refentry xml:id="function.parse-ini-file" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>parse_ini_file</refname>
@@ -24,6 +24,14 @@
   <para>
    Die Struktur der Ini-Datei ist identisch zur &php.ini;.
   </para>
+  <warning>
+   <simpara>
+    Diese Funktion darf nicht mit unvertrauenswürdigen Eingaben verwendet werden,
+    es sei denn, <parameter>scanner_mode</parameter> ist <constant>INI_SCANNER_RAW</constant>,
+    da die geparste Ausgabe Werte von sensiblen Konstanten enthalten könnte,
+    wie beispielsweise Konstanten, die ein Datenbank-Passwort enthalten.
+   </simpara>
+  </warning>
  </refsect1>
 
  <refsect1 role="parameters">
diff --git a/reference/filesystem/functions/parse-ini-string.xml b/reference/filesystem/functions/parse-ini-string.xml
index d361384c6..07fafe450 100644
--- a/reference/filesystem/functions/parse-ini-string.xml
+++ b/reference/filesystem/functions/parse-ini-string.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: tihox Status: ready -->
+<!-- EN-Revision: bb54309eff8a7d75ead0fdf48cc6dae99dd00367 Maintainer: tihox Status: ready -->
 <refentry xml:id="function.parse-ini-string" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>parse_ini_string</refname>
@@ -22,6 +22,14 @@
   <para>
    Die Struktur des ini-Strings ist die selbe wie die der &php.ini;
   </para>
+  <warning>
+   <simpara>
+    Diese Funktion darf nicht mit unvertrauenswürdigen Eingaben verwendet werden,
+    es sei denn, <parameter>scanner_mode</parameter> ist <constant>INI_SCANNER_RAW</constant>,
+    da die geparste Ausgabe Werte von sensiblen Konstanten enthalten könnte,
+    wie beispielsweise Konstanten, die ein Datenbank-Passwort enthalten.
+   </simpara>
+  </warning>
  </refsect1>
 
  <refsect1 role="parameters">