简介一套基于 PHP 开发的功能齐全 CRM 客户管理系统旗舰版源码面向中小企业管理者、销售团队及二次开发人员用于统一管理客户资料、销售、采购、库存与售后全流程。源码无加密、无域名限制可导入数据库后直接安装便于根据实际业务修改字段或扩展功能。系统覆盖线索、客户、商机、合同、财务、销售、采购、库存、产品、营销等模块内置自定义字段、高级筛选、审批流程、进销存管理以及报价单、应收款、出库单等联动功能有助于自动化跟进客户并减少人员变动带来的客户流失。资源包为 ZIP 压缩格式大小约 12.3MB虽然资源库未单独标出文件总数与类型明细但解压后即可获得完整可部署的 PHP 源码与安装相关文件。目前已有 1058 人学习下载适合需要快速搭建客户管理平台或基于成熟源码进行定制开发的团队。1. 这套“旗舰版”源码买之前先想清楚一个问题打开搜索页输入“CRM系统旗舰版 源码”出来的下载包一个比一个全客户管理、商机跟进、合同回款、报表统计、角色权限……功能列表能拉出二十几项。但真正把代码下下来、本地一跑很多人第一反应是“这跟我想要的东西不是一回事”。因为这个标题背后其实藏着两类完全不同的诉求一类是拿源码当成品用解压、配库、访问后台就开始录客户另一类是拿源码当半成品改在现有模块上做二次开发把业务流程嵌进去。选哪条路决定了你怎么看待“功能齐全”这四个字。我见过太多团队栽在同一个坑上以为功能多就等于好用结果部署完发现数据表结构绑死了业务模式改一个字段要动五六张关联表。与其说这是购买决策不如说是一个选型判断——你是需要一个能立即跑起来的私有化工具还是需要一套能看懂、能下刀子的代码基底。搞清楚这个问题后面的部署、改造、踩坑才有意义。本文就按“拆结构 → 本地跑通 → 二次开发 → 避坑”这条线把这类 PHP MySQL 架构的 CRM 源码包讲透。2. 先拆结构功能齐全的 CRM 源码到底由哪几块拼出来的2.1 技术栈画像为什么市面上这类源码大多是 PHP MySQL“旗舰版”听起来唬人但翻开源码你会发现绝大多数流通的 CRM 系统源码还是 PHP MySQL 的组合偶尔有 Java 或 Python 版本比例很小。原因很直接PHP 部署门槛低虚拟主机能跑PHPStudy、XAMPP 一键起环境源码丢进htdocs就能装MySQL 则是配套最成熟的数据库导出导入、备份迁移都有现成工具。对卖家来说这套组合交付成本最低对买家来说改起来也最不挑人。如果你拿到的是 Java 版源码比如 Spring Boot Vue 那种部署链路会明显变长——要先装 JDK、Maven再打包、配 Tomcat 或打成 jar 跑前端还要 Node 环境编一次。不是不能做而是对只想内部用的小团队来说投入产出比不划算。所以我的建议是先看你手里的包是什么语言PHP 系就直接往下走Java 系先确认团队有没有 Java 维护能力别等部署到一半再换路。源码目录结构通常长这样crm/ ├── admin/ # 后台管理入口 ├── api/ # 对外接口或移动端接口 ├── application/ # 业务逻辑控制器、模型、视图 ├── config/ # 数据库、缓存、日志配置 ├── static/ # 前端静态资源CSS、JS、图片 ├── uploads/ # 附件上传目录 ├── index.php # 入口文件 └── install/ # 安装引导程序这套结构和 ThinkPHP 的经典布局基本一致。看目录就能判断一件事业务代码全在application下配置集中在config下安装程序独立放在install——这意味着如果你要改业务主要战场就是application而config改完基本就是环境相关的调整。2.2 客户管理主链路线索、客户、商机、合同、回款的数据流转功能再多的 CRM核心链路永远是那一条线索 → 客户 → 商机 → 合同 → 回款。所谓“功能齐全”本质上就是把这条链路上的每个环节都做成了独立模块再配上统计报表和权限控制。看源码时先别急着看页面先打开数据库把这几张核心表的关系理清整个系统就懂了一半。用 SQL 看表结构是最直接的-- 查看所有表名 SHOW TABLES; -- 查看客户表的字段定义 DESC crm_customer; -- 查看跟进记录表的字段定义 DESC crm_follow_log;常见的表设计是crm_customer存客户主体信息crm_contact存联系人一个客户多个联系人crm_follow_log存每次跟进记录crm_business存商机crm_contract存合同crm_receivables存回款。每张表都带create_time、update_time、owner_id负责人这是 CRM 系统的通用约定——记录谁创建的、谁更新的、归属谁。理清这些你就知道改一个“客户详情页”要动哪些表了。2.3 “功能齐全”的边界哪些模块是刚需哪些只是充门面拿到的功能列表再长拆开了也就四类模块类别典型功能判断标准核心业务客户、联系、商机、合同、回款没有这些就不叫 CRM协同工具任务、日程、附件、审批有最好没有也能用统计决策销售漏斗、业绩排行、客户分析看报表 SQL 是不是拼在页面里系统管理用户、角色、权限、操作日志权限必须细到按钮级才算齐拿到源码后先不要急着部署打开数据库导出文件通常是install目录下的crm.sql搜几个关键词auth_group、auth_rule、operation_log。能搜到auth_rule说明做了基于角色的权限控制这是“旗舰版”的底线配置搜不到那“角色权限”大概率只是页面上的摆设。这个判断比看功能列表可靠得多因为很多源码包在功能列表里写满了实际到数据库层就露馅。3. 本地跑通最小系统从压缩包到能登录后台的全过程3.1 环境版本怎么选PHP 版本和 MySQL 版本要卡死别用最新先把环境钉死。这类源码大多是三四年前写的那时候的主流是 PHP 7.x、MySQL 5.7。如果你一上来装 PHP 8.2 MySQL 8.0大概率跑不起来——PHP 8 删掉了一批老函数比如mysql_real_escape_string这种MySQL 8 的认证插件变了老代码连接数据库会直接报Authentication plugin caching_sha2_password错误。我一般用的是这套组合PHP 7.4.x # 兼容性与安全性的平衡点老代码基本都能跑 MySQL 5.7.x # 认证插件仍是 mysql_native_password老源码兼容性最好 Apache 2.4 # 比 Nginx 省事.htaccess 直接生效Windows 上直接用 PHPStudy 一键切换版本装完把 PHP 版本选到 7.4MySQL 选到 5.7再创建网站、指定站点目录指向源码的htdocs路径。Linux 上用apt或yum装对应版本即可关键是别用最新。3.2 导入数据库先建库再导 SQL顺序不能反大部分源码包会在install目录放一个.sql文件或者在安装向导里让你填数据库信息后自动建表。我习惯手工操作因为这样能看到建表过程有没有报错——自动安装经常把错误吞掉等登录后台才发现缺表。# 进入 MySQL 命令行 mysql -u root -p # 创建数据库字符集必须和源码一致一般是 utf8mb4 CREATE DATABASE IF NOT EXISTS crm_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 退出后导入 SQL 文件 mysql -u root -p crm_db /path/to/crm.sql导入后验证一下USE crm_db; SHOW TABLES; -- 正常应该看到二十到三十张表如果表数量为 0说明导入失败了 SELECT COUNT(*) FROM crm_user; -- 如果能查出初始管理员账号说明数据导入成功这一步有个高频坑.sql文件里如果写了CREATE DATABASE语句而你手工建的库名跟它不一致导入时会把表建到别的库里。所以导入前先用文本编辑器打开.sql文件的前 50 行看一遍确认有没有USE或CREATE DATABASE有的话改掉或者直接用文件里的库名。3.3 改数据库配置重点改三处别只改数据库密码源码连接数据库的配置基本都在config/database.php里ThinkPHP 系或者application/config.php里形式大同小异。改的时候只动三样数据库地址、库名、密码。注意有的源码把数据库配置写在config/config.php里的一个数组里还有的写成.env文件优先搜DB_HOST、DB_NAME、DB_PWD这几个关键词。// config/database.php 典型配置 return [ type mysql, // 数据库类型保持不动 host 127.0.0.1, // 本地部署就用 127.0.0.1 database crm_db, // 改成你建的库名 username root, // MySQL 用户名 password your_password,// MySQL 密码改成你自己的 charset utf8mb4, // 必须和建库时的字符集一致 prefix crm_, // 表前缀建表 SQL 里带的前缀 ];改完先不急着开网页先用 PHP 命令行验证一下数据库能不能连通# 写一个临时探测文件 echo ?php var_dump(new PDO(mysql:host127.0.0.1;dbnamecrm_db, root, your_password)); test_db.php php test_db.php能打印出PDO对象就说明连通不能就检查密码或端口。这一步能帮你把“数据库问题”和“程序问题”隔离开省得后面白屏了到处猜。3.4 启动验证从入口文件到后台登录的完整链路数据库通了接下来开启 Apache浏览器访问http://localhost/或者http://localhost/crm/。如果源码带安装向导会跳到install页面如果没带直接跳登录页。默认管理员账号通常是admin密码可能在crm.sql里的crm_user表里能查到也可能写在README里。查一下SELECT username, password FROM crm_user LIMIT 5;密码字段如果是md5加密的初始密码常见是admin123或123456。如果是password_hash函数生成的长字符串那就用默认密码登录后进后台改。登录成功后做三件事进“系统设置”改管理员密码、确认时区是不是Asia/Shanghai、检查“操作日志”模块有没有自动记录——操作日志能记上说明核心链路没断。4. 把源码变成你自己的系统三块最常改的业务代码4.1 客户列表加筛选项看清“列表查询”是在哪里拼 SQL 的典型需求客户列表默认只能按名称和手机号搜索你想加上“按客户来源筛选”。先找客户列表对应的控制器和模型文件通常叫Customer.php或crm/Customer.php。打开控制器里的index方法搜索where会看到搜索条件是这样拼的// 原代码只支持关键词搜索 $where []; if (!empty($keyword)) { $where[name|phone] [like, % . $keyword . %]; }改成支持来源筛选// 改造后增加 source 筛选 $where []; if (!empty($keyword)) { $where[name|phone] [like, % . $keyword . %]; } if (!empty($source)) { $where[source] $source; // source 是客户来源字段值为数组时是 IN 查询 }改完前端模板页在搜索栏加一个下拉框name设为source选项是几个固定来源展会、官网、转介绍、广告。这里有个关键点$where[source] $source如果$source是数组ThinkPHP 会自动转成IN查询但如果你传的是字符串就是等值匹配——两种行为差异很大调试时先var_dump($where)看拼出来的是什么。4.2 角色权限改造从“只挡按钮”到“接口级别强制校验”价格便宜的源码权限往往只做了前端控制——按钮用if (in_array(customer_add, $perms))包了一下但接口本身没校验。也就是说会抓包的人直接请求添加客户的 URL就能绕过按钮限制写数据。这是这类源码包里最普遍的隐患。改造思路是把按钮级判断下沉到控制器的入口做统一校验// 基类 BaseController 里的统一校验方法 protected function checkPerm($rule) { $user session(user_info); // 获取当前用户角色对应的权限规则auth_rule 表 $rules $this-getUserRules($user[role_id]); if (!in_array($rule, $rules)) { // 直接抛异常前端会收到统一错误码 throw new \Exception(无权限访问, 403); } } // 在添加客户的方法里第一行调用 public function add() { $this-checkPerm(customer/add); // 这个字符串要与 auth_rule 表里的规则对应 // 后续业务逻辑 }改完之后用普通账号试一下直接访问index.php?mAdmincCustomeraadd应该返回 403 而不是弹出添加表单。到这一步权限才真正从“界面隐藏”变成“数据保护”。4.3 报表慢查询销售漏斗页卡死的常见原因“销售漏斗”页面上线后越来越慢打开调试工具发现有个 SQL 跑了 3 秒多。这种报表页的通病是直接用框架的whereIn循环查询或者对关联表不加索引。先看执行日志找到最慢的 SQL[ SQL ] SELECT * FROM crm_business WHERE customer_id IN (SELECT customer_id FROM crm_follow_log GROUP BY customer_id HAVING COUNT(*) 10) [ RunTime: 3.241s ]这个 SQL 的问题在于子查询没有索引可以利用。解决方式分两步先加索引再用JOIN重写-- 第一步给外键字段加索引 ALTER TABLE crm_business ADD INDEX idx_customer_id (customer_id); ALTER TABLE crm_follow_log ADD INDEX idx_customer_id (customer_id); -- 第二步用 JOIN 替代 IN 子查询如果业务逻辑允许 SELECT b.* FROM crm_business b INNER JOIN ( SELECT customer_id, COUNT(*) AS cnt FROM crm_follow_log GROUP BY customer_id HAVING cnt 10 ) f ON b.customer_id f.customer_id;加了索引后同样的查询一般能压到 100ms 以内。如果你改完索引还是慢翻一下EXPLAIN的结果确认type列是ref而不是ALL——ALL就是全表扫描索引没生效。5. 常见问题排查五个让新人翻车的现场5.1 后台登录直接白屏没有任何报错现象数据库配好了访问后台首页白屏浏览器控制台 500。原因PHP 7.4 下老代码报错被屏蔽页面只显示空白。最常见的触发点是控制器里用了 PHP 7.2 以后废弃的each()函数或create_function()。解决先把 PHP 报错打开。在项目入口文件index.php第一行加ini_set(display_errors, 1); error_reporting(E_ALL);刷新页面看具体报错在哪一行然后对应把each改成foreachcreate_function改成匿名函数。改完两处基本就能进后台。5.2 安装向导走到第三步就卡住提示“数据库连接失败”现象填完数据库信息点下一步报连接失败但用命令行验证是通的。原因安装向导里对数据库密码做了转义处理如果你的密码包含#、$、这类特殊字符在组装连接串时被截断或转义。解决临时把 MySQL 密码改成简单密码比如root123安装完成后再改回原密码同时在数据库配置文件里同步更新。别在安装向导阶段跟特殊字符较劲那是浪费时间。5.3 客户上传头像或附件提示“文件上传失败”现象上传 2MB 的图片报失败但 100KB 的小图能成功。原因PHP 的upload_max_filesize默认只有 2MBpost_max_size默认 8MB超过就静默失败。解决修改php.ini里的三个值upload_max_filesize 20M post_max_size 25M max_file_uploads 20改完重启 Apache 或 PHP-FPM进后台的“系统设置”里看“上传限制”有没有同步更新——有的源码会在设置页缓存这个值需要重新保存一次。注意post_max_size要比upload_max_filesize大因为整个表单数据都算 POST 大小。5.4 报表统计的金额总是差几分钱或者日期对不上现象合同金额按月份汇总结果 1 月份的数据跑到 12 月去了。原因数据库时区和 PHP 时区不一致。PHP 默认时区如果是UTC生成的create_time会差 8 个小时跨天记录就落到前一天或后一天。解决在config下找到时间配置在database.php或app.php里强制指定// ThinkPHP 或类似框架的配置 default_timezone Asia/Shanghai, // MySQL 连接时也指定时区 database [ timezone 08:00, ],改完再重新生成一条跟进记录到数据库里SELECT create_time FROM crm_follow_log ORDER BY id DESC LIMIT 1;核对时间。如果还差 8 小时去 MySQL 里执行SET GLOBAL time_zone 08:00;并写入my.ini的[mysqld]段。5.5 邮件群发模块发不出去报“SMTP 连接超时”现象后台配置了 SMTP 参数测试发送时一直转圈最后报连接超时。原因绝大多数是服务器 25 端口被封尤其是国内云主机。解决把 SMTP 端口从 25 改成 465 或 587同时把加密方式从TLS改成SSL。改完再去“系统设置 邮件测试”里发一封。还有一种情况是 SMTP 服务器地址填成smtp.qq.com但后台端口还是默认 25——改两个地方一个是端口一个是加密方式别只改一个。如果用的是企业邮局还要确认有没有开“客户端授权码”很多邮局 2019 年后只允许用授权码登录 SMTP明文密码直接被拒。6. 把源码从“能跑”变成“能扛”一份客户导入模板的实战改造很多团队最终放弃这类源码不是因为跑不起来而是因为日常录入成本太高——几百条 Excel 客户数据要人肉一条条敲进去。与其去翻有没有现成的导入插件不如自己写一个简易导入脚本把 Excel 转成数组再批量写入数据库顺便还能做重复数据拦截。这个脚本既是给老系统续命也是理解这套源码数据结构的最后一道练习题。// 放在 application 下的一个控制器方法里或者独立 CLI 脚本 public function importCustomer() { $file request()-file(excel); // 用 PHPExcel 或 PhpSpreadsheet 读取推荐后者PHP 7.4 兼容性没问题 $spreadsheet \PhpOffice\PhpSpreadsheet\IOFactory::load($file-getPathname()); $rows $spreadsheet-getActiveSheet()-toArray(); $db Db::name(customer); $total 0; $duplicate 0; foreach ($rows as $i $row) { if ($i 0) continue; // 跳过表头 $name trim($row[0]); $phone trim($row[1]); if (empty($name) || empty($phone)) continue; // 按手机号去重这是最常用的业务约束 $exists $db-where(phone, $phone)-find(); if ($exists) { $duplicate; continue; } $db-insert([ name $name, phone $phone, source excel_import, create_time time(), owner_id session(user_id), ]); $total; } // 返回结果 echo 导入成功{$total} 条跳过重复{$duplicate} 条; }说明几个关键点skip表头是常识但很多新手会忘了卡表头最后把“姓名”也插进去按手机号去重最靠谱按姓名去重会误伤同名客户create_time用的是time()而不是date()因为框架底层会统一处理格式owner_id必须传当前用户的 ID不然导入的客户全成了“无主数据”列表里谁都看不到。这个脚本跑通后可以把 Excel 模板固定成一个标准格式第一列姓名、第二列手机号、第三列备注让销售按模板填就行。我吃过一次亏当时导入时没做去重三个月后导出客户列表发现同一家公司出现七条记录跟进记录散落各处销售之间互相抢客户。后来老老实实加了手机号唯一索引才把数据洗干净。所以这类源码系统数据入口的管控比功能多少更值得花时间——入口干净后面所有报表才有意义。如果你准备入手这类“功能齐全”的源码包建议先把上面第 2 章的表结构理清再跑第 3 章的部署流程重点看第 5 章那几个坑基本能避免大部分翻车现场。希望帮到你。本文还有配套的精品资源点击获取
CRM系统旗舰版源码实战：PHP+MySQL部署与二次开发避坑指南
简介一套基于 PHP 开发的功能齐全 CRM 客户管理系统旗舰版源码面向中小企业管理者、销售团队及二次开发人员用于统一管理客户资料、销售、采购、库存与售后全流程。源码无加密、无域名限制可导入数据库后直接安装便于根据实际业务修改字段或扩展功能。系统覆盖线索、客户、商机、合同、财务、销售、采购、库存、产品、营销等模块内置自定义字段、高级筛选、审批流程、进销存管理以及报价单、应收款、出库单等联动功能有助于自动化跟进客户并减少人员变动带来的客户流失。资源包为 ZIP 压缩格式大小约 12.3MB虽然资源库未单独标出文件总数与类型明细但解压后即可获得完整可部署的 PHP 源码与安装相关文件。目前已有 1058 人学习下载适合需要快速搭建客户管理平台或基于成熟源码进行定制开发的团队。1. 这套“旗舰版”源码买之前先想清楚一个问题打开搜索页输入“CRM系统旗舰版 源码”出来的下载包一个比一个全客户管理、商机跟进、合同回款、报表统计、角色权限……功能列表能拉出二十几项。但真正把代码下下来、本地一跑很多人第一反应是“这跟我想要的东西不是一回事”。因为这个标题背后其实藏着两类完全不同的诉求一类是拿源码当成品用解压、配库、访问后台就开始录客户另一类是拿源码当半成品改在现有模块上做二次开发把业务流程嵌进去。选哪条路决定了你怎么看待“功能齐全”这四个字。我见过太多团队栽在同一个坑上以为功能多就等于好用结果部署完发现数据表结构绑死了业务模式改一个字段要动五六张关联表。与其说这是购买决策不如说是一个选型判断——你是需要一个能立即跑起来的私有化工具还是需要一套能看懂、能下刀子的代码基底。搞清楚这个问题后面的部署、改造、踩坑才有意义。本文就按“拆结构 → 本地跑通 → 二次开发 → 避坑”这条线把这类 PHP MySQL 架构的 CRM 源码包讲透。2. 先拆结构功能齐全的 CRM 源码到底由哪几块拼出来的2.1 技术栈画像为什么市面上这类源码大多是 PHP MySQL“旗舰版”听起来唬人但翻开源码你会发现绝大多数流通的 CRM 系统源码还是 PHP MySQL 的组合偶尔有 Java 或 Python 版本比例很小。原因很直接PHP 部署门槛低虚拟主机能跑PHPStudy、XAMPP 一键起环境源码丢进htdocs就能装MySQL 则是配套最成熟的数据库导出导入、备份迁移都有现成工具。对卖家来说这套组合交付成本最低对买家来说改起来也最不挑人。如果你拿到的是 Java 版源码比如 Spring Boot Vue 那种部署链路会明显变长——要先装 JDK、Maven再打包、配 Tomcat 或打成 jar 跑前端还要 Node 环境编一次。不是不能做而是对只想内部用的小团队来说投入产出比不划算。所以我的建议是先看你手里的包是什么语言PHP 系就直接往下走Java 系先确认团队有没有 Java 维护能力别等部署到一半再换路。源码目录结构通常长这样crm/ ├── admin/ # 后台管理入口 ├── api/ # 对外接口或移动端接口 ├── application/ # 业务逻辑控制器、模型、视图 ├── config/ # 数据库、缓存、日志配置 ├── static/ # 前端静态资源CSS、JS、图片 ├── uploads/ # 附件上传目录 ├── index.php # 入口文件 └── install/ # 安装引导程序这套结构和 ThinkPHP 的经典布局基本一致。看目录就能判断一件事业务代码全在application下配置集中在config下安装程序独立放在install——这意味着如果你要改业务主要战场就是application而config改完基本就是环境相关的调整。2.2 客户管理主链路线索、客户、商机、合同、回款的数据流转功能再多的 CRM核心链路永远是那一条线索 → 客户 → 商机 → 合同 → 回款。所谓“功能齐全”本质上就是把这条链路上的每个环节都做成了独立模块再配上统计报表和权限控制。看源码时先别急着看页面先打开数据库把这几张核心表的关系理清整个系统就懂了一半。用 SQL 看表结构是最直接的-- 查看所有表名 SHOW TABLES; -- 查看客户表的字段定义 DESC crm_customer; -- 查看跟进记录表的字段定义 DESC crm_follow_log;常见的表设计是crm_customer存客户主体信息crm_contact存联系人一个客户多个联系人crm_follow_log存每次跟进记录crm_business存商机crm_contract存合同crm_receivables存回款。每张表都带create_time、update_time、owner_id负责人这是 CRM 系统的通用约定——记录谁创建的、谁更新的、归属谁。理清这些你就知道改一个“客户详情页”要动哪些表了。2.3 “功能齐全”的边界哪些模块是刚需哪些只是充门面拿到的功能列表再长拆开了也就四类模块类别典型功能判断标准核心业务客户、联系、商机、合同、回款没有这些就不叫 CRM协同工具任务、日程、附件、审批有最好没有也能用统计决策销售漏斗、业绩排行、客户分析看报表 SQL 是不是拼在页面里系统管理用户、角色、权限、操作日志权限必须细到按钮级才算齐拿到源码后先不要急着部署打开数据库导出文件通常是install目录下的crm.sql搜几个关键词auth_group、auth_rule、operation_log。能搜到auth_rule说明做了基于角色的权限控制这是“旗舰版”的底线配置搜不到那“角色权限”大概率只是页面上的摆设。这个判断比看功能列表可靠得多因为很多源码包在功能列表里写满了实际到数据库层就露馅。3. 本地跑通最小系统从压缩包到能登录后台的全过程3.1 环境版本怎么选PHP 版本和 MySQL 版本要卡死别用最新先把环境钉死。这类源码大多是三四年前写的那时候的主流是 PHP 7.x、MySQL 5.7。如果你一上来装 PHP 8.2 MySQL 8.0大概率跑不起来——PHP 8 删掉了一批老函数比如mysql_real_escape_string这种MySQL 8 的认证插件变了老代码连接数据库会直接报Authentication plugin caching_sha2_password错误。我一般用的是这套组合PHP 7.4.x # 兼容性与安全性的平衡点老代码基本都能跑 MySQL 5.7.x # 认证插件仍是 mysql_native_password老源码兼容性最好 Apache 2.4 # 比 Nginx 省事.htaccess 直接生效Windows 上直接用 PHPStudy 一键切换版本装完把 PHP 版本选到 7.4MySQL 选到 5.7再创建网站、指定站点目录指向源码的htdocs路径。Linux 上用apt或yum装对应版本即可关键是别用最新。3.2 导入数据库先建库再导 SQL顺序不能反大部分源码包会在install目录放一个.sql文件或者在安装向导里让你填数据库信息后自动建表。我习惯手工操作因为这样能看到建表过程有没有报错——自动安装经常把错误吞掉等登录后台才发现缺表。# 进入 MySQL 命令行 mysql -u root -p # 创建数据库字符集必须和源码一致一般是 utf8mb4 CREATE DATABASE IF NOT EXISTS crm_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 退出后导入 SQL 文件 mysql -u root -p crm_db /path/to/crm.sql导入后验证一下USE crm_db; SHOW TABLES; -- 正常应该看到二十到三十张表如果表数量为 0说明导入失败了 SELECT COUNT(*) FROM crm_user; -- 如果能查出初始管理员账号说明数据导入成功这一步有个高频坑.sql文件里如果写了CREATE DATABASE语句而你手工建的库名跟它不一致导入时会把表建到别的库里。所以导入前先用文本编辑器打开.sql文件的前 50 行看一遍确认有没有USE或CREATE DATABASE有的话改掉或者直接用文件里的库名。3.3 改数据库配置重点改三处别只改数据库密码源码连接数据库的配置基本都在config/database.php里ThinkPHP 系或者application/config.php里形式大同小异。改的时候只动三样数据库地址、库名、密码。注意有的源码把数据库配置写在config/config.php里的一个数组里还有的写成.env文件优先搜DB_HOST、DB_NAME、DB_PWD这几个关键词。// config/database.php 典型配置 return [ type mysql, // 数据库类型保持不动 host 127.0.0.1, // 本地部署就用 127.0.0.1 database crm_db, // 改成你建的库名 username root, // MySQL 用户名 password your_password,// MySQL 密码改成你自己的 charset utf8mb4, // 必须和建库时的字符集一致 prefix crm_, // 表前缀建表 SQL 里带的前缀 ];改完先不急着开网页先用 PHP 命令行验证一下数据库能不能连通# 写一个临时探测文件 echo ?php var_dump(new PDO(mysql:host127.0.0.1;dbnamecrm_db, root, your_password)); test_db.php php test_db.php能打印出PDO对象就说明连通不能就检查密码或端口。这一步能帮你把“数据库问题”和“程序问题”隔离开省得后面白屏了到处猜。3.4 启动验证从入口文件到后台登录的完整链路数据库通了接下来开启 Apache浏览器访问http://localhost/或者http://localhost/crm/。如果源码带安装向导会跳到install页面如果没带直接跳登录页。默认管理员账号通常是admin密码可能在crm.sql里的crm_user表里能查到也可能写在README里。查一下SELECT username, password FROM crm_user LIMIT 5;密码字段如果是md5加密的初始密码常见是admin123或123456。如果是password_hash函数生成的长字符串那就用默认密码登录后进后台改。登录成功后做三件事进“系统设置”改管理员密码、确认时区是不是Asia/Shanghai、检查“操作日志”模块有没有自动记录——操作日志能记上说明核心链路没断。4. 把源码变成你自己的系统三块最常改的业务代码4.1 客户列表加筛选项看清“列表查询”是在哪里拼 SQL 的典型需求客户列表默认只能按名称和手机号搜索你想加上“按客户来源筛选”。先找客户列表对应的控制器和模型文件通常叫Customer.php或crm/Customer.php。打开控制器里的index方法搜索where会看到搜索条件是这样拼的// 原代码只支持关键词搜索 $where []; if (!empty($keyword)) { $where[name|phone] [like, % . $keyword . %]; }改成支持来源筛选// 改造后增加 source 筛选 $where []; if (!empty($keyword)) { $where[name|phone] [like, % . $keyword . %]; } if (!empty($source)) { $where[source] $source; // source 是客户来源字段值为数组时是 IN 查询 }改完前端模板页在搜索栏加一个下拉框name设为source选项是几个固定来源展会、官网、转介绍、广告。这里有个关键点$where[source] $source如果$source是数组ThinkPHP 会自动转成IN查询但如果你传的是字符串就是等值匹配——两种行为差异很大调试时先var_dump($where)看拼出来的是什么。4.2 角色权限改造从“只挡按钮”到“接口级别强制校验”价格便宜的源码权限往往只做了前端控制——按钮用if (in_array(customer_add, $perms))包了一下但接口本身没校验。也就是说会抓包的人直接请求添加客户的 URL就能绕过按钮限制写数据。这是这类源码包里最普遍的隐患。改造思路是把按钮级判断下沉到控制器的入口做统一校验// 基类 BaseController 里的统一校验方法 protected function checkPerm($rule) { $user session(user_info); // 获取当前用户角色对应的权限规则auth_rule 表 $rules $this-getUserRules($user[role_id]); if (!in_array($rule, $rules)) { // 直接抛异常前端会收到统一错误码 throw new \Exception(无权限访问, 403); } } // 在添加客户的方法里第一行调用 public function add() { $this-checkPerm(customer/add); // 这个字符串要与 auth_rule 表里的规则对应 // 后续业务逻辑 }改完之后用普通账号试一下直接访问index.php?mAdmincCustomeraadd应该返回 403 而不是弹出添加表单。到这一步权限才真正从“界面隐藏”变成“数据保护”。4.3 报表慢查询销售漏斗页卡死的常见原因“销售漏斗”页面上线后越来越慢打开调试工具发现有个 SQL 跑了 3 秒多。这种报表页的通病是直接用框架的whereIn循环查询或者对关联表不加索引。先看执行日志找到最慢的 SQL[ SQL ] SELECT * FROM crm_business WHERE customer_id IN (SELECT customer_id FROM crm_follow_log GROUP BY customer_id HAVING COUNT(*) 10) [ RunTime: 3.241s ]这个 SQL 的问题在于子查询没有索引可以利用。解决方式分两步先加索引再用JOIN重写-- 第一步给外键字段加索引 ALTER TABLE crm_business ADD INDEX idx_customer_id (customer_id); ALTER TABLE crm_follow_log ADD INDEX idx_customer_id (customer_id); -- 第二步用 JOIN 替代 IN 子查询如果业务逻辑允许 SELECT b.* FROM crm_business b INNER JOIN ( SELECT customer_id, COUNT(*) AS cnt FROM crm_follow_log GROUP BY customer_id HAVING cnt 10 ) f ON b.customer_id f.customer_id;加了索引后同样的查询一般能压到 100ms 以内。如果你改完索引还是慢翻一下EXPLAIN的结果确认type列是ref而不是ALL——ALL就是全表扫描索引没生效。5. 常见问题排查五个让新人翻车的现场5.1 后台登录直接白屏没有任何报错现象数据库配好了访问后台首页白屏浏览器控制台 500。原因PHP 7.4 下老代码报错被屏蔽页面只显示空白。最常见的触发点是控制器里用了 PHP 7.2 以后废弃的each()函数或create_function()。解决先把 PHP 报错打开。在项目入口文件index.php第一行加ini_set(display_errors, 1); error_reporting(E_ALL);刷新页面看具体报错在哪一行然后对应把each改成foreachcreate_function改成匿名函数。改完两处基本就能进后台。5.2 安装向导走到第三步就卡住提示“数据库连接失败”现象填完数据库信息点下一步报连接失败但用命令行验证是通的。原因安装向导里对数据库密码做了转义处理如果你的密码包含#、$、这类特殊字符在组装连接串时被截断或转义。解决临时把 MySQL 密码改成简单密码比如root123安装完成后再改回原密码同时在数据库配置文件里同步更新。别在安装向导阶段跟特殊字符较劲那是浪费时间。5.3 客户上传头像或附件提示“文件上传失败”现象上传 2MB 的图片报失败但 100KB 的小图能成功。原因PHP 的upload_max_filesize默认只有 2MBpost_max_size默认 8MB超过就静默失败。解决修改php.ini里的三个值upload_max_filesize 20M post_max_size 25M max_file_uploads 20改完重启 Apache 或 PHP-FPM进后台的“系统设置”里看“上传限制”有没有同步更新——有的源码会在设置页缓存这个值需要重新保存一次。注意post_max_size要比upload_max_filesize大因为整个表单数据都算 POST 大小。5.4 报表统计的金额总是差几分钱或者日期对不上现象合同金额按月份汇总结果 1 月份的数据跑到 12 月去了。原因数据库时区和 PHP 时区不一致。PHP 默认时区如果是UTC生成的create_time会差 8 个小时跨天记录就落到前一天或后一天。解决在config下找到时间配置在database.php或app.php里强制指定// ThinkPHP 或类似框架的配置 default_timezone Asia/Shanghai, // MySQL 连接时也指定时区 database [ timezone 08:00, ],改完再重新生成一条跟进记录到数据库里SELECT create_time FROM crm_follow_log ORDER BY id DESC LIMIT 1;核对时间。如果还差 8 小时去 MySQL 里执行SET GLOBAL time_zone 08:00;并写入my.ini的[mysqld]段。5.5 邮件群发模块发不出去报“SMTP 连接超时”现象后台配置了 SMTP 参数测试发送时一直转圈最后报连接超时。原因绝大多数是服务器 25 端口被封尤其是国内云主机。解决把 SMTP 端口从 25 改成 465 或 587同时把加密方式从TLS改成SSL。改完再去“系统设置 邮件测试”里发一封。还有一种情况是 SMTP 服务器地址填成smtp.qq.com但后台端口还是默认 25——改两个地方一个是端口一个是加密方式别只改一个。如果用的是企业邮局还要确认有没有开“客户端授权码”很多邮局 2019 年后只允许用授权码登录 SMTP明文密码直接被拒。6. 把源码从“能跑”变成“能扛”一份客户导入模板的实战改造很多团队最终放弃这类源码不是因为跑不起来而是因为日常录入成本太高——几百条 Excel 客户数据要人肉一条条敲进去。与其去翻有没有现成的导入插件不如自己写一个简易导入脚本把 Excel 转成数组再批量写入数据库顺便还能做重复数据拦截。这个脚本既是给老系统续命也是理解这套源码数据结构的最后一道练习题。// 放在 application 下的一个控制器方法里或者独立 CLI 脚本 public function importCustomer() { $file request()-file(excel); // 用 PHPExcel 或 PhpSpreadsheet 读取推荐后者PHP 7.4 兼容性没问题 $spreadsheet \PhpOffice\PhpSpreadsheet\IOFactory::load($file-getPathname()); $rows $spreadsheet-getActiveSheet()-toArray(); $db Db::name(customer); $total 0; $duplicate 0; foreach ($rows as $i $row) { if ($i 0) continue; // 跳过表头 $name trim($row[0]); $phone trim($row[1]); if (empty($name) || empty($phone)) continue; // 按手机号去重这是最常用的业务约束 $exists $db-where(phone, $phone)-find(); if ($exists) { $duplicate; continue; } $db-insert([ name $name, phone $phone, source excel_import, create_time time(), owner_id session(user_id), ]); $total; } // 返回结果 echo 导入成功{$total} 条跳过重复{$duplicate} 条; }说明几个关键点skip表头是常识但很多新手会忘了卡表头最后把“姓名”也插进去按手机号去重最靠谱按姓名去重会误伤同名客户create_time用的是time()而不是date()因为框架底层会统一处理格式owner_id必须传当前用户的 ID不然导入的客户全成了“无主数据”列表里谁都看不到。这个脚本跑通后可以把 Excel 模板固定成一个标准格式第一列姓名、第二列手机号、第三列备注让销售按模板填就行。我吃过一次亏当时导入时没做去重三个月后导出客户列表发现同一家公司出现七条记录跟进记录散落各处销售之间互相抢客户。后来老老实实加了手机号唯一索引才把数据洗干净。所以这类源码系统数据入口的管控比功能多少更值得花时间——入口干净后面所有报表才有意义。如果你准备入手这类“功能齐全”的源码包建议先把上面第 2 章的表结构理清再跑第 3 章的部署流程重点看第 5 章那几个坑基本能避免大部分翻车现场。希望帮到你。本文还有配套的精品资源点击获取
