ThinkPHPCRM系统开发教程

ThinkPHP 本身并不是那种开箱即用的 CRM 系统，它更像是搭建定制化 CRM 的脚手架。你想用 TP6 快速起步？核心步骤就这几步：`composer create-project`、配数据库、`php think run`，但实际卡点多在 PDO 扩展、时区和重写规则上。

ThinkPHP 从来不是一套装好就能用的 CRM 系统，而是一个 PHP 框架。所谓的「ThinkPHP CRM 教程」，本质上是在教你怎么用 ThinkPHP 去搭一套量身定制的 CRM 应用——没有现成的模板，一切从数据库设计、路由规划、权限控制开始。

怎么快速启动一个 ThinkPHP CRM 项目（以 TP6 为例）

别从零开始写控制器和模型了，直接用官方命令行工具初始化骨架，效率高得多：

• composer create-project topthink/think crm-system
• 进目录后执行 php think migrate:run（前提是你已经配好了迁移文件）或者手动导入 SQL 表结构
• 确认 config/database.php 里的 hostname、database、username、password 都正确，而且 MySQL 用户有对应库的读写权限
• 运行 php think run 启动内置服务器，访问 http://127.0.0.1:8000，看看能不能看到 ThinkPHP 默认欢迎页

这里有几个容易翻车的点：pdo_mysql 扩展没启用（PHP 8.0+ 默认不带这个扩展）、timezone 没在 php.ini 里设置会导致时间字段报错、public/index.php 被直接访问但没配 Web 服务器重写规则（Apache 需要 .htaccess，Nginx 得手动加 try_files）。

客户表设计与 Model 定义的关键细节

CRM 的核心当然是客户数据，但要是直接建一张 customers 表就想搞定一切，那可就太天真了。真实业务场景里，至少得拆成下面这几张：

• customers：存公司级信息（名称、行业、规模、主联系人 ID）
• contacts：存自然人信息（姓名、职位、手机、邮箱、所属客户 ID）
• follow_records：记录每次跟进（内容、类型、负责人 ID、关联客户/联系人 ID）

在 app/model/Customer.php 里定义关联时，千万别漏掉 protected $autoWriteTimestamp = true;，不然 created_at 和 updated_at 不会自动填充。查询的时候用 with('contacts.followRecords') 可以一次加载嵌套关系，但小心 N+1 问题——如果你的列表页只显示客户名和最近一次跟进时间，那最好用子查询或者 join 来优化，而不是无脑 with 一把梭。

FastAdmin 集成后权限失效或菜单不显示

不少教程推荐用 FastAdmin 加速后台开发，但它和原生 ThinkPHP 的权限机制之间，其实存在一些兼容性雷区。典型症状是：登录后左侧菜单一片空白，或者点击按钮提示「无权限」。

• 检查 application/admin/config.php 里的 'admin_url' => '/admin' 是否和你实际访问路径一致（比如部署在子目录 /crm/admin，那这里就得同步改成 '/crm/admin'）
• auth_rule 表里每条规则的 type 字段必须是 menu 或 file，不能为空；status 必须为 1
• 用户角色（auth_group_access）绑定后，记得清空 runtime/cache/ 下的权限缓存，或者临时把 config/auth.php 里的 'check_all' => false 改为 true 来排查
• FastAdmin 的 JS 菜单渲染依赖 admin.js 中的 $.getJSON 请求返回的 JSON 结构，如果后端接口返回了 HTML 或者 500 错误，前端就会静默失败，菜单自然出不来

导出 Excel 时中文乱码或内存溢出

用 PHPExcel（TP3/5）或 PhpSpreadsheet（TP6 推荐）导出客户列表，最容易在以下两个地方栽跟头：

• 导出前没设置字符集：$spreadsheet->getActiveSheet()->getDefaultStyle()->getFont()->setName('Arial Unicode MS');，或者更稳妥的做法是用 iconv('UTF-8', 'GB2312//IGNORE', $str) 转换字段值（这个仅限 Windows 环境）
• 一次性查出所有客户再导出——当客户数超过 5000 条时，PHP 的内存很容易爆掉。正确的做法是改用游标分批：Customer::chunk(500, function ($customers) use ($spreadsheet) { ... });
• 导出响应头必须写完整：header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'); 加上 header('Content-Disposition: attachment;filename="customers_'.date('Ymd').'.xlsx"');

真正上了生产环境，导出动作最好转成异步任务（比如用 think-queue），这样既能避免请求超时，也能防止用户反复刷新导致重复导出。

CRM 本质上不是堆功能，而是想清楚「谁在什么场景下需要看到什么数据」。ThinkPHP 给你的是骨架和工具链，但具体字段要不要加「客户来源渠道」、跟进记录是否强制填「下次联系时间」、销售阶段变更要不要触发邮件通知——这些决策比代码本身更重要，也最容易被人忽略。