Skip to content

ThinkDH 文档中心

欢迎使用 ThinkDH 文档中心,这里提供了完整的 ThinkDH 安装文档和开发指南,帮助您快速了解和使用 ThinkDH 系统。

快速开始

系统要求

  • PHP >= 8.2+ (x64架构,开发环境为PHP8.3.29版本)
  • Mysql >= 5.7+ (需支持innodb引擎、开发环境为9.5.0版本)

安装步骤

  1. 下载代码:订阅后联系客服,获取最新版本代码
  2. 配置环境:配置系统所需环境,确保满足系统要求,上传最新代码
  3. 数据库配置:创建数据库,修改 .env 文件中的数据库连接信息
  4. 伪静态配置:Nginx 配置伪静态规则(详见下方 Nginx 配置说明)
  5. 运行目录:将项目运行目录设置为 public
  6. 定时任务配置:配置系统定时任务,确保系统正常运行

首次登录

  • 默认账号:admin
  • 默认密码:123456
  • 登录地址:/tdadmin

Nginx 配置说明

伪静态规则(重要)

ThinkDH 使用 ThinkPHP 6+ 框架,需要配置正确的伪静态规则。

方法一:使用 try_files(推荐)

nginx
location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ \.php$ {
    fastcgi_pass unix:/tmp/php-cgi-83.sock;
    fastcgi_index index.php;
    include fastcgi.conf;
    include pathinfo.conf;
}

方法二:使用 rewrite(传统方式)

nginx
location / {
    if (!-e $request_filename){
        rewrite ^(.*)$ /index.php/$1 last;
    }
}

location ~ \.php$ {
    fastcgi_pass unix:/tmp/php-cgi-83.sock;
    fastcgi_index index.php;
    include fastcgi.conf;
    include pathinfo.conf;
}

注意:

  • rewrite ^(.*)$ /index.php/$1 是 ThinkPHP 6+ 的正确写法
  • 不要使用 rewrite ^(.*)$ /index.php?s=$1(这是 ThinkPHP 5 的写法)

宝塔面板配置

如果你使用宝塔面板,请按以下步骤配置:

  1. 创建站点:添加你的域名,网站目录设置为 /www/wwwroot/demo.thinkdh.com/public
  2. 选择伪静态:在宝塔面板中选择 "ThinkPHP" 伪静态规则
  3. PHP 版本:选择 PHP 8.3
  4. 配置完成:保存配置并重载 Nginx

手动部署

如果你手动部署,请参考以下配置:

nginx
server {
    listen 80;
    server_name demo.thinkdh.com;
    root /www/wwwroot/demo.thinkdh.com/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/tmp/php-cgi-83.sock;
        fastcgi_index index.php;
        include fastcgi.conf;
        include pathinfo.conf;
    }
}

常见问题

问题: 访问接口返回 404

原因: 伪静态规则不正确

解决方法:

  1. 检查伪静态规则是否使用 rewrite ^(.*)$ /index.php/$1
  2. 检查 location ~ \.php 是否在伪静态规则之后
  3. 确认 Nginx 配置已重载:nginx -t && nginx -s reload

定时任务配置

前往后台/系统管理/定时任务,配置系统定时任务,确保系统正常运行。

前后端分离

前端模板开发

ThinkDH 支持模板系统,可以快速定制网站前端页面。

模板目录结构:

template/
├── tdyy/          # 默认模板
│   ├── components/  # 组件文件
│   ├── css/         # 样式文件
│   ├── html/        # 页面文件
│   ├── img/         # 图片文件
│   └── js/          # 脚本文件
└── config.json     # 模板配置文件

模板配置文件

在模板根目录下创建 config.json 文件,定义模板的配置项:

json
{
  "_config": {
    "speaker": {
      "label": "公告设置",
      "description": "公告和下载链接设置",
      "fields": {
        "notice": {
          "label": "公告",
          "type": "textarea",
          "description": "网站公告内容"
        },
        "down": {
          "label": "下载链接",
          "type": "text",
          "description": "应用下载链接"
        }
      }
    },
    "banner": {
      "label": "轮播设置",
      "description": "首页轮播图配置",
      "type": "array",
      "itemFields": {
        "id": {
          "label": "ID",
          "type": "text",
          "description": "轮播图ID"
        },
        "url": {
          "label": "链接",
          "type": "text",
          "description": "轮播图点击链接"
        },
        "img": {
          "label": "图片",
          "type": "image",
          "description": "轮播图图片"
        }
      }
    }
  }
}

模板开发指南

详细的模板开发文档请参考:模板开发文档

技术支持

商业支持

  • 技术咨询:@ckplayer
  • 项目经理:@Boojiboo
  • 购买咨询:@hxcvod

文档版本:1.0
更新日期:2026-02-10
作者:ThinkDH 开发团队