ThinkPHP本身不是开箱即用的CRM系统，而是用于搭建定制化CRM应用的PHP框架；快速启动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 表远远不够。真实场景中至少要拆成：
立即学习“PHP免费学习笔记（深入）”；
-
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就得同步改） -
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 给你的是骨架和工具链，具体字段要不要加「客户来源渠道」、跟进记录是否强制填「下次联系时间」、销售阶段变更是否触发邮件通知——这些决策比代码更重要，也更容易被跳过。
