PHP从5.4版本开始就内置了轻量级的Web服务器，适合本地开发调试场景使用，不需要额外安装和配置Nginx、Apache等Web服务软件，能够快速启动项目进行功能验证。如果是刚接触PHP开发的用户，了解内置服务器的使用方法可以大幅降低本地环境搭建的成本。
PHP内置服务器的基础启动方式
启动PHP内置服务器的核心命令是php -S，后面跟上监听的地址和端口即可。如果你的PHP已经添加到系统环境变量中，直接在终端执行以下命令就能启动服务器：
# 启动PHP内置服务器，监听127.0.0.1的8000端口 php -S 127.0.0.1:8000
执行命令后终端会输出启动成功的信息，此时在浏览器访问http://127.0.0.1:8000就能看到当前执行命令所在目录下的文件列表，如果有index.php文件会自动执行并返回结果。
指定项目根目录启动服务器
默认情况下内置服务器会把执行命令的当前目录作为网站根目录，实际开发中我们通常需要指定项目的入口目录，这时候可以添加-t参数来设置根目录：
# 指定/var/www/php_demo为网站根目录，监听9000端口 php -S 127.0.0.1:9000 -t /var/www/php_demo
设置完成后，服务器会优先访问指定根目录下的文件，比如访问http://127.0.0.1:9000/test.php时，实际请求的是/var/www/php_demo/test.php文件。
自定义路由规则配置
如果项目需要自定义路由处理，比如把所有的请求都转发到入口文件index.php，可以编写一个路由脚本，启动服务器时通过指定路由文件实现：
<?php
// router.php 路由脚本内容
$uri = $_SERVER['REQUEST_URI'];
$file = __DIR__ . $uri;
// 如果请求的是存在的文件，直接返回文件内容
if (file_exists($file) && is_file($file)) {
return false;
}
// 否则转发到index.php处理
require __DIR__ . '/index.php';
启动服务器时指定这个路由脚本：
php -S 127.0.0.1:8000 -t /var/www/php_demo router.php
常见问题与解决办法
启动提示端口被占用
如果启动时出现Address already in use的错误，说明指定的端口已经被其他程序占用，可以更换一个未被占用的端口，比如把8000换成8001，或者先查询占用端口的进程并关闭：
# 查询8000端口的占用进程（Linux/macOS系统） lsof -i:8000 # 查询8000端口的占用进程（Windows系统） netstat -ano | findstr "8000"
PHP命令找不到
如果执行php -S命令时提示php not found，说明PHP没有添加到系统环境变量，需要先用完整路径执行PHP程序，比如PHP安装在/usr/local/php/bin/目录下，启动命令改为：
/usr/local/php/bin/php -S 127.0.0.1:8000
内置服务器的适用场景
需要注意的是PHP内置服务器仅适合本地开发调试使用，不支持高并发请求，也没有完善的安全机制，正式生产环境一定要使用Nginx、Apache等专业Web服务器，避免出现问题。
| 场景 | 是否适合使用内置服务器 |
|---|---|
| 本地功能调试 | 适合 |
| 本地接口联调 | 适合 |
| 生产环境部署 | 不适合 |
| 高并发请求处理 | 不适合 |