Dev Server command argument order issue undocumented

[upstageleft]

From manual page: https://php.net/features.commandline.webserver

---

When invoking the command line development server, if using a routing script, the script file or path MUST be specified AFTER the -t argument specifying the document root path, if both are being used. Reversing the order of these arguments causes failure to serve requested resources unless explicitly included, read, or fileread by the script.

I could not find anything on https://php.net specifying this or indicating any issue.

Environment:
MacBook Air 2025 - M4
PHP v8.4.4
MacOS 15.4 (24E248) Sequoia
Firefox 136.0.4
Chrome 135.0.7049.42 (Official Build) (arm64)

[AllenJB]

You can find information on commandline usage and options by running php --help (this is common to many linux programs)

I've proposed adding a note about this to the page to help users who may end up here directly (it's already mentioned on the commandline top level page). I'm not sure how much more help the documentation could give users given there's already a number of examples that show the correct argument order.