php 内置服务器（php -s）返回 “the requested resource / was not found” 并非端口或网络问题，而是因启动时工作目录（working directory）与 index.php 实际位置不匹配——dockerfile 构建时若未显式设置 workdir 且未将文件复制到默认工作目录，服务器将找不到入口文件。
php 内置服务器（php -s）返回 “the requested resource / was not found” 并非端口或网络问题，而是因启动时工作目录（working directory）与 index.php 实际位置不匹配——dockerfile 构建时若未显式设置 workdir 且未将文件复制到默认工作目录，服务器将找不到入口文件。
你遇到的问题极具代表性：单用 Dockerfile 启动失败，而 docker-compose 成功，根源不在网络或端口映射，而在 PHP 内置服务器对“文档根目录”的严格依赖。
? 问题本质：php -S 的工作目录即文档根目录
PHP 内置 Web 服务器的设计哲学是 “所见即所得”：它只在启动命令执行时的当前工作目录下查找请求的文件（如 / → index.php）。它不读取 .htaccess、不解析虚拟主机配置，也不支持自动映射子目录——路径完全由 pwd 决定。
-
在你的第一个 Dockerfile 中：
FROM php:8.1-alpine COPY . /usr/src/myapp CMD [ "php", "-S", "0.0.0.0:8000"]
COPY 将 index.php 放到了 /usr/src/myapp/，但未设置 WORKDIR。Alpine 镜像默认工作目录为 /，因此 php -S 实际在根目录 / 下查找 index.php —— 而该文件真实路径是 /usr/src/myapp/index.php，自然返回 404。
立即学习“PHP免费学习笔记（深入）”；
在 docker-compose 版本中，虽然 Dockerfile 也未 COPY（仅设了 WORKDIR），但通过 volumes: ./:/usr/src/myapp 将宿主机当前目录（含 index.php）挂载到了容器内 /usr/src/myapp；更重要的是，docker-compose 启动时默认以服务定义中的 WORKDIR（即 /usr/src/myapp）为工作目录运行 CMD，因此 php -S 正确地在 /usr/src/myapp 下找到了 index.php。
✅ 正确修复：三步确保工作目录与文件路径一致
✅ 方案一（推荐 · 构建时固化）：显式声明 WORKDIR + COPY 到该目录
FROM php:8.1-alpine WORKDIR /usr/src/myapp # ← 关键：设定工作目录 COPY . . # ← 复制到 WORKDIR 下（注意结尾的 .） CMD ["php", "-S", "0.0.0.0:8000"]
构建并运行：
docker build -t php-app . docker run -p 8002:8000 php-app
此时容器内结构为：
/usr/src/myapp/ ├── index.php ← 可被 php -S 直接访问 └── ...
访问 http://localhost:8002 即可正常加载。
⚠️ 方案二（开发友好 · 运行时挂载）：保留 WORKDIR，用 -v 动态挂载
FROM php:8.1-alpine WORKDIR /usr/src/myapp CMD ["php", "-S", "0.0.0.0:8000"]
运行时挂载源码（无需重新构建）：
docker run -p 8002:8000 -v $(pwd):/usr/src/myapp php-app
❌ 错误写法（务必避免）
COPY . /usr/src/myapp # 缺少 WORKDIR → 默认 /，php -S 在 / 下找 index.php → 404 CMD ["php", "-S", "0.0.0.0:8000"]
? 进阶提示：启用路由脚本提升健壮性
若项目含静态资源（CSS/JS）或需重写规则（如 Laravel 的 server.php），建议显式指定路由器脚本：
WORKDIR /usr/src/myapp COPY . . # 假设你有 router.php（Laravel 的 public/server.php 可直接复用） CMD ["php", "-S", "0.0.0.0:8000", "router.php"]
router.php 示例（基础版）：
<?php
if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js|ico|xml|rss|txt|eot|woff|ttf|svg)$/', $_SERVER["REQUEST_URI"])) {
return false; // 让 PHP 自动处理静态文件
}
// 否则交由框架入口（如 index.php）
include __DIR__ . '/index.php';? 总结：关键检查清单
| 检查项 | 正确做法 | 错误表现 |
|---|---|---|
| 工作目录 | WORKDIR /path/to/webroot 必须存在且与文件位置一致 | php -S 在 / 下找 index.php，但文件在 /app/ → 404 |
| 文件路径 | COPY . . 或 COPY index.php . 确保文件落在 WORKDIR 内 | COPY . /app 但未切 WORKDIR → 文件不可见 |
| 监听地址 | 必须用 0.0.0.0:PORT（非 localhost），否则外部无法访问 | php -S localhost:8000 → 容器内可通，宿主机连不上 |
| 验证方式 | 进入容器调试：docker exec -it <container> sh -c 'pwd && ls -l' | 盲目修改端口或 Nginx 配置，偏离根本原因 |
✅ 记住：php -S 不是生产方案，仅用于开发。上线务必切换至 Nginx + PHP-FPM 组合，并严格校验 root、fastcgi_pass 和 SCRIPT_FILENAME 参数。而本例中一切 404，都始于一个被忽略的 WORKDIR —— 精准定位工作目录，就是解开 PHP Docker 404 之锁的第一把钥匙。
