thinkphp 5 在 apache 下域名绑定无效，90% 是因 documentroot 未指向 public/ 目录或 .htaccess 未生效；需确保 documentroot 为绝对路径（如 /var/www/myapp/public）、启用 mod_rewrite、配置 allowoverride all、hosts 与 virtualhost 的 servername 严格匹配，且 route::domain() 正确写在 route/route.php 中。
ThinkPHP 5 在 Apache 下域名绑定无效，90% 是因为请求根本没进到框架——DocumentRoot 指向了项目根目录而非 public/，或 .htaccess 规则被忽略。不是路由写错了，是 Apache 根本没把请求交给 index.php。
Apache 虚拟主机 DocumentRoot 必须指向 public/ 目录
ThinkPHP 5 的入口文件是 public/index.php，所有请求必须经由它分发。若 DocumentRoot 指向项目根目录（如 /var/www/myapp），Apache 会尝试直接找 /var/www/myapp/index.php，而该文件不存在，结果就是 404 或 500。
-
DocumentRoot值应为绝对路径，末尾不加斜杠，例如：/var/www/myapp/public -
<directory></directory>块中的路径必须与DocumentRoot完全一致，且包含AllowOverride All - Windows 下路径用正斜杠或双反斜杠，避免单反斜杠被转义，例如：
C:/xampp/htdocs/myapp/public - 确认该目录下真实存在
index.php和.htaccess文件
mod_rewrite 必须启用且 .htaccess 生效
ThinkPHP 依赖 .htaccess 中的重写规则将请求转发给 index.php。若 mod_rewrite 未启用，或 AllowOverride 被设为 None，规则就完全失效，静态路径能访问，带路由的地址一律 404。
- 运行
a2enmod rewrite启用模块（Ubuntu/Debian）；Windows XAMPP 用户在httpd.conf中取消#LoadModule rewrite_module modules/mod_rewrite.so的注释 -
<directory></directory>块中必须有AllowOverride All，不能是None或FileInfo - 检查
public/.htaccess是否存在、内容是否为 ThinkPHP 默认规则（含RewriteRule ^(.*)$ index.php [L]类似逻辑） - 重启 Apache：Linux 用
sudo systemctl restart apache2，Windows 用 XAMPP 控制面板重启
hosts + VirtualHost 配置必须严格匹配
本地开发时，浏览器地址栏输的是 http://admin.test，但 Apache 只有在 ServerName 或 ServerAlias 明确声明了 admin.test，且系统 hosts 已解析，请求才会落到对应虚拟主机。缺一不可。
- 修改系统
hosts文件，添加：127.0.0.1 admin.test（Windows 路径：C:\Windows\System32\drivers\etc\hosts；macOS/Linux：/etc/hosts） -
VirtualHost中ServerName必须和浏览器地址栏域名完全一致（admin.test≠www.admin.test），建议同时加ServerAlias www.admin.test - 确保
httpd-vhosts.conf已被主配置加载（httpd.conf中Include conf/extra/httpd-vhosts.conf未被注释） - 刷新 DNS 缓存：
ipconfig /flushdns（Win）或sudo dscacheutil -flushcache（macOS）
ThinkPHP 路由域名绑定本身要写对位置和语法
即使 Apache 配置全对，Route::domain() 写错位置或参数类型，路由也不会注册。它只在 route/route.php（TP5）中生效，且第二个参数必须是闭包或数组，不能是字符串。
- 域名路由必须定义在
route/route.php，不是config/route.php或控制器里 - 正确写法：
Route::domain('admin.test', function() { Route::get('dashboard', 'admin/index/dashboard'); }); - 错误写法：
Route::domain('admin.test', 'admin/index/index')—— 这会直接报Invalid route rule - 本地调试时注意端口：
admin.test:8080和admin.test是两个不同 host，若 Apache 监听 8080 端口，ServerName和路由都得带端口
最易被忽略的一点：Apache 配置改完后没重启，或 DocumentRoot 路径里有中文、空格、符号链接未展开——这些都会导致 AllowOverride All 实际不生效，.htaccess 形同虚设。先确认 curl -I http://admin.test 返回的是 Apache 的 200 还是 403/404，再往下查路由。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
