简介这是一套面向中小企业的旗舰版客户关系管理CRM系统源码覆盖市场、销售、采购、库存、售后全流程适合需要统一管理客户资料、实现业务自动化的企业管理者与二次开发人员。资源包共1905个文件、约11.92MB以PHP后端逻辑、HTML页面、JavaScript交互和CSS样式为主另含SQL数据库脚本、配置文件与图片素材导入数据库即可安装且无加密、无域名限制。源码内置线索、客户、商机、合同、财务、销售、采购、库存、产品、审批、任务、日程、知识、日志、站内信、营销等模块支持自定义字段、客户共享与转移、线索池回收、进销存联动、收付款与发票管理、出库单审核等完整业务闭环也包含报价单转合同、合同自动生成应收款及回款计划提醒等实用功能。目前已有384人学习下载适合直接部署或基于旗舰版能力进行二次扩展。1. 客户管理系统源码到手后先确认这三件事再动手做中小企业CRM落地的人十有八九遇到过这种场面下载一个标着“旗舰版”的客户管理系统源码解压出来一堆文件夹装上却连登录页都进不去或者跑起来发现线索、合同、进销存各玩各的根本不是一个闭环。这份源码包我在本地完整跑过一遍核心卖点其实不在“十大模块”这种宣传词而在于线索、客户、商机、合同、应收款、出库单是串成一条线的——合同审核通过自动生成应收款和出库单商机状态自动转成功客户自动锁定这才是它和网上那些免费版拉开差距的地方。适合谁有两类人一是公司要自建CRM、有销售团队也有库存管理需求的运维或技术负责人二是接外包项目、需要一套能快速改字段做二开的PHP源码的开发者。动手之前先把环境兼容性、数据库字符集、目录权限这三件事确认了后面能省很多事。2. 模块拆解与业务闭环线索、客户、商机、合同是怎么串成一条线的2.1 十大模块的数据主线先理清主从表关系再碰代码摘要里写的是“十大模块和五小模块”听起来很唬人但剥开看真正的主线就一条线索 → 客户 → 商机 → 合同 → 应收款/出库单。其它像任务、日程、知识、日志、站内信这些都是挂靠在业务对象上的辅助数据。以这套源码的常见PHP数据表结构为例线索表lead是源头里面至少会有公司名、联系人、电话、来源渠道、领取人ID、领取时间、线索状态这几个核心字段。线索转成客户时按“常见做法是字段映射复制”的逻辑把线索里的公司名、联系人、电话直接带入客户表customer再补上客户等级、行业、来源、地址这些客户维度信息。客户转商机同样如此商机表business会引用客户ID同时记录商机金额、预计成交时间、所处的销售阶段。-- 示意线索转客户时的关键字段映射 SELECT lead.id AS lead_id, lead.company_name AS customer_name, lead.contact AS customer_contact, lead.phone AS customer_phone, lead.source AS customer_source FROM lead WHERE lead.id #{lead_id};这段SQL的逻辑是转客户不是整套记录搬过去而是把线索表里有业务价值的基础字段取出来作为客户表的初始数据。参数上要注意source的来源枚举值不同版本源码里“线上推广”“转介绍”“电话咨询”的存储编码不一样如果后续自定义字段里有“来源细分”映射关系要在转换脚本里写完整否则转过去之后再想追溯线索来源就得翻日志。商机表的阶段字段值得一提这套源码在“合同创建成功商机状态自动转变为成功客户自动锁定”这个需求里实际是商机阶段stage和商机状态status两个字段配合stage记录“初步接触”“需求确认”“方案报价”“商务谈判”这样的销售阶段status才是“进行中/成功/失败”。很多二开的人只改了stage没动status导致列表页商机看起来状态没变。2.2 线索池回收机制限时限额领取的配置口径线索池是这套源码里值得先研究的机制。摘要里写得很清楚员工限时限额领取线索规定时间内线索没有利用就会自动进入线索池。这个功能对销售团队的意义在于防止有人领了线索躺在手里不跟。// 示意线索池定时回收任务的判定逻辑 if ($lead[status] 0 $lead[receive_time] time() - $config[pool_recycle_hours] * 3600) { // 超时未跟进释放回线索池 $lead[owner_id] 0; $lead[receive_time] null; $lead[status] 0; }这段逻辑的核心是三个参数status表示线索是否已被领取0为未领取receive_time是领取时间戳pool_recycle_hours是设定的回收时限。我一般会把回收时限设置成24小时再配合一个“跟进记录数小于1即回收”的条件单纯判断领取时间太粗暴——销售领了线索当天就写了跟进备注但没改状态24小时后被回收容易引起纠纷。“限额”这部分一般在后台配置里常见做法是按角色设置每人每天可领取的线索上限。这里有个容易忽略的点限额要区分“领取”和“转化”有些销售用多个账号领线索或者领了不建档当私域存着。源码里在“线索池”页面的筛选逻辑通常会过滤掉已关联客户的重复公司名上线前最好把“同公司名线索去重”这个配置打开。2.3 自定义字段的开放模型加字段前先回答三个问题自定义字段是这个系统的开放模型卖点。摘要里说“根据企业需要增加删除新的字段”但我拆完这套源码后要泼盆冷水加字段本身很容易难的是字段加完之后搜索、列表展示、导入导出、报表统计全链路能不能跟上。以常见的PHP表单配置为例加一个字段一般分三步先在字段配置表fields里插入记录再在对应的业务表里加物理列最后在表单模板和列表模板里引用。很多二开项目翻车在第二步——配置表里加了字段数据库表结构没同步保存时报SQL错误。// 示意新增自定义字段的入库逻辑 INSERT INTO fields (table_name, field_name, field_label, field_type, is_required, sort_order) VALUES (customer, customer_level_custom, 客户分级(自定义), select, 0, 10);加字段之前先回答三个问题这个字段是给谁看的销售录入还是管理层统计、需不需要参与高级筛选、需不需要出现在导出列里。如果只是录入时顺手填一下用文本框就行如果要按它做统计尽量用下拉选择或数字类型不要用文本不然后面报表模块没法聚合。这套源码的“高级筛选”功能只对勾选了的字段生效新增字段默认不加入筛选条件得在筛选配置里手动挂上——这是最快见效也最容易被忽略的一步。3. 本机部署与数据库初始化从解压zip到跑通全流程3.1 环境选型与目录结构先看入口文件再谈运行解压zip之后第一件事不要在浏览器里直接访问域名而是先把目录结构看一遍。这套源码按常见的PHP项目组织方式入口文件在根目录或public目录下config目录放数据库连接和系统配置database目录或sql目录放初始化脚本。先确认入口文件路径再确认运行目录指向否则会出现控制器路径对不上、静态资源加载404的问题。环境选型上这类源码多数跑在PHP 5.6到7.2之间建议直接用PHP 7.0或7.1。PHP 5.6太老很多安全补丁缺失PHP 7.3以上会触发废弃函数报错比如mysql_list_tables这类老函数在PHP 7.x里已经被移除如果源码里有用到就得先做兼容处理。MySQL推荐5.6或5.78.0也能跑但要注意认证插件问题——MySQL 8.0默认的caching_sha2_password身份验证插件老版本PHP的mysqli扩展连不上解决办法是新建用户时指定mysql_native_password。; php.ini 关键参数参考 upload_max_filesize 20M post_max_size 20M memory_limit 256M max_execution_time 120这个php.ini配置是给部署环境打底的upload_max_filesize和post_max_size一起调只调前者会导致大文件上传时POST请求直接超限memory_limit给到256M是防止客户导入、报表统计时内存溢出具体数值按客户数据量调整数据量在十万级客户以内256M够用。3.2 数据库导入与配置文件修改字符集和表前缀最容易翻车数据库初始化是整个部署过程里翻车率最高的一步。常见错误是直接在phpMyAdmin里导入全部SQL结果报错卡在一半。正确步骤是先手动建库指定字符集再导入SQL。mysql -uroot -p CREATE DATABASE crm DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE crm; SOURCE /var/www/html/crm/database_crm.sql;用命令行的SOURCE方式导入比图形界面更稳定能看到每一步的报错输出。这里用utf8mb4而不是utf8是因为联系人备注、客户地址这类字段经常会有emoji或生僻字utf8mb4是utf8的超集能存四字节字符。建库语句里的COLLATE排序规则utf8mb4_general_ci和utf8mb4_unicode_ci在中小系统里差别不大选general_ci性能更好一点。导入完成之后改数据库连接配置。以常见PHP配置格式为例?php return [ hostname 127.0.0.1, database crm, username root, password 换成实际密码, hostport 3306, prefix crm_, ];每个参数的意义hostname是数据库地址本地部署用127.0.0.1如果是远程数据库要改成对应IP并确认端口放行database是库名要和建库语句一致prefix是表前缀这套源码默认是crm_如果改前缀不只是改这个文件SQL文件里的建表语句也要同步替换不然系统运行时找不到表。密码里的特殊字符要注意如果密码带了#或把整个配置项用单引号包起来避免命令行和解析时被截断。3.3 安装后的功能验证清单登录、菜单、数据三张表一起查装完不是登录进去看一眼就完事的要按业务主线把核心链路走一遍。登录后台后按清单验证五分钟就能判断源码是否完整验证项操作预期结果失败时的排查点基础登录使用管理员账号登录进入首页仪表盘账号密码错误或用户表未初始化模块菜单检查左侧菜单模块是否齐全十大模块全部显示菜单权限未分配检查角色权限配置线索领取在线索池中领取一条线索线索归到当前用户线索池回收任务未启动或状态字段错误客户录入新建客户并录入自定义字段客户保存成功且字段正常展示字段配置表和物理表结构不一致合同审核创建合同并走审批商机状态自动变为成功客户锁定审批流未配置或合同状态变更钩子未生效第六项应收款和出库单的联动验证放到下一章详细讲。这里重点说的是如果第三项线索领取失败多数情况不是功能坏了而是“线索池”页面右上角没有“去重”按钮——重复的公司名会拦截领取这时候去客户列表确认是否已存在相同公司删掉或合并后再领取属于业务逻辑保护而不是缺陷。4. 销售闭环实操报价单、应收款、出库单的联动和权限分离4.1 商机-合同联动报价单转合同的触发条件这一版源码新增的报价单功能定位是“商机和合同之间的过渡单据”。报价单从商机的基本信息带出客户名称、联系人、产品明细销售在报价单上调整价格和数量确认后一键生成合同。这个设计比直接创建合同多了一道确认环节在业务上的意义是防止销售在商机还没谈拢时就把合同录入系统造成合同数据失真。报价单转合同这个动作核心是判断“当前商机是否已有报价单”和“报价单是否已审核”。常见的实现方式是在报价单保存时检查business_id是否重复生成过已审核报价单有就直接返回错误提示而不是再生成一份。// 示意报价单生成合同的触发校验 $quote $quoteModel-where(business_id, $businessId) -where(audit_status, 2) -find(); if ($quote) { // 已存在审核通过的报价单不允许重复生成合同 return error(该商机已存在审核通过的报价单); }这段逻辑的关键运算在于audit_status字段0是草稿、1是待审核、2是审核通过。很多二开的人只判断了有没有报价单记录没判断审核状态结果草稿状态的报价单也能一键生成合同审批流形同虚设。还有就是报价单明细和合同明细的关系通常报价单里有产品ID、数量、单价转合同时这三列原样复制但合同里会多出“合同总金额”“付款方式”“交货日期”这几个合同域字段需要从报价单的补充字段或表单回填。4.2 合同审核通过即生成应收款与出库单钩子函数的写法逻辑这一节是整个源码里最有含金量的部分。摘要里写的“合同审核通过自动生成应收款合同创建完成后自动生成出库单”这两件事不是前端按钮触发的而是后端在合同审核状态变更时自动执行的联动逻辑。我在源码里看到的处理方式是在合同模型的审核回调里判断状态变更方向。// 示意合同审核通过后的联动处理 if ($contract[audit_status] 3 $contract[old_status] 2) { // 状态从待审核(2)变为通过(3)执行应收款生成 $receivableData [ contract_id $contract[id], customer_id $contract[customer_id], amount $contract[total_amount], plan_type $contract[payment_plan], create_time time(), ]; $receivableModel-insert($receivableData); // 生成出库单状态置为待审核 $stockOutModel-createFromContract($contract[id]); }这段代码里最关键的是old_status的判断——只有从待审核变成通过才触发编辑合同时如果status没有变化不会重复生成应收款。应收款表里plan_type这个字段对应合同的回款计划类型源码新增功能里写了“应收款创建完成之后可设置不同时间回款计划到期有站内信提醒”这个plan_type在应收款生成时从合同带过来后续回款计划表按plan_type展开生成分期记录。出库单的createFromContract方法内部逻辑是遍历合同产品明细把产品ID、数量、客户ID复制到出库单表并生成出库单号。这里有个容易坑人的细节出库单生成时库存并没有扣减要等仓管人员审核出库单之后才扣。也就是说“合同创建 → 出库单生成 → 出库单审核 → 库存扣减”是四步中间任何一步断了库存都不会动。4.3 权限分离配置销售创建收款单、财务负责审核新增功能里提到“销售人员创建收款单财务负责审核”这个权限模型是一个典型的双人复核设计。与传统的“谁创建谁修改谁删除全权限”不同这套源码把“创建”和“审核”拆成了两个独立权限点。在后台权限配置里找到收款单模块销售角色只勾选“新增”和“查看本人”财务角色勾选“新增”“查看全部”“审核”“驳回”。注意不要给销售角色勾“编辑”权限否则销售创建收款单后还能自己改金额审核就失去意义了。-- 示意收款单审核权限的查询关联 SELECT r.receipt_id, r.amount, r.status, u.realname AS create_user FROM receipt r LEFT JOIN user u ON r.create_by u.id WHERE r.status 0这条SQL是财务待审核列表的查询逻辑status为0表示待审核create_by关联用户表拿到创建人姓名。这里有个细节收款单的“是否已开具发票”字段摘要里写了“可在配置里设置是否选择使用这一字段”如果公司发票和收款分开管理就不勾选这个字段的启用开关列表页和表单页都不显示减少录入负担。权限分离配置完成后要做一次交叉验证——用销售账号登录确认看不到财务的审核按钮用财务账号登录确认不能修改已审核收款单的金额。5. 二开避坑指南crm系统改造时最容易踩的六个坑5.1 数据库导入后白屏先查PHP版本再看install.lock现象数据库导入完成、配置也改好了访问首页直接白屏浏览器F12控制台只有500错误。原因排名第一的原因是PHP版本太高源码里用了mysql_list_tables、each这种PHP 7.0就废弃的函数第二常见是源码自带install.lock文件存在安装向导认为已经装过了直接跳转却因为配置不完整导致路由空转。解决先把PHP版本降到7.0或7.1试一遍如果还白屏检查根目录下的install.lock或install目录里的lock文件删除后重新走安装向导。最后打开php_errorlog或error_reporting的显示开关定位到具体是哪个文件报的致命错误把废弃函数替换成对应的mysqli或PDO写法。5.2 地址搜索搜不到区域索引和数据源双重检查现象客户模块的高级筛选里按地址搜索输入省市区名称返回空结果但客户资料里明明有地址。原因地址字段的存储形式和搜索方式不匹配。这套源码的地址搜索是“区域ID关联”客户表里存的是区域表region的ID不是地区名字符串。如果导入SQL时区域数据不完整或者搜索时用的 LIKE 直接匹配ID就会查不到。解决打开region表检查省市区数据是否导入完整数据量一般在几千条。如果数据没问题手动跑一下索引重建ALTER TABLE region ADD INDEX idx_parent_id (parent_id)再按地址搜索接口的实际SQL确认关联查询用的是 region.name LIKE 而不是 region_id LIKE。5.3 自定义字段加了不显示列表页模板没同步现象后台成功添加了自定义字段录入表单也看得到但客户列表页不展示这一列。原因这套源码的表单和列表是独立模板。自定义字段配置只管“录入表单”的渲染列表页的显示列、高级筛选的筛选项都要单独勾选配置。很多人改完表单就以为完事了列表页缓存又没刷新自然看不到。解决去自定义字段设置里重新编辑该字段把“列表显示”“高级筛选启用”两项打开再不行就清模板缓存把runtime目录或cache目录里的编译文件删掉。注意改完字段后不要只刷新页面要退出账号重新登录角色权限里如果限制了该字段的可见性列表一样不显示。5.4 出库单审核后库存没动扣减逻辑与库存流水账现象仓管审核出库单后产品列表里的库存数量没变化重新刷新也不变。原因这通常不是出库单功能坏了而是库存扣减的触发条件设计在“出库单审核完成”之后的一个额外动作上。有些源码把库存操作写在出库单的“确认出库”按钮上先审核再确认出库两步缺一不可。如果没有“确认出库”这一步库存永远不会变。解决查看出库单的状态流转正常情况下是“待审核→已审核→已出库”。审核只是审批动作确认出库才执行库存扣减和库存流水写入检查进销存模块的配置项是否勾选了“审核自动出库”开关打开后审核即扣减适合仓管和审核职责集于一人的小团队。5.5 停用用户审批统计还冒出来缓存和统计表的双重校验现象管理后台停用了某个用户但审批统计模块里还能看到这个人的待办数量点进详情又提示用户已停用。原因审批统计模块的数据是从统计缓存表里读的停用操作没有同步更新统计表或者统计列表默认不过滤is_disabled字段。问题出在“停用写的是user表的状态字段统计读的是审批汇总表”两张表没有做状态同步。解决先做一次统计表全量重建把审批汇总表按当前user状态刷新一遍再检查统计查询SQL里是否带上了user.status1条件。如果源码没这个字段筛选可以在person_statistics表刷新脚本里手动加一条UPDATE语句。5.6 客户导出丢字段列权限与导出模板不匹配现象用管理员账号导出客户Excel里就是缺了自定义字段那几列模板里也看不到。原因导出功能读取的列定义来自另一个独立的导出模板配置不是主要单列表页。管理员虽然能看到客户详情但导出模板没把新加的字段加进去导出的表头和内容都不包含自定义列。解决找到导出模板配置页把新增的自定义字段拖进导出列保存后重新导出。如果源码没有可视化的导出模板配置就得改导出逻辑代码把fields表里标记为“导出可见”的字段动态拼进导出列不要用硬编码表头。6. 部署加固从调试环境到可持续跑业务的两个习惯第一件事是数据库定时备份。本地调试的时候无所谓一旦客户开始录入真实数据备份就不是可选项了。我一般会在服务器上挂一个cron任务每天凌晨做一次mysqldump全量备份保留最近七天。#!/bin/bash BACKUP_DIR/var/backups/crm DATE$(date %Y%m%d) mysqldump -uroot -p实际密码 --single-transaction crm | gzip $BACKUP_DIR/crm_$DATE.sql.gz find $BACKUP_DIR -name crm_*.sql.gz -mtime 7 -exec rm {} \;这段脚本里--single-transaction参数很关键它让备份不锁表白天跑也不会阻塞业务读写后面find加-mtime 7是自动清理七天前的备份防止磁盘被导出的SQL文件堆满。第一次配这个任务时我在crontab里把执行时间定在凌晨两点以为很安全结果第二天发现备份文件是空的——因为mysqldump的密码提示交互没法在定时任务里响应。后来把密码写进脚本里再给脚本文件设了600权限才算消停从那以后每次给这套源码部署新环境都强制走一遍定时备份验证。第二件事是把通知方式的配置理顺。源码的站内信提醒是离线的默认方式回款计划到期提醒、审批推送都依赖站内信。但站内信有个问题——用户不登录系统就看不到。部署时建议把邮件或短信通道配好至少要配邮件提醒这样回款计划到期时财务能收到邮件而不是等打开系统才发现客户回款日已经过了。配置邮件的重点在SMTP参数注意发件邮箱要开SMTP授权码不能用登录密码。这套源码跑得越久越能体会到真正值钱的不只是功能全而是线索、合同、应收款、出库单这条线上的状态联动是自动完成的。如果后续要做二开建议优先围着这条链路来改而不是先去折腾那些花哨的UI效果——销售团队每天在等一个准确的回款提醒。希望帮到你。本文还有配套的精品资源点击获取 CRM客户管理系统源码部署与二开指南：从线索到应收款的业务闭环实现
简介这是一套面向中小企业的旗舰版客户关系管理CRM系统源码覆盖市场、销售、采购、库存、售后全流程适合需要统一管理客户资料、实现业务自动化的企业管理者与二次开发人员。资源包共1905个文件、约11.92MB以PHP后端逻辑、HTML页面、JavaScript交互和CSS样式为主另含SQL数据库脚本、配置文件与图片素材导入数据库即可安装且无加密、无域名限制。源码内置线索、客户、商机、合同、财务、销售、采购、库存、产品、审批、任务、日程、知识、日志、站内信、营销等模块支持自定义字段、客户共享与转移、线索池回收、进销存联动、收付款与发票管理、出库单审核等完整业务闭环也包含报价单转合同、合同自动生成应收款及回款计划提醒等实用功能。目前已有384人学习下载适合直接部署或基于旗舰版能力进行二次扩展。1. 客户管理系统源码到手后先确认这三件事再动手做中小企业CRM落地的人十有八九遇到过这种场面下载一个标着“旗舰版”的客户管理系统源码解压出来一堆文件夹装上却连登录页都进不去或者跑起来发现线索、合同、进销存各玩各的根本不是一个闭环。这份源码包我在本地完整跑过一遍核心卖点其实不在“十大模块”这种宣传词而在于线索、客户、商机、合同、应收款、出库单是串成一条线的——合同审核通过自动生成应收款和出库单商机状态自动转成功客户自动锁定这才是它和网上那些免费版拉开差距的地方。适合谁有两类人一是公司要自建CRM、有销售团队也有库存管理需求的运维或技术负责人二是接外包项目、需要一套能快速改字段做二开的PHP源码的开发者。动手之前先把环境兼容性、数据库字符集、目录权限这三件事确认了后面能省很多事。2. 模块拆解与业务闭环线索、客户、商机、合同是怎么串成一条线的2.1 十大模块的数据主线先理清主从表关系再碰代码摘要里写的是“十大模块和五小模块”听起来很唬人但剥开看真正的主线就一条线索 → 客户 → 商机 → 合同 → 应收款/出库单。其它像任务、日程、知识、日志、站内信这些都是挂靠在业务对象上的辅助数据。以这套源码的常见PHP数据表结构为例线索表lead是源头里面至少会有公司名、联系人、电话、来源渠道、领取人ID、领取时间、线索状态这几个核心字段。线索转成客户时按“常见做法是字段映射复制”的逻辑把线索里的公司名、联系人、电话直接带入客户表customer再补上客户等级、行业、来源、地址这些客户维度信息。客户转商机同样如此商机表business会引用客户ID同时记录商机金额、预计成交时间、所处的销售阶段。-- 示意线索转客户时的关键字段映射 SELECT lead.id AS lead_id, lead.company_name AS customer_name, lead.contact AS customer_contact, lead.phone AS customer_phone, lead.source AS customer_source FROM lead WHERE lead.id #{lead_id};这段SQL的逻辑是转客户不是整套记录搬过去而是把线索表里有业务价值的基础字段取出来作为客户表的初始数据。参数上要注意source的来源枚举值不同版本源码里“线上推广”“转介绍”“电话咨询”的存储编码不一样如果后续自定义字段里有“来源细分”映射关系要在转换脚本里写完整否则转过去之后再想追溯线索来源就得翻日志。商机表的阶段字段值得一提这套源码在“合同创建成功商机状态自动转变为成功客户自动锁定”这个需求里实际是商机阶段stage和商机状态status两个字段配合stage记录“初步接触”“需求确认”“方案报价”“商务谈判”这样的销售阶段status才是“进行中/成功/失败”。很多二开的人只改了stage没动status导致列表页商机看起来状态没变。2.2 线索池回收机制限时限额领取的配置口径线索池是这套源码里值得先研究的机制。摘要里写得很清楚员工限时限额领取线索规定时间内线索没有利用就会自动进入线索池。这个功能对销售团队的意义在于防止有人领了线索躺在手里不跟。// 示意线索池定时回收任务的判定逻辑 if ($lead[status] 0 $lead[receive_time] time() - $config[pool_recycle_hours] * 3600) { // 超时未跟进释放回线索池 $lead[owner_id] 0; $lead[receive_time] null; $lead[status] 0; }这段逻辑的核心是三个参数status表示线索是否已被领取0为未领取receive_time是领取时间戳pool_recycle_hours是设定的回收时限。我一般会把回收时限设置成24小时再配合一个“跟进记录数小于1即回收”的条件单纯判断领取时间太粗暴——销售领了线索当天就写了跟进备注但没改状态24小时后被回收容易引起纠纷。“限额”这部分一般在后台配置里常见做法是按角色设置每人每天可领取的线索上限。这里有个容易忽略的点限额要区分“领取”和“转化”有些销售用多个账号领线索或者领了不建档当私域存着。源码里在“线索池”页面的筛选逻辑通常会过滤掉已关联客户的重复公司名上线前最好把“同公司名线索去重”这个配置打开。2.3 自定义字段的开放模型加字段前先回答三个问题自定义字段是这个系统的开放模型卖点。摘要里说“根据企业需要增加删除新的字段”但我拆完这套源码后要泼盆冷水加字段本身很容易难的是字段加完之后搜索、列表展示、导入导出、报表统计全链路能不能跟上。以常见的PHP表单配置为例加一个字段一般分三步先在字段配置表fields里插入记录再在对应的业务表里加物理列最后在表单模板和列表模板里引用。很多二开项目翻车在第二步——配置表里加了字段数据库表结构没同步保存时报SQL错误。// 示意新增自定义字段的入库逻辑 INSERT INTO fields (table_name, field_name, field_label, field_type, is_required, sort_order) VALUES (customer, customer_level_custom, 客户分级(自定义), select, 0, 10);加字段之前先回答三个问题这个字段是给谁看的销售录入还是管理层统计、需不需要参与高级筛选、需不需要出现在导出列里。如果只是录入时顺手填一下用文本框就行如果要按它做统计尽量用下拉选择或数字类型不要用文本不然后面报表模块没法聚合。这套源码的“高级筛选”功能只对勾选了的字段生效新增字段默认不加入筛选条件得在筛选配置里手动挂上——这是最快见效也最容易被忽略的一步。3. 本机部署与数据库初始化从解压zip到跑通全流程3.1 环境选型与目录结构先看入口文件再谈运行解压zip之后第一件事不要在浏览器里直接访问域名而是先把目录结构看一遍。这套源码按常见的PHP项目组织方式入口文件在根目录或public目录下config目录放数据库连接和系统配置database目录或sql目录放初始化脚本。先确认入口文件路径再确认运行目录指向否则会出现控制器路径对不上、静态资源加载404的问题。环境选型上这类源码多数跑在PHP 5.6到7.2之间建议直接用PHP 7.0或7.1。PHP 5.6太老很多安全补丁缺失PHP 7.3以上会触发废弃函数报错比如mysql_list_tables这类老函数在PHP 7.x里已经被移除如果源码里有用到就得先做兼容处理。MySQL推荐5.6或5.78.0也能跑但要注意认证插件问题——MySQL 8.0默认的caching_sha2_password身份验证插件老版本PHP的mysqli扩展连不上解决办法是新建用户时指定mysql_native_password。; php.ini 关键参数参考 upload_max_filesize 20M post_max_size 20M memory_limit 256M max_execution_time 120这个php.ini配置是给部署环境打底的upload_max_filesize和post_max_size一起调只调前者会导致大文件上传时POST请求直接超限memory_limit给到256M是防止客户导入、报表统计时内存溢出具体数值按客户数据量调整数据量在十万级客户以内256M够用。3.2 数据库导入与配置文件修改字符集和表前缀最容易翻车数据库初始化是整个部署过程里翻车率最高的一步。常见错误是直接在phpMyAdmin里导入全部SQL结果报错卡在一半。正确步骤是先手动建库指定字符集再导入SQL。mysql -uroot -p CREATE DATABASE crm DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE crm; SOURCE /var/www/html/crm/database_crm.sql;用命令行的SOURCE方式导入比图形界面更稳定能看到每一步的报错输出。这里用utf8mb4而不是utf8是因为联系人备注、客户地址这类字段经常会有emoji或生僻字utf8mb4是utf8的超集能存四字节字符。建库语句里的COLLATE排序规则utf8mb4_general_ci和utf8mb4_unicode_ci在中小系统里差别不大选general_ci性能更好一点。导入完成之后改数据库连接配置。以常见PHP配置格式为例?php return [ hostname 127.0.0.1, database crm, username root, password 换成实际密码, hostport 3306, prefix crm_, ];每个参数的意义hostname是数据库地址本地部署用127.0.0.1如果是远程数据库要改成对应IP并确认端口放行database是库名要和建库语句一致prefix是表前缀这套源码默认是crm_如果改前缀不只是改这个文件SQL文件里的建表语句也要同步替换不然系统运行时找不到表。密码里的特殊字符要注意如果密码带了#或把整个配置项用单引号包起来避免命令行和解析时被截断。3.3 安装后的功能验证清单登录、菜单、数据三张表一起查装完不是登录进去看一眼就完事的要按业务主线把核心链路走一遍。登录后台后按清单验证五分钟就能判断源码是否完整验证项操作预期结果失败时的排查点基础登录使用管理员账号登录进入首页仪表盘账号密码错误或用户表未初始化模块菜单检查左侧菜单模块是否齐全十大模块全部显示菜单权限未分配检查角色权限配置线索领取在线索池中领取一条线索线索归到当前用户线索池回收任务未启动或状态字段错误客户录入新建客户并录入自定义字段客户保存成功且字段正常展示字段配置表和物理表结构不一致合同审核创建合同并走审批商机状态自动变为成功客户锁定审批流未配置或合同状态变更钩子未生效第六项应收款和出库单的联动验证放到下一章详细讲。这里重点说的是如果第三项线索领取失败多数情况不是功能坏了而是“线索池”页面右上角没有“去重”按钮——重复的公司名会拦截领取这时候去客户列表确认是否已存在相同公司删掉或合并后再领取属于业务逻辑保护而不是缺陷。4. 销售闭环实操报价单、应收款、出库单的联动和权限分离4.1 商机-合同联动报价单转合同的触发条件这一版源码新增的报价单功能定位是“商机和合同之间的过渡单据”。报价单从商机的基本信息带出客户名称、联系人、产品明细销售在报价单上调整价格和数量确认后一键生成合同。这个设计比直接创建合同多了一道确认环节在业务上的意义是防止销售在商机还没谈拢时就把合同录入系统造成合同数据失真。报价单转合同这个动作核心是判断“当前商机是否已有报价单”和“报价单是否已审核”。常见的实现方式是在报价单保存时检查business_id是否重复生成过已审核报价单有就直接返回错误提示而不是再生成一份。// 示意报价单生成合同的触发校验 $quote $quoteModel-where(business_id, $businessId) -where(audit_status, 2) -find(); if ($quote) { // 已存在审核通过的报价单不允许重复生成合同 return error(该商机已存在审核通过的报价单); }这段逻辑的关键运算在于audit_status字段0是草稿、1是待审核、2是审核通过。很多二开的人只判断了有没有报价单记录没判断审核状态结果草稿状态的报价单也能一键生成合同审批流形同虚设。还有就是报价单明细和合同明细的关系通常报价单里有产品ID、数量、单价转合同时这三列原样复制但合同里会多出“合同总金额”“付款方式”“交货日期”这几个合同域字段需要从报价单的补充字段或表单回填。4.2 合同审核通过即生成应收款与出库单钩子函数的写法逻辑这一节是整个源码里最有含金量的部分。摘要里写的“合同审核通过自动生成应收款合同创建完成后自动生成出库单”这两件事不是前端按钮触发的而是后端在合同审核状态变更时自动执行的联动逻辑。我在源码里看到的处理方式是在合同模型的审核回调里判断状态变更方向。// 示意合同审核通过后的联动处理 if ($contract[audit_status] 3 $contract[old_status] 2) { // 状态从待审核(2)变为通过(3)执行应收款生成 $receivableData [ contract_id $contract[id], customer_id $contract[customer_id], amount $contract[total_amount], plan_type $contract[payment_plan], create_time time(), ]; $receivableModel-insert($receivableData); // 生成出库单状态置为待审核 $stockOutModel-createFromContract($contract[id]); }这段代码里最关键的是old_status的判断——只有从待审核变成通过才触发编辑合同时如果status没有变化不会重复生成应收款。应收款表里plan_type这个字段对应合同的回款计划类型源码新增功能里写了“应收款创建完成之后可设置不同时间回款计划到期有站内信提醒”这个plan_type在应收款生成时从合同带过来后续回款计划表按plan_type展开生成分期记录。出库单的createFromContract方法内部逻辑是遍历合同产品明细把产品ID、数量、客户ID复制到出库单表并生成出库单号。这里有个容易坑人的细节出库单生成时库存并没有扣减要等仓管人员审核出库单之后才扣。也就是说“合同创建 → 出库单生成 → 出库单审核 → 库存扣减”是四步中间任何一步断了库存都不会动。4.3 权限分离配置销售创建收款单、财务负责审核新增功能里提到“销售人员创建收款单财务负责审核”这个权限模型是一个典型的双人复核设计。与传统的“谁创建谁修改谁删除全权限”不同这套源码把“创建”和“审核”拆成了两个独立权限点。在后台权限配置里找到收款单模块销售角色只勾选“新增”和“查看本人”财务角色勾选“新增”“查看全部”“审核”“驳回”。注意不要给销售角色勾“编辑”权限否则销售创建收款单后还能自己改金额审核就失去意义了。-- 示意收款单审核权限的查询关联 SELECT r.receipt_id, r.amount, r.status, u.realname AS create_user FROM receipt r LEFT JOIN user u ON r.create_by u.id WHERE r.status 0这条SQL是财务待审核列表的查询逻辑status为0表示待审核create_by关联用户表拿到创建人姓名。这里有个细节收款单的“是否已开具发票”字段摘要里写了“可在配置里设置是否选择使用这一字段”如果公司发票和收款分开管理就不勾选这个字段的启用开关列表页和表单页都不显示减少录入负担。权限分离配置完成后要做一次交叉验证——用销售账号登录确认看不到财务的审核按钮用财务账号登录确认不能修改已审核收款单的金额。5. 二开避坑指南crm系统改造时最容易踩的六个坑5.1 数据库导入后白屏先查PHP版本再看install.lock现象数据库导入完成、配置也改好了访问首页直接白屏浏览器F12控制台只有500错误。原因排名第一的原因是PHP版本太高源码里用了mysql_list_tables、each这种PHP 7.0就废弃的函数第二常见是源码自带install.lock文件存在安装向导认为已经装过了直接跳转却因为配置不完整导致路由空转。解决先把PHP版本降到7.0或7.1试一遍如果还白屏检查根目录下的install.lock或install目录里的lock文件删除后重新走安装向导。最后打开php_errorlog或error_reporting的显示开关定位到具体是哪个文件报的致命错误把废弃函数替换成对应的mysqli或PDO写法。5.2 地址搜索搜不到区域索引和数据源双重检查现象客户模块的高级筛选里按地址搜索输入省市区名称返回空结果但客户资料里明明有地址。原因地址字段的存储形式和搜索方式不匹配。这套源码的地址搜索是“区域ID关联”客户表里存的是区域表region的ID不是地区名字符串。如果导入SQL时区域数据不完整或者搜索时用的 LIKE 直接匹配ID就会查不到。解决打开region表检查省市区数据是否导入完整数据量一般在几千条。如果数据没问题手动跑一下索引重建ALTER TABLE region ADD INDEX idx_parent_id (parent_id)再按地址搜索接口的实际SQL确认关联查询用的是 region.name LIKE 而不是 region_id LIKE。5.3 自定义字段加了不显示列表页模板没同步现象后台成功添加了自定义字段录入表单也看得到但客户列表页不展示这一列。原因这套源码的表单和列表是独立模板。自定义字段配置只管“录入表单”的渲染列表页的显示列、高级筛选的筛选项都要单独勾选配置。很多人改完表单就以为完事了列表页缓存又没刷新自然看不到。解决去自定义字段设置里重新编辑该字段把“列表显示”“高级筛选启用”两项打开再不行就清模板缓存把runtime目录或cache目录里的编译文件删掉。注意改完字段后不要只刷新页面要退出账号重新登录角色权限里如果限制了该字段的可见性列表一样不显示。5.4 出库单审核后库存没动扣减逻辑与库存流水账现象仓管审核出库单后产品列表里的库存数量没变化重新刷新也不变。原因这通常不是出库单功能坏了而是库存扣减的触发条件设计在“出库单审核完成”之后的一个额外动作上。有些源码把库存操作写在出库单的“确认出库”按钮上先审核再确认出库两步缺一不可。如果没有“确认出库”这一步库存永远不会变。解决查看出库单的状态流转正常情况下是“待审核→已审核→已出库”。审核只是审批动作确认出库才执行库存扣减和库存流水写入检查进销存模块的配置项是否勾选了“审核自动出库”开关打开后审核即扣减适合仓管和审核职责集于一人的小团队。5.5 停用用户审批统计还冒出来缓存和统计表的双重校验现象管理后台停用了某个用户但审批统计模块里还能看到这个人的待办数量点进详情又提示用户已停用。原因审批统计模块的数据是从统计缓存表里读的停用操作没有同步更新统计表或者统计列表默认不过滤is_disabled字段。问题出在“停用写的是user表的状态字段统计读的是审批汇总表”两张表没有做状态同步。解决先做一次统计表全量重建把审批汇总表按当前user状态刷新一遍再检查统计查询SQL里是否带上了user.status1条件。如果源码没这个字段筛选可以在person_statistics表刷新脚本里手动加一条UPDATE语句。5.6 客户导出丢字段列权限与导出模板不匹配现象用管理员账号导出客户Excel里就是缺了自定义字段那几列模板里也看不到。原因导出功能读取的列定义来自另一个独立的导出模板配置不是主要单列表页。管理员虽然能看到客户详情但导出模板没把新加的字段加进去导出的表头和内容都不包含自定义列。解决找到导出模板配置页把新增的自定义字段拖进导出列保存后重新导出。如果源码没有可视化的导出模板配置就得改导出逻辑代码把fields表里标记为“导出可见”的字段动态拼进导出列不要用硬编码表头。6. 部署加固从调试环境到可持续跑业务的两个习惯第一件事是数据库定时备份。本地调试的时候无所谓一旦客户开始录入真实数据备份就不是可选项了。我一般会在服务器上挂一个cron任务每天凌晨做一次mysqldump全量备份保留最近七天。#!/bin/bash BACKUP_DIR/var/backups/crm DATE$(date %Y%m%d) mysqldump -uroot -p实际密码 --single-transaction crm | gzip $BACKUP_DIR/crm_$DATE.sql.gz find $BACKUP_DIR -name crm_*.sql.gz -mtime 7 -exec rm {} \;这段脚本里--single-transaction参数很关键它让备份不锁表白天跑也不会阻塞业务读写后面find加-mtime 7是自动清理七天前的备份防止磁盘被导出的SQL文件堆满。第一次配这个任务时我在crontab里把执行时间定在凌晨两点以为很安全结果第二天发现备份文件是空的——因为mysqldump的密码提示交互没法在定时任务里响应。后来把密码写进脚本里再给脚本文件设了600权限才算消停从那以后每次给这套源码部署新环境都强制走一遍定时备份验证。第二件事是把通知方式的配置理顺。源码的站内信提醒是离线的默认方式回款计划到期提醒、审批推送都依赖站内信。但站内信有个问题——用户不登录系统就看不到。部署时建议把邮件或短信通道配好至少要配邮件提醒这样回款计划到期时财务能收到邮件而不是等打开系统才发现客户回款日已经过了。配置邮件的重点在SMTP参数注意发件邮箱要开SMTP授权码不能用登录密码。这套源码跑得越久越能体会到真正值钱的不只是功能全而是线索、合同、应收款、出库单这条线上的状态联动是自动完成的。如果后续要做二开建议优先围着这条链路来改而不是先去折腾那些花哨的UI效果——销售团队每天在等一个准确的回款提醒。希望帮到你。本文还有配套的精品资源点击获取