必须改hosts文件，因为ThinkPHP5依赖域名访问匹配路由、子域名、URL生成及Cookie域逻辑，不修改则DNS无法解析test.tp5，后续所有配置均失效。
ThinkPHP 5 本地域名绑定必须改 hosts 文件，否则 Route::domain()、子域名路由、URL 生成、Cookie 域名逻辑全部失效——这不是可选项，是前提。
为什么改 hosts 是第一步且不可跳过
浏览器访问 http://test.tp5 时，根本不会发请求到你本机，除非系统先知道这个域名对应哪个 IP。ThinkPHP 5 不做 DNS 解析，它只处理 Web 服务器转发过来的请求；而 Web 服务器（Nginx/Apache）只会在收到合法 Host 头后才把请求交给 PHP。不改 hosts，test.tp5 根本解析失败，后续所有配置都白搭。
常见错误现象：
- 浏览器地址栏输
test.tp5自动跳去搜索引擎 - 输
http://test.tp5报 “DNS_PROBE_FINISHED_NXDOMAIN” 或 “无法访问此网站” - 能打开但显示 Apache/Nginx 默认页，不是 ThinkPHP 的欢迎页或 404 页面
Windows 路径：C:\Windows\System32\drivers\etc\hosts，需用记事本（右键 → 以管理员身份运行）打开；macOS/Linux 执行：sudo nano /etc/hosts。添加一行即可：
立即学习“PHP免费学习笔记（深入）”；
127.0.0.1 test.tp5
保存后必须刷新 DNS 缓存：ipconfig /flushdns（Win）或 sudo dscacheutil -flushcache（macOS）。
Apache 和 Nginx 的虚拟主机配置要点
Web 服务器必须明确告诉 PHP：“当用户请求 test.tp5 时，请把入口指向 ThinkPHP 的 public/ 目录”。指向项目根目录会导致敏感文件（如 app/、config/）被直接暴露，或因缺少 .htaccess 规则而 404。
Apache 示例（httpd-vhosts.conf）：
GitHub Hosts 更新工具（仅限中国用户），安全更新系统hosts文件，保留原有非GitHub条目，仅替换GitHub相关地址。支持备份恢复和风险提示。用于解决GitHub访问问题。
<VirtualHost *:80>
ServerName test.tp5
DocumentRoot "D:/www/myproject/public"
<Directory "D:/www/myproject/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
Nginx 示例（站点配置中）：
server {
listen 80;
server_name test.tp5;
root D:/www/myproject/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param HTTP_HOST $http_host; // 这行不能少！否则 $_SERVER['HTTP_HOST'] 为空
include fastcgi_params;
}
}
改完必须重载服务：sudo apachectl graceful（Apache）或 sudo nginx -s reload（Nginx）。
app.domain_bind 和 Route::domain() 到底怎么用
app.domain_bind 是运行时白名单，不是映射开关。它只在请求进来后校验 $_SERVER['HTTP_HOST'] 是否匹配数组中的字符串。写成 ['test.tp5'] 后，若实际访问的是 http://test.tp5:8000，就会因端口号不一致而拒绝；HTTPS 环境下也必须写成 ['https://test.tp5']。
Route::domain() 绑定子域名（如 admin.test.tp5）时，同样依赖 Host 头完整传递：
- 必须在
hosts中加额外行：127.0.0.1 admin.test.tp5 - Web 服务器
server_name或ServerName必须包含该子域名 - Nginx 需确保
fastcgi_param HTTP_HOST $http_host;存在，否则$_SERVER['HTTP_HOST']为空，Route::domain()永远不触发
调试建议：在控制器里加一句 var_dump($_SERVER['HTTP_HOST'] ?? 'no host');，确认输出和配置完全一致（不含端口、协议、大小写差异）。
别用 PHP 内置服务器跑域名绑定
php -S 127.0.0.1:8000 public/router.php 不支持 Host 头路由，Route::domain() 在里面永远不生效，$_SERVER['HTTP_HOST'] 也不可靠。本地测试域名相关功能，必须用 Apache 或 Nginx。
还有个容易被忽略的点：ThinkPHP 5 的 URL 生成（如 url('admin/index')）默认依赖当前请求的 Host。如果你在命令行执行 php think route:list，它会报错 “Invalid Host”，因为 CLI 环境没有 HTTP_HOST —— 这是正常现象，不代表路由没注册成功。要验证路由是否生效，只能走真实 HTTP 请求。
