Apache配置虚拟主机需三步：修改hosts添加127.0.0.1 www.tp5.com；在httpd.conf中取消Include conf/extra/httpd-vhosts.conf注释；在httpd-vhosts.conf中添加指向public目录的VirtualHost块，路径须一致且用正斜杠。
Apache下配置hosts + httpd-vhosts.conf绑定域名
本地开发用 www.tp5.com 这类域名，本质是绕过DNS、让浏览器把请求发给本机Apache，再由虚拟主机规则把路径映射到项目 public/ 目录。不配这两步，直接访问 localhost/tp5/public 会路由错乱、静态资源404、CSRF token失效——因为ThinkPHP5默认以域名根为URL基准。
操作分三步，缺一不可：
- 编辑系统
C:\Windows\System32\drivers\etc\hosts（Windows）或/etc/hosts（macOS/Linux），末尾追加一行：127.0.0.1 www.tp5.com - 打开Apache主配置文件（如
D:\PHPHOME\Apache24\conf\httpd.conf），取消注释第505行左右的：Include conf/extra/httpd-vhosts.conf - 编辑
httpd-vhosts.conf，在文件末尾添加完整虚拟主机块：<VirtualHost *:80> DocumentRoot "D:/PHPHOME/www/tp5/public" ServerName www.tp5.com <Directory "D:/PHPHOME/www/tp5/public"> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> </VirtualHost>注意路径分隔符统一用正斜杠/，DocumentRoot和<Directory>的路径必须完全一致且指向public/，不是项目根目录
WAMP/XAMPP用户改用wampserver托盘菜单快速配置
WAMP用户不用手动改配置文件，容易因路径错误或权限问题导致Apache启动失败。WAMP托盘菜单里有可视化入口，比手写 httpd-vhosts.conf 更稳。
步骤很直接：
立即学习“PHP免费学习笔记（深入）”；
- 右键WAMP托盘图标 → “Add a Virtual Host…”
- 填入域名（如
myproject.local），路径选到你项目的public/子目录（例如C:/wamp64/www/MyProject/public） - 点OK后，WAMP会自动修改
hosts和httpd-vhosts.conf，并重启服务 - 浏览器访问
http://myproject.local，如果看到ThinkPHP5欢迎页，说明成功；若报错，先检查WAMP右下角图标是否为绿色（代表全部服务运行中）
常见错误：访问域名返回403 Forbidden或500 Internal Server Error
这类错误90%不是代码问题，而是Apache没真正读到你的配置，或路径权限卡住了。
排查优先级如下：
-
DocumentRoot路径含中文、空格或使用反斜杠\→ 改成纯英文路径+正斜杠/ - Apache未加载
rewrite_module→ 在httpd.conf中确认LoadModule rewrite_module modules/mod_rewrite.so前面没加# -
AllowOverride All被忽略 → 检查同一<Directory>块外层是否有更高优先级的<Directory "/">配置，其AllowOverride设成了None - Windows下Apache服务以SYSTEM账户运行，但
public/目录继承了用户权限 → 右键目录 → 属性 → 安全 → 给Everyone或SYSTEM添加“读取和执行”权限
Nginx下绑定域名要额外处理SCRIPT_FILENAME
Apache用户习惯用 DocumentRoot 指向 public/ 就完事，但Nginx不同：它不自动设置 SCRIPT_FILENAME 环境变量，而ThinkPHP5依赖这个变量定位入口文件。漏掉这步，页面空白或报 PHP Fatal error: require(): Failed opening required。
关键配置只有两行，必须加在 location ~ \.php$ 块里：
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params;
同时确保 root 指令也指向 public/ 目录，例如：root /var/www/myapp/public;。如果 root 写在 server 块外、或被嵌套 location 覆盖，$document_root 就会变成空值。
多应用或子目录部署时，root 和 SCRIPT_FILENAME 的路径一致性最容易被忽略——它们必须严格对齐，差一个字符都会让框架找不到 index.php。
