ThinkPHP怎样配置Apache虚拟主机_Apache虚拟主机配置【实战】

胖芳姑娘_6629

胖芳姑娘_6629

2026-05-20

469人浏览

原创

thinkphp部署apache虚拟主机需四步:一、启用vhost_alias和rewrite模块,包含httpd-vhosts.conf;二、documentroot指向public目录,配置directory权限;三、hosts绑定tp.local;四、重启apache并验证。

thinkphp怎样配置apache虚拟主机_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。

3、取消注释以下行,使Apache加载额外的虚拟主机配置:Include conf/extra/httpd-vhosts.conf(Windows环境)或IncludeOptional sites-enabled/*.conf(Debian/Ubuntu系)。

4、保存文件并退出编辑器。

二、创建ThinkPHP项目专属虚拟主机配置

为ThinkPHP项目单独定义<virtualhost></virtualhost>块,可隔离运行环境、指定入口路径、启用重写规则,并适配其public目录结构。

1、编辑conf/extra/httpd-vhosts.conf(或在sites-available/下新建thinkphp.conf)。

2、添加如下配置(请按实际路径替换/path/to/thinkphp/public和域名):


ServerName tp.local
DocumentRoot "/path/to/thinkphp/public"
thinkphp/public">
  Options Indexes FollowSymLinks
  AllowOverride All
  Require all granted

ErrorLog "logs/tp.local-error.log"
CustomLog "logs/tp.local-access.log" combined

3、特别注意:ThinkPHP 6+默认入口为public/子目录,DocumentRoot必须指向public目录,而非项目根目录。

三、配置本地域名解析(用于开发测试)

在无真实DNS的情况下,需通过系统hosts文件将自定义域名映射至本地回环地址,使浏览器请求能被Apache捕获。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

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></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默认首页或您配置的欢迎页面。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9584

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5761

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2055

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3608

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4294

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3351

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4777

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3742

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11762

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习