当前位置：首页 > news >正文

【小白专用24.5.30已验证】Composer安装php框架thinkPHP6的安装教程

news 2026/2/8 10:14:53

一、框架介绍

1、框架简介和版本选择
Thinkphp是一种基于php的开源web应用程序开发框架ThinkPHP框架，是免费开源的、轻量级的、简单快速且敏捷的php框架。你可以免费使用TP框架，甚至可以将你的项目商用；
ThinkPHP8.0 是目前框架正式版的最新版本，本教程采用的是最常用且稳定的TP6.0版本。
ThinkPHP6.0 环境要求 PHP 版本是 7.2.5+以上，不支持5.1的无缝升级。

此处本人使用的是Apache24来部署web服务：【开启thinkPHP6安装前，请安装php,Apache24】

【小白专用24.5.26已验证】windows 11 安装PHP8.3 +Apache2.4_win11下如何安装win+apache+php环境-CSDN博客

二、安装步骤

2.1下载composer

Composer是一个PHP的依赖管理工具，可以用于管理项目中的PHP库和包的依赖关系。它可以帮助开发人员轻松地安装、更新和卸载项目所需的各种依赖库。Composer还可以自动解决依赖冲突问题，并且可以根据项目需要自动加载所需的库文件。使用Composer可以更好地组织和管理PHP项目的代码和依赖关系。

TP6.0版本开始，必须通过Composer方式进行安装和更新，所以你无法通过Git下载安装。

下载网

Composer (getcomposer.org)

下载步骤如下

下载完成之后双击安装程序进行安装

查看composer是否安装

测试是否安装成功打开命令提示符按win+r键，然后输入cmd就可以打开，再输入composer，回车出现下面的提示就成功了

确定composer安装好：

2.2安装 ThinkPHP6

现在，先启用服务器环境，测试本地 Web 环境是否正常【本人使用的是Apache24来部署web服务】；

在php.ini文件中启用了相应的扩展。找到php.ini文件，然后找到这2行，确保前面没有分号（;）注释符号，不然安装过程会出现问题（在文章末尾已展示出来）；

extension=fileinfo
extension=zip
extension=gd

1.如果你是第一次安装的话，在命令行下面，切换到你的WEB根目录下面：

windows的cmd

切换磁盘盘符
C:\>d:

【技巧】

2.切换到指定目录，执行下载Thinkphp6命令。然后等待下载完成就可以了，文件下载与网速相关，慢的需要等一会。（安装的路径可以提前换到自己需要安装的路径，后面最后的 tp6，这个名字可以根据自己的需要自己取，是新建个 tp6 目录，可改名，这个目录就是我们后面会经常提到的应用根目录。

composer create-project topthink/think tp6

create-project: 是composer中的项目创建命令
topthink/think: ThinkPHP的组件包
tp6: 是当前的项目目录(如果没有创建, 该命令会自动创建的)，执行过程的截图如下所示

7.cd到tp6，然后输入:php think run即可运行成功

查看当前安装的tp6版本
cd到tp6，然后输入:php think version即可运行成功

4. 浏览器访问测试是否部署成功

启动成功后，我们在浏览器中输入127.0.0.1:8081/tp6/public/查看即可，出现正常的thinkphp访问界面为成功！恭喜你，现在已经完成ThinkPHP6.0的安装！下图说明tp6部署成功，如此，ThinkPHP6.0 已经帮我们将域名自动部署到 public 里了。接下来就可以配置框架的文件了。

【本次使用的是Apache24来部署web服务，将网站访问目录改为tp6下面的public目录，就可以通过http://localhost:8081直接访问啦！】

如果 80 端口没有被占用的情况下，使用如下命令直接访问 http://localhost；

如果想修改端口的话使用命令php think run -p 端口号。

三、安装成功后目录结构

6.0 版本目录结构的主要变化是核心框架纳入vendor目录，然后原来的application目录变成app目录。
安装后的目录结构就是一个单应用模式

www WEB部署目录（或者子目录）
├─app 应用目录
│ ├─controller 控制器目录
│ ├─model 模型目录
│ ├─view 视图目录
│ ├─ ... 更多类库目录
│ │
│ ├─BaseController.php 默认基础控制器类
│ ├─ExceptionHandle.php 应用异常定义文件
│ ├─common.php 全局公共函数文件
│ ├─middleware.php 全局中间件定义文件
│ ├─provider.php 服务提供定义文件
│ ├─Request.php 应用请求对象
│ └─event.php 全局事件定义文件
│
├─config 配置目录
│ ├─app.php 应用配置
│ ├─cache.php 缓存配置
│ ├─console.php 控制台配置
│ ├─cookie.php Cookie配置
│ ├─database.php 数据库配置
│ ├─filesystem.php 文件磁盘配置
│ ├─lang.php 多语言配置
│ ├─log.php 日志配置
│ ├─middleware.php 中间件配置
│ ├─route.php URL和路由配置
│ ├─session.php Session配置
│ ├─trace.php Trace配置
│ └─view.php 视图配置
│
├─view 视图目录
├─route 路由定义目录
│ ├─route.php 路由定义文件
│ └─ ...
│
├─public WEB目录（对外访问目录）
│ ├─index.php 入口文件
│ ├─router.php 快速测试文件
│ └─.htaccess 用于apache的重写
│
├─extend 扩展类库目录
├─runtime 应用的运行时目录（可写，可定制）
├─vendor Composer类库目录
├─.example.env 环境变量示例文件
├─composer.json composer 定义文件
├─LICENSE.txt 授权说明文件
├─README.md README 文件
└─think 命令行入口文件

ThinkPHP6 核心目录`vendor`目录

四、视图安装

视图功能由\think\View类配合视图驱动（也即模板引擎驱动）类一起完成，新版仅内置了PHP原生模板引擎（主要用于内置的异常页面输出），如果需要使用其它的模板引擎需要单独安装相应的模板引擎扩展。如果需要使用thinkTemplate模板引擎，需要安装think-view扩展（该扩展会自动安装think-template依赖库）

该扩展跟tp6安装多应用扩展一样，需要安装think-template（命令：composer require topthink/think-view），切记一定要在项目根目录进行安装！

【小白专用已验证24.5.31】ThinkPHP6 视图的安装及模板篇之传参和渲染-CSDN博客

五、模板渲染和变量赋值

在安装好think-view后，我们就可以使用控制器来将不同的请求转到不同的视图了，并且可以传递一些参数过去。比如在原有的index.php控制器中，修改对应的一些方法，然后返回不同的视图，(最常用的是 view::fetch() view::assign() )。

【小白专用已验证24.5.31】ThinkPHP6 视图的安装及模板篇之传参和渲染-CSDN博客

安装和更新命令所在的目录是不同的，更新必须在你的应用根目录下面执行，更新Thinkphp6核心，必须先切换到 tp6 根目录

update topthink/framework

更新操作会删除thinkphp目录重新下载安装新版本，但不会影响app目录，因此不要在核心框架目录添加任何应用代码和类库。

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

【小白专用24.5.26已验证】windows 11 安装PHP8.3 +Apache2.4_win11下如何安装win+apache+php环境-CSDN博客

【小白专用24.5.26 已验证】VSCode下载和安装与配置PHP开发环境（详细版）-CSDN博客

安装过程遇到问题

报错解释：

这个错误表明你在使用Composer（PHP的依赖管理工具）尝试安装ThinkPHP6框架时，下载topthink/think包失败了。原因是ZIP扩展没有启用。Composer在安装依赖时可以使用ZIP扩展来解压缩包，如果ZIP扩展没有启用，则无法解压缩下载的文件。

解决方法：
在Windows上，你需要确保在php.ini文件中启用了相应的扩展。
找到php.ini文件，然后找到extension=zip这一行，确保前面没有分号（;）注释符号。
修改完php.ini后，重启你的Web服务器，如Apache或Nginx，以使更改生效。
再次运行Composer安装命令，如composer create-project topthink/think your_project_name，以检查问题是否已解决。