ThinkPHP5本地测试域名绑定无效排查步骤-ThinkPHP-PHP中文网

thinkphp5本地route::domain()绑定无效主因是环境未通，需先改hosts文件（如127.0.0.1 admin.test）并刷新dns缓存，再配nginx/apache指向public目录及正确重写规则，且必须用正式web服务器而非php -s。

thinkphp5本地测试域名绑定无效排查步骤

ThinkPHP5 本地测试 Route::domain() 绑定无效，90% 是环境没通，不是代码写错。直接改 hosts + Web 服务器配置，别在框架配置里瞎调 app.domain_bind。

浏览器根本解析不到你写的域名，后续全白搭。关键点不是“写了没”，而是“写在哪、格式对不对、缓存清没清”：

Windows：用管理员权限打开 C:\Windows\System32\drivers\etc\hosts，追加 127.0.0.1 admin.test（不能有空格、不能带 http://、不能写成 localhost）
macOS/Linux：执行 sudo nano /etc/hosts，同样加一行 127.0.0.1 admin.test
改完必须刷新 DNS 缓存：ipconfig /flushdns（Win）或 sudo dscacheutil -flushcache（macOS）
验证是否生效：终端运行 ping admin.test，看到回复 127.0.0.1 才算成功

即使 hosts 对了，Web 服务器没配好，请求也进不了 ThinkPHP。常见错误是 root 指向错目录或没启用重写：

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

Nginx 配置中 root 必须指向项目 public/ 目录，不是项目根目录；否则 403 或静态资源 404
Nginx 的 location 块里必须有 try_files $uri $uri/ /index.php?$query_string;，不能简化为 /index.php?_url=（会丢 HTTP_HOST）
Apache 要开启 mod_rewrite，DocumentRoot 指向 public/，且 .htaccess 中的 RewriteRule 必须启用（AllowOverride All）
改完配置必须重载：Nginx 用 sudo nginx -s reload，Apache 用 sudo apachectl graceful

ThinkPHP5 的域名路由只在 route/app.php 中注册才有效，其他地方写的全被忽略：

不能写在 config/route.php 或控制器里；多应用模式下也统一写在 route/app.php
Route::domain('admin.test', [...]) 第二个参数只能是数组或闭包，不能是字符串路径（比如 'admin/index/index' 会报 Invalid route rule）
闭包内必须重新定义该域名下的全部路由，不能依赖外部 Route::rule()；例如 Route::get('user', 'admin.User/read') 要写在闭包里
本地开发时，HTTP_HOST 可能带端口（如 admin.test:8080），所以绑定要写完整，或加判断：if (APP_DEBUG) Route::domain('localhost:8080', [...]);