需修改hosts文件并配置Web服务器虚拟主机，将test.local指向ThinkPHP的public目录，而非依赖app.domain_bind或app.url配置。

ThinkPHP 本地怎么让 http://test.local 访问到你的项目

直接改 hosts 文件 + 配置 Web 服务器虚拟主机，ThinkPHP 本身不参与域名解析，它只响应被正确路由进来的请求。别在 config/app.php 里找“绑定域名”开关——那只是运行时的域名白名单校验，不是映射手段。

常见错误现象：http://localhost:8000 能打开，但改成 http://test.local 就报 DNS 错误或连接被拒绝；或者能解析但显示 Apache/Nginx 默认页，不是你的 ThinkPHP 页面。

• Windows：用记事本（管理员权限）打开 C:\Windows\System32\drivers\etc\hosts，加一行 127.0.0.1 test.local
• macOS / Linux：终端执行 sudo nano /etc/hosts，同样追加 127.0.0.1 test.local
• 改完保存后，清 DNS 缓存：ipconfig /flushdns（Win）或 sudo dscacheutil -flushcache（macOS）

Apache 或 Nginx 怎么把 test.local 指向 ThinkPHP 的 public/ 目录

Web 服务器必须知道：当用户访问 test.local 时，该把请求交给哪个目录处理。ThinkPHP 的入口是 public/index.php，不能指向项目根目录，否则 app/、config/ 等敏感目录可能被直接暴露。

典型错误：Nginx 配置里 root 写成 /path/to/thinkphp，结果 403 或 404；Apache 的 DocumentRoot 指向错，导致路由失效或静态资源 404。

立即学习“PHP免费学习笔记（深入）”；

• Apache 示例（vhost）：DocumentRoot "/path/to/thinkphp/public"，且确保 AllowOverride All 开启，让 .htaccess 生效
• Nginx 示例：root /path/to/thinkphp/public;，并保留 ThinkPHP 官方推荐的 try_files 规则：try_files $uri $uri/ /index.php?$query_string;
• 改完配置必须重载：Apache 用 sudo apachectl graceful，Nginx 用 sudo nginx -s reload

为什么开了 app.domain_bind 还是 404 或跳转失败

app.domain_bind 是 ThinkPHP 的运行时域名白名单，不是映射工具。它只在请求进来后做一次比对，不匹配就直接抛出 HttpException（通常 404）。它解决的是“防止别人用 IP 或其他域名非法访问你的后台”，不是“帮你把域名连进来”。

容易踩的坑：app.domain_bind 值写成 ['test.local']，但实际访问的是 http://test.local:8000 —— 端口号会导致域名比对失败；或者用了 HTTPS 但配置里没写 https://test.local。

• 检查当前请求的完整 Host：var_dump($_SERVER['HTTP_HOST'] ?? 'no host');，确认和 app.domain_bind 数组里的字符串完全一致（含端口、协议）
• 开发阶段建议先注释掉 app.domain_bind，排除干扰；确认域名能正常访问后再开启校验
• 如果用 Swoole 或 Hyperf 类型的常驻进程，改了配置要重启服务，不是刷新页面就能生效

本地调试时，URL 生成函数（如 url()）为啥还是输出 localhost

url() 函数默认根据当前请求的 $_SERVER['HTTP_HOST'] 和 $_SERVER['REQUEST_SCHEME'] 构建链接，不是读取 app.url 配置。所以即使你在 config/app.php 里写了 'url' => 'http://test.local'，只要浏览器访问的是 localhost:8000，生成的 URL 就还是 localhost。

这不是 bug，是设计逻辑：避免硬编码导致线上环境出错。但本地联调接口、发邮件链接时，确实需要稳定域名。

• 临时方案：在本地环境配置中覆盖 app.url，例如 env('APP_URL', 'http://test.local')，并在 url() 调用前手动设置 Url::root('http://test.local')
• 更稳妥的做法：用 Request::root() 替代硬写域名，它会自动识别当前请求上下文
• 注意：Swoole 下 $_SERVER 可能不全，需配合 think-swoole 扩展或手动注入 HTTP_HOST

最麻烦的其实是 HTTPS 本地证书和混合内容——浏览器拦掉 HTTP 资源，但本地又懒得配证书。这时候宁可统一用 HTTP 调试，别强行套 HTTPS 域名。