Appearance
ThinkDH 文档中心
欢迎使用 ThinkDH 文档中心,这里提供了完整的 ThinkDH 安装文档和开发指南,帮助您快速了解和使用 ThinkDH 系统。
快速开始
系统要求
PHP >= 8.2+(x64架构,开发环境为PHP8.3.29版本)Mysql >= 5.7+(需支持innodb引擎、开发环境为9.5.0版本)
安装步骤
- 下载代码:订阅后联系客服,获取最新版本代码
- 配置环境:配置系统所需环境,确保满足系统要求,上传最新代码
- 数据库配置:创建数据库,修改
.env文件中的数据库连接信息 - 伪静态配置:Nginx 配置伪静态规则(详见下方 Nginx 配置说明)
- 运行目录:将项目运行目录设置为
public - 定时任务配置:配置系统定时任务,确保系统正常运行
首次登录
- 默认账号: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 的写法)
宝塔面板配置
如果你使用宝塔面板,请按以下步骤配置:
- 创建站点:添加你的域名,网站目录设置为
/www/wwwroot/demo.thinkdh.com/public - 选择伪静态:在宝塔面板中选择 "ThinkPHP" 伪静态规则
- PHP 版本:选择 PHP 8.3
- 配置完成:保存配置并重载 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
原因: 伪静态规则不正确
解决方法:
- 检查伪静态规则是否使用
rewrite ^(.*)$ /index.php/$1 - 检查
location ~ \.php是否在伪静态规则之后 - 确认 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 开发团队