如何在XAMPP环境下搭建ThinkPHP 6.0框架项目

在本地电脑上用XAMPP来运行ThinkPHP 6.0项目，是很多PHP初学者接触框架的第一步。XAMPP已经集成了Apache、MySQL和PHP运行环境，我们只需要做好少量配置，再通过Composer安装框架即可。

一、准备XAMPP环境

首先确保你已经在电脑上安装并启动了XAMPP，打开控制面板启动Apache和MySQL服务。ThinkPHP 6.0要求PHP版本不低于7.1，XAMPP新版自带的PHP通常满足要求。

检查PHP扩展

ThinkPHP 6.0运行需要以下PHP扩展：PDO、MBstring、OpenSSL、XML、CURL等。在XAMPP中，可以编辑php.ini文件，去掉前面分号启用对应扩展，然后重启Apache。

; 示例：确保以下扩展未被注释
extension=pdo_mysql
extension=mbstring
extension=openssl
extension=xml
extension=curl

二、安装Composer

ThinkPHP 6.0使用Composer管理依赖，如果还没有安装Composer，需要先从官网下载安装包。安装完成后，在命令行输入以下命令确认：

composer -V

三、创建ThinkPHP 6.0项目

进入XAMPP的htdocs目录，使用Composer命令创建项目：

cd C:xampphtdocs
composer create-project topthink/think tp6demo

命令执行完后，会在htdocs下生成tp6demo文件夹，这就是你的ThinkPHP 6.0项目。

本地直接访问

如果不配置虚拟主机，也可以暂时通过以下地址访问：

http://127.0.0.1/tp6demo/public/

四、配置Apache虚拟主机（推荐）

为了让URL更简洁，建议配置虚拟主机。打开XAMPP中Apache的httpd-vhosts.conf文件，添加如下配置：

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/tp6demo/public"
    ServerName tp6.local
    <Directory "C:/xampp/htdocs/tp6demo/public">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

然后在系统hosts文件中加入一行：

127.0.0.1 tp6.local

重启Apache后，浏览器访问 http://tp6.local 即可看到ThinkPHP 6.0的欢迎页面。

五、常见问题

• 页面报500错误：一般是public目录权限或.htaccess重写问题，确认Apache开启了mod_rewrite。
• Composer下载慢：可配置国内镜像，例如执行 composer config -g repos.packagist composer https://mirrors.ipipp.com/composer/ 。
• 数据库连接失败：检查MySQL服务是否启动，以及项目中的database.php配置是否正确。

提示：开发完成后，不要把XAMPP的htdocs整个目录直接上线，应该只部署ThinkPHP项目的必要文件和public目录。

按照上面的步骤，你就能在XAMPP环境下顺利搭建并运行ThinkPHP 6.0框架项目，开始本地开发工作了。

XAMPPThinkPHP_6.0PHP框架修改时间：2026-07-26 05:15:18