[php-src] Issue #10964: `man php` does not mention router script usage.
| From: | ash-m | Date: | Tue, 28 Mar 2023 21:31:07 +0000 |
| Subject: | [php-src] Issue #10964: `man php` does not mention router script usage. | ||
| Groups: | php.bugs | ||
| Request: | Send a blank email to php-bugs+get-244033@lists.php.net to get a copy of this message | ||
Issue: https://github.com/php/php-src/issues/10964
Author: ash-m
### Description
The current documentation for
man php (relevant parts):
```
php(1) Scripting Language
php(1)
NAME
php - PHP Command Line Interface 'CLI'
php-cgi - PHP Common Gateway Interface 'CGI' command
SYNOPSIS
[-- snip --]
php [options] -S addr:port [-t docroot]
DESCRIPTION
[-- snip --]
PHP also contains an built-in web server for application development purpose. By using the -S
option
where addr:port point to a local address and port PHP will listen to HTTP requests on that
address
and port and serve files from the current working directory or the docroot passed by the -t
option.
[-- snip --]
OPTIONS
[-- snip --]
--server addr:port
-S addr:port Start built-in web server on the given local address and port
--docroot docroot
-t docroot Specify the document root to be used by the built-in web server
```
The documentation says:
> 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 the start of each HTTP request. If this script
> returns false, then the requested resource is returned as-is.
> Otherwise the script's output is returned to the browser.
There is no mention of the **router script** in the man, nor does this really specify
how it interacts with -t.
### PHP Version
PHP 8.1.17
### Operating System
Ubuntu 22.04.2 LTS