ThinkPHP部署Apache虚拟主机需四步：一、启用vhost_alias和rewrite模块，包含httpd-vhosts.conf；二、DocumentRoot指向public目录，配置Directory权限；三、hosts绑定tp.local；四、重启Apache并验证。
如果您正在使用ThinkPHP框架开发Web应用，并希望将其部署到Apache服务器上以实现多站点管理，则需要正确配置Apache虚拟主机。以下是针对ThinkPHP项目的Apache虚拟主机配置步骤：
一、启用虚拟主机模块与配置文件包含
Apache必须加载虚拟主机支持模块，并引入独立的虚拟主机配置文件。该操作确保ThinkPHP项目能被单独路由，避免与主站点或其他项目冲突。
1、打开Apache主配置文件httpd.conf（路径通常为/etc/apache2/apache2.conf或conf/httpd.conf）。
2、取消注释以下行，启用虚拟主机模块：LoadModule vhost_alias_module modules/mod_vhost_alias.so。
立即学习“PHP免费学习笔记（深入）”；
3、取消注释以下行，使Apache加载额外的虚拟主机配置：Include conf/extra/httpd-vhosts.conf（Windows环境）或IncludeOptional sites-enabled/*.conf（Debian/Ubuntu系）。
4、保存文件并退出编辑器。
二、创建ThinkPHP项目专属虚拟主机配置
为ThinkPHP项目单独定义<VirtualHost>块，可隔离运行环境、指定入口路径、启用重写规则，并适配其public目录结构。
1、编辑conf/extra/httpd-vhosts.conf（或在sites-available/下新建thinkphp.conf）。
2、添加如下配置（请按实际路径替换/path/to/thinkphp/public和域名）：
<VirtualHost *:80>
ServerName tp.local
DocumentRoot "/path/to/thinkphp/public"
<Directory "/path/to/thinkphp/public">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog "logs/tp.local-error.log"
CustomLog "logs/tp.local-access.log" combined
</VirtualHost>
3、特别注意：ThinkPHP 6+默认入口为public/子目录，DocumentRoot必须指向public目录，而非项目根目录。
三、配置本地域名解析（用于开发测试）
在无真实DNS的情况下，需通过系统hosts文件将自定义域名映射至本地回环地址，使浏览器请求能被Apache捕获。
1、打开系统hosts文件：C:\Windows\System32\drivers\etc\hosts（Windows）或/etc/hosts（Linux/macOS）。
2、在文件末尾新增一行：127.0.0.1 tp.local（与ServerName保持一致）。
3、保存文件（需管理员权限）。
四、启用URL重写支持（适配ThinkPHP路由）
ThinkPHP依赖Apache的mod_rewrite模块实现友好URL（如/index/index/hello），必须确保该模块已启用且.htaccess生效。
1、启用rewrite模块：a2enmod rewrite（Debian/Ubuntu）或取消httpd.conf中#LoadModule rewrite_module modules/mod_rewrite.so前的注释（Windows）。
2、确认AllowOverride All已在虚拟主机<Directory>段中设置（见第二步），否则.htaccess将被忽略。
3、检查ThinkPHP项目public/.htaccess文件是否存在且内容完整（含RewriteEngine On及标准重写规则）。
五、重启Apache服务并验证配置
完成全部配置后，必须重新加载Apache配置以激活新虚拟主机，并验证语法是否正确，防止服务启动失败。
1、执行语法检查命令：apachectl configtest 或 apache2ctl configtest。
2、若输出Syntax OK，则执行重启：sudo systemctl restart apache2（Linux）或httpd -k restart（Windows）。
3、在浏览器中访问http://tp.local，应显示ThinkPHP默认首页或您配置的欢迎页面。
