ThinkCMF建站教程：ThinkPHP开源CMS安装指南

ThinkCMF是一款基于ThinkPHP框架开发的国产开源内容管理系统，以MIT协议开源，可免费商用。ThinkCMF采用现代化的MVC架构，代码结构清晰，易于二次开发，内置强大的内容管理、用户管理、权限管理、插件机制、模板引擎等功能。ThinkCMF适合开发者快速搭建企业官网、资讯门户、社区论坛、电商平台等各类网站，是PHP开发者喜爱的CMS框架。

核心优势：基于ThinkPHP框架（国内最流行的PHP框架）、代码规范易维护、强大的RBAC权限管理、插件扩展机制、模板引擎、RESTful API、多应用支持、Composer管理、完全免费商用。ThinkCMF特别适合有PHP开发基础的用户，可快速进行功能定制和二次开发。

环境要求

• Web服务器：Nginx / Apache
• PHP版本：PHP 7.4 ~ 8.3（ThinkCMF 6.x推荐PHP 8.0+）
• 数据库：MySQL 5.6+ 或 MariaDB 10.1+
• 内存：最低512MB，推荐1GB以上
• 磁盘：至少500MB可用空间
• PHP扩展：pdo、pdo_mysql、mbstring、json、curl、gd、xml、zip、opcache
• Composer：用于依赖管理（推荐）

安装教程

方式一：Composer安装（推荐）

cd /www/wwwroot
composer create-project thinkcmf/thinkcmf yourdomain.com
cd yourdomain.com

方式二：下载安装包

cd /www/wwwroot/yourdomain.com
wget https://www.thinkcmf.com/download/thinkcmf_6.0.zip
unzip thinkcmf_6.0.zip
rm -f thinkcmf_6.0.zip

步骤3：创建数据库

mysql -u root -p
CREATE DATABASE thinkcmf DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'thinkcmf_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON thinkcmf.* TO 'thinkcmf_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

步骤4：配置文件权限

chown -R www:www /www/wwwroot/yourdomain.com
chmod -R 755 /www/wwwroot/yourdomain.com
chmod -R 777 /www/wwwroot/yourdomain.com/data
chmod -R 777 /www/wwwroot/yourdomain.com/public/upload
chmod 666 /www/wwwroot/yourdomain.com/data/config/database.php 2>/dev/null || true

步骤5：Nginx配置

ThinkCMF的网站根目录为public目录：

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    root /www/wwwroot/yourdomain.com/public;
    index index.php index.html;

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

    location ~ \.php$ {
        fastcgi_pass unix:/tmp/php-cgi-82.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
        expires 30d;
        add_header Cache-Control "public, immutable";
    }

    location ~ /\.ht {
        deny all;
    }
}

步骤6：运行安装向导

浏览器访问 http://yourdomain.com，自动进入安装页面：

1. 阅读安装协议，点击”同意协议”
2. 环境检测页面，确认所有检测项通过（PHP版本、扩展、目录权限等）
3. 填写数据库配置：
   • 数据库类型：mysql
   • 数据库主机：localhost
   • 数据库端口：3306
   • 数据库名：thinkcmf
   • 数据库用户名：thinkcmf_user
   • 数据库密码：你的密码
   • 表前缀：cmf_（默认即可）
   • 字符集：utf8mb4
4. 填写管理员信息：
   • 管理员账号：admin
   • 管理员密码：设置强密码
   • 管理员邮箱：你的邮箱
5. 点击”开始安装”，等待安装完成

步骤7：登录后台

安装完成后，访问 http://yourdomain.com/admin 登录后台。ThinkCMF后台功能包括：内容管理、分类管理、页面管理、用户管理、权限管理、插件管理、模板管理、数据备份、系统设置等。

Windows环境安装（phpStudy集成环境）

对于Windows用户，推荐使用phpStudy或XAMPP集成环境快速搭建：

1. 下载安装phpStudy（https://www.xp.cn）或XAMPP（https://www.apachefriends.org）
2. 启动集成环境，开启Apache/Nginx和MySQL服务
3. 将程序源码解压到网站根目录（phpStudy默认是WWW目录，XAMPP默认是htdocs目录）
4. 打开phpMyAdmin创建数据库（访问http://localhost/phpmyadmin）
5. 浏览器访问http://localhost，按照安装向导完成安装

注意：Windows环境仅推荐用于本地开发和测试，生产环境建议使用Linux服务器。

宝塔面板安装（推荐）

宝塔面板是国内最流行的服务器管理面板，支持一键部署PHP环境和网站：

1. 安装宝塔面板：CentOS执行yum install -y wget && wget -O install.sh https://download.bt.cn/install/install_6.0.sh && sh install.sh，Ubuntu/Debian执行wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
2. 安装完成后，登录宝塔面板（地址和账号密码在安装完成后显示）
3. 首次登录提示安装LNMP/LAMP环境，选择Nginx + MySQL + PHP，点击一键安装
4. 点击”网站” → “添加站点”，填写域名、选择PHP版本、创建数据库
5. 将程序源码上传到网站根目录（/www/wwwroot/你的域名）
6. 设置目录权限：在文件管理器中选中网站目录，权限设置为755，所有者为www
7. 浏览器访问域名，按照安装向导完成安装

宝塔面板优势：可视化操作、一键环境配置、方便管理数据库和文件、内置SSL证书部署、适合新手和非技术用户。

服务器配置建议

• PHP内存限制：memory_limit = 256M
• 上传文件大小：upload_max_filesize = 64M，post_max_size = 64M
• 最大执行时间：max_execution_time = 120
• 启用OPcache，设置opcache.memory_consumption=128
• 配置Redis缓存（需安装Redis扩展）
• 开启路由伪静态（后台 → 设置 → 路由设置）
• 定期使用composer update更新核心和依赖
• 定期备份数据库和data目录
• 生产环境关闭调试模式（.env中APP_DEBUG=false）

常见问题

Q：安装时提示”data目录不可写”？
A：执行chmod -R 777 data和chmod -R 777 public/upload，确保目录所有者为www用户。

Q：访问网站显示500错误？
A：检查PHP版本是否符合要求，检查runtime目录是否可写，查看data/log目录下的错误日志定位问题。

Q：开启伪静态后页面404？
A：确认Nginx配置中包含rewrite规则：if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; }

Q：忘记管理员密码怎么办？
A：数据库执行：UPDATE cmf_user SET user_pass=MD5('新密码') WHERE id=1;（cmf_替换为你的表前缀）

Q：ThinkCMF可以商用吗？
A：可以。ThinkCMF基于MIT协议开源，完全免费商用，无需授权。

官方网址

官方网站：https://www.thinkcmf.com

下载地址：https://www.thinkcmf.com/download.html

官方文档：https://www.thinkcmf.com/docs/

应用市场：https://www.thinkcmf.com/app/

GitHub：https://github.com/thinkcmf/thinkcmf

社区论坛：https://bbs.thinkcmf.com