From 163897198207a34166ce2292e8c6b02cd4f65988 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud <la.catoire@gmail.com>
Date: Fri, 10 Jul 2026 14:24:38 +0200
Subject: [PATCH] cli: Document built-in server index lookup for file-like
 paths (8.4.0)

---
 features/commandline.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/features/commandline.xml b/features/commandline.xml
index c1bdfa31690d..5259ddb1b07c 100644
--- a/features/commandline.xml
+++ b/features/commandline.xml
@@ -1656,6 +1656,15 @@ php >
     the URI. Otherwise a 404 response code is returned.
   </para>
 
+  <note>
+   <simpara>
+    As of PHP 8.4.0, this index file lookup is performed even when the
+    requested path looks like a file, i.e. its last path component contains a
+    period, but cannot be located. Previously, such requests skipped the
+    lookup and immediately returned a 404 response.
+   </simpara>
+  </note>
+
   <para>
     If a PHP file is given on the command line when the web server is
     started it is treated as a "router" script.  The script is run at