目录

1. 什么是 ThinkPHP 网站源码？
2. 如何获取 ThinkPHP 源码？
   • 使用官方命令行工具 Composer (推荐)
   • 下载官方提供的“空项目”模板
   • 从 GitHub 克隆
3. ThinkPHP 项目源码的核心目录结构解析
4. 一个完整的 ThinkPHP 网站源码示例
   • 功能需求
   • 数据库设计
   • 代码实现步骤
5. 如何修改和扩展 ThinkPHP 源码？
6. 总结与最佳实践

什么是 ThinkPHP 网站源码？

ThinkPHP 网站源码，就是使用 ThinkPHP 框架开发的一个完整网站项目的所有代码文件，它不仅仅是框架本身，更重要的是基于框架的业务逻辑代码。

一个典型的 ThinkPHP 源码包包含：

• ThinkPHP 框架核心文件：这是基础，提供了路由、数据库操作、模板引擎、缓存等所有核心功能。
• 应用目录：这是开发者最常操作的地方，包含了网站的控制器、模型、视图、配置、路由等所有业务相关代码。
• 公共资源：如 CSS、JavaScript、图片、字体文件等。
• 配置文件：定义了数据库连接、缓存方式、应用设置等。
• 入口文件：通常是 public/index.php，是整个网站访问的起点。

核心思想：ThinkPHP 遵循 MVC (Model-View-Controller) 设计模式，这使得代码结构清晰，易于维护。

• Model (模型)：负责与数据库交互，处理数据。
• View (视图)：负责展示数据，即用户看到的 HTML 页面。
• Controller (控制器)：作为 Model 和 View 的桥梁，接收用户请求，调用模型处理数据，并选择合适的视图返回给用户。

如何获取 ThinkPHP 源码？

获取 ThinkPHP 源码主要有三种方式，Composer 是最主流、最推荐 的方式。

使用官方命令行工具 Composer (推荐)

Composer 是 PHP 的依赖管理工具，可以帮你自动下载 ThinkPHP 框架和其所需的扩展库。

1. 安装 Composer：如果你还没有安装 Composer，请先从 getcomposer.org 下载并安装。
2. 创建项目：在你的 Web 服务器根目录（如 htdocs 或 www）下，打开命令行，执行以下命令：

   # 创建一个名为 my-awesome-site 的新项目
   composer create-project topthink/think my-awesome-site

3. 等待安装完成：Composer 会自动下载最新稳定版的 ThinkPHP 框架，并生成一个基础的、可运行的“空项目”结构。

下载官方提供的“空项目”模板

1. 访问 ThinkPHP 官方网站：https://www.thinkphp.cn/
2. 在下载页面找到“空项目”或“基础项目”的下载链接。
3. 下载 ZIP 压缩包，并解压到你的 Web 服务器目录中。

从 GitHub 克隆

如果你熟悉 Git，可以直接从官方仓库克隆最新代码。

# 克隆最新的 8.x 版本
git clone -b 8.0 https://github.com/top-think/think.git my-awesome-site

ThinkPHP 项目源码的核心目录结构解析

以一个典型的 Composer 创建的项目为例，其核心目录结构如下：

my-awesome-site/
├── app/                    # 应用目录，所有业务代码都在这里
│   ├── controller/         # 控制器目录，存放所有控制器文件
│   │   └── Index.php      # 默认的首页控制器
│   ├── model/             # 模型目录，存放所有模型文件
│   │   └── User.php       # 用户模型
│   ├── view/              # 视图目录，存放所有模板文件
│   │   └── index/         # 对应 Index 控制器
│   │       └── index.html # 首页模板
│   └── ...                # 其他应用目录
├── config/                # 配置文件目录
│   ├── app.php            # 应用主配置
│   ├── cache.php          # 缓存配置
│   └── database.php       # 数据库配置
├── public/                # 对外访问目录，Web 服务器需指向此目录
│   ├── static/            # 静态资源 (CSS, JS, Images)
│   ├── router.php         # 路由定义文件 (可选)
│   └── index.php          # 应用入口文件
├── route/                 # 路由定义目录
├── vendor/                # Composer 依赖目录，包含 ThinkPHP 框架和第三方库
├── .env                   # 环境变量配置文件
├── composer.json          # 项目依赖管理文件
└── think                  # 命令行工具入口

关键目录说明：

• public/index.php：整个网站的唯一入口，所有请求都会先经过这个文件。
• app/：开发者的主战场，你写的所有业务逻辑代码都在这个目录及其子目录下。
• config/：存放各种配置文件，如数据库连接、应用调试模式等。
• vendor/：不要手动修改此目录下的任何文件，它是通过 Composer 自动管理的。

一个完整的 ThinkPHP 网站源码示例

让我们来创建一个简单的“文章管理系统”来演示 ThinkPHP 源码是如何组织的。

功能需求

1. 首页 ()：显示文章列表。
2. 文章详情页 (/article/{id})：显示单篇文章的详细内容。

数据库设计

创建一个数据库,然后执行以下 SQL 语句创建 articles 表：

CREATE TABLE `articles` (
  `id` int(11) NOT NULL AUTO_INCREMENT, varchar(255) NOT NULL COMMENT '文章标题',
  `content` text NOT NULL COMMENT '文章内容',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

代码实现步骤

步骤 1：配置数据库

打开 config/database.php 文件，修改你的数据库连接信息：

// config/database.php
return [
    // 默认使用的数据库连接配置
    'default'         => env('database.driver', 'mysql'),
    // 自定义时间查询规则
    'time_query_rule' => [],
    // 自动写入时间戳字段
    'auto_timestamp'  => true,
    // 时间字段取出后的默认时间格式
    'datetime_format' => 'Y-m-d H:i:s',
    // 数据库连接配置信息
    'connections'     => [
        'mysql' => [
            // 数据库类型
            'type'              => env('database.type', 'mysql'),
            // 服务器地址
            'hostname'          => env('database.hostname', '127.0.0.1'),
            // 数据库名
            'database'          => env('database.database', 'your_database_name'),
            // 用户名
            'username'          => env('database.username', 'your_username'),
            // 密码
            'password'          => env('database.password', 'your_password'),
            // 端口
            'hostport'          => env('database.hostport', '3306'),
            // 数据库连接参数
            'params'            => [],
            // 数据库编码默认采用utf8
            'charset'           => env('database.charset', 'utf8mb4'),
            // 数据库表前缀
            'prefix'            => env('database.prefix', ''),
            // 数据库部署方式:0 集中式(单一服务器),1 分布式(主从服务器)
            'deploy'            => 0,
            // 数据库读写是否分离 主从式有效
            'rw_separate'       => false,
            // 读写分离后 主服务器数量
            'master_num'        => 1,
            // 指定从服务器序号
            'slave_no'          => '',
            // 是否严格检查字段是否存在
            'fields_strict'     => true,
            // 是否需要断线重连
            'break_reconnect'   => false