From c60593eed569731c45a07997f58f254573a57fd6 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Tue, 25 Aug 2026 10:14:13 +0200
Subject: [PATCH 1/2] [Sync-En] flock: document Windows deadlock behavior

Closes: php/doc-fr#3326
---
 reference/filesystem/functions/flock.xml | 25 ++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/reference/filesystem/functions/flock.xml b/reference/filesystem/functions/flock.xml
index f439e7975a..be7787fbbd 100644
--- a/reference/filesystem/functions/flock.xml
+++ b/reference/filesystem/functions/flock.xml
@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 75a76afb61d91f04feebc83931c5412b13682d2b Maintainer: lacatoire Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: f3112c43e303fcd63c0df89798b45bfef9d49e15 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="function.flock" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>flock</refname>
@@ -193,6 +192,23 @@ fclose($fp);
     comme <literal>FAT</literal> et ses dérivés, et retourne forcément
     &false; sous ces environnements.
    </para>
+   <para>
+    Sur Windows, si PHP essaie d'exécuter un fichier source PHP verrouillé par
+    <constant>LOCK_EX</constant>, il va se bloquer jusqu'à ce que le fichier soit
+    déverrouillé. L'exemple suivant provoquera un interblocage :
+    <informalexample>
+     <programlisting role="php">
+<![CDATA[
+<?php
+if ($argv[1] ?? null === 'child') { die(); }
+$fp = fopen(__FILE__, "rb");
+flock($fp, LOCK_EX);
+shell_exec("php " . escapeshellarg(__FILE__) . " child");
+?>
+]]>
+     </programlisting>
+    </informalexample>
+   </para>
   </warning>
   <note>
    <para>
@@ -200,6 +216,11 @@ fclose($fp);
     il ne peut pas accéder au fichier à travers ce gestionnaire jusqu'à ce que
     le fichier soit déverrouillé.
    </para>
+   <simpara>
+    Sur Windows, si vous essayez d'inclure avec <literal>require</literal> un fichier
+    verrouillé par <constant>LOCK_EX</constant>, cela échouera avec l'erreur :
+    ErrorException: require(): Read of X bytes failed with errno=13 Permission denied
+   </simpara>
   </note>
  </refsect1>
  

From 78e12049f83022c5271d995468a3e858b5c17f18 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud <la.catoire@gmail.com>
Date: Tue, 25 Aug 2026 10:34:00 +0200
Subject: [PATCH 2/2] nits

---
 reference/filesystem/functions/flock.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/reference/filesystem/functions/flock.xml b/reference/filesystem/functions/flock.xml
index be7787fbbd..23428136d7 100644
--- a/reference/filesystem/functions/flock.xml
+++ b/reference/filesystem/functions/flock.xml
@@ -1,5 +1,4 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
 <!-- EN-Revision: f3112c43e303fcd63c0df89798b45bfef9d49e15 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="function.flock" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>