简介面向中小企业客户管理场景的旗舰版CRM源码包以PHP开发功能覆盖市场、销售、采购、库存、售后等完整业务链路。该版本为非免费旗舰版无加密、无域名限制可二次开发适合需要定制客户管理系统的开发人员或企业实施团队。压缩包共1905个文件含519个PHP业务文件、383个HTML模板、185个JS交互脚本、68个CSS样式以及大量PNG/GIF图片和SQL数据库文件整体大小约11.92MB目录结构便于检索。目前已吸引384人学习下载。源码内置线索、客户、商机、合同、财务、销售、采购、库存等十大模块并支持自定义字段、审批流程、进销存管理、报价单生成合同、合同自动生成应收款与出库单等实用功能同时包含线索自动回流池、客户高级筛选、手机端图片展示等优化细节导入数据库即可安装使用。对需要快速搭建或深度改造CRM系统的读者可从其中获得完整基础框架和业务逻辑参考显著缩短开发周期。1. 先搞清楚「某CRM旗舰版功能齐全客户管理系统源码.zip」这类包的价值边界从源码站下载一个「某CRM旗舰版功能齐全客户管理系统源码.zip」解压后通常是一套 PHP 源码加一个 SQL 导出包它不是给人打开看看的是要求你自己把它部署起来的。这类包的价值不在代码量多少而在三件事数据落在你自己手里、功能可以按业务改、团队可以在上面持续二开。SaaS CRM 用一年算一笔账之后每年续费源码 CRM 是一次部署后续成本是维护和二开的人工。适合谁中小企业 IT 负责人想自建客户系统外包团队拿来给客户做私有化交付或者企业要求客户数据不能出内网、必须本地部署的项目组。但「功能齐全」四个字只是卖家标签真实情况是每个包的框架、目录结构、PHP 版本要求都不一样直接解压丢进服务器大概率白屏。本文就按这类包最常见的技术形态把环境选型、部署流程、模块核对、故障排查和二开路径一次讲完。2. 源码 zip 解压之前的功课这套 CRM 的常见架构与选型判断手里攥着一个 zip先别急着解压上传。先想明白一件事你下载的是一个「需要环境配合」的程序不是办公文档。十份国内流通的 CRM 源码包八份是 PHP MySQL 形态剩下两份可能是 Java 或 .NET。为什么 PHP 占绝对主流因为这类包大多是 2015 到 2020 年之间做的那个阶段 PHP 源码的传播成本最低虚拟主机、云服务器都能跑部署时不需要编译、不需要 Maven 拉依赖解压改个配置就能进安装向导。Java 版 CRM 源码包也有但通常要配 Tomcat、改 context 路径入门门槛高流通量反而小。你拿到 zip 后第一件事不是解压是通过文件名和包内文件清单反推它是什么技术栈再决定给不给它配环境。2.1 一小时内判断技术栈的四个线索解压前先用 unzip 的列表参数扫一眼不落盘就能看到内部结构。这个习惯能省掉后面大量试错。unzip -l crm_source.zip unzip -t crm_source.zip第一条命令列出 zip 内全部文件路径第二条测试压缩包完整性。看输出时重点抓四个线索有没有 index.php、application 或 app 目录有就是 PHP有没有 pom.xml 或 .jar那是 Java有没有 web.config 或 .aspx那是 .NET有没有 package.json 加 node_modules那是 Node。只看文件路径就能排除一半错误方向。另一个判断点是数据库脚本。unzip -l输出里如果有 install.sql、crm.sql、database.sql 这种整库导出文件说明这套系统需要手动建库导入如果只有 install 目录说明它自带网页安装向导向导会帮你执行建表 SQL。这两种包的部署路径完全不同前者要你准备数据库账号密码后者只需要你在浏览器里填表单。我一般会优先选带安装向导的包因为自动向导会处理表前缀、字符集、初始管理员这些琐碎项手动导 SQL 的文件经常出现编码不对、表前缀写死的问题。2.2 解压到服务器目录归属和权限是第一个翻车点技术栈确认无误后开始真正落盘。这里有个血泪经验不要用 root 解压完再直接跑很多包带着 runtime、cache、upload 目录这些目录在运行期要写文件。root 创建的目录权限是 755归属 rootWeb 服务用户 www 写不进去后果就是登录报错、上传图片失败、验证码不显示排查半天才发现是权限问题。规范操作是先建好运行用户再解压然后单独把可写目录的权限放大。useradd -M -s /sbin/nologin www mkdir -p /data/wwwroot/crm unzip crm_source.zip -d /data/wwwroot/crm chown -R www:www /data/wwwroot/crm find /data/wwwroot/crm -type f -exec chmod 644 {} \; find /data/wwwroot/crm -type d -exec chmod 755 {} \; chmod -R 777 /data/wwwroot/crm/runtime解压命令后的逻辑先建一个不能登录的 www 系统用户作为运行身份再把 zip 释放到 /data/wwwroot/crm然后一次性变更整个目录的归属。644 表示文件只读755 表示目录可进入这两条命令是为了防止源码目录里混入多余的可执行权限。最后单独把 runtime 目录放开到 777是因为模板编译、缓存文件、会话文件都要往这里写权限收紧后框架会直接抛「目录不可写」。注意 runtime 这个目录名在不同包里叫法不一样常见的有 runtime、cache、temp、data/log解压后先 ls 看一眼目录列表找到名字最像缓存目录的那个再赋权。2.3 用 Docker 起 MySQL 5.7 和 PHP 环境一次到位不折腾本机为了一套源码包去改本机 PHP 版本不值得我习惯用 Docker Compose 把运行环境隔离起来。老 CRM 源码包面向的 PHP 版本普遍在 5.6 到 7.4 之间MySQL 这边则跟 5.7 兼容性最好。为什么不用 MySQL 8因为 MySQL 8 默认的认证插件是 caching_sha2_password而 PHP 7.x 自带的 mysqlnd 驱动默认走 mysql_native_password两者握手直接失败报错是「Authentication plugin caching_sha2_password cannot be loaded」。与其去改 MySQL 8 的用户认证插件不如直接用 5.7 镜像少踩一个坑。services: mysql: image: mysql:5.7 container_name: crm-mysql environment: MYSQL_ROOT_PASSWORD: Root123456 MYSQL_DATABASE: crm command: - --character-set-serverutf8mb4 - --collation-serverutf8mb4_unicode_ci volumes: - ./mysql-data:/var/lib/mysql ports: - 3306:3306 php: image: php:7.4-apache container_name: crm-php ports: - 8080:80 volumes: - ./crm-source:/var/www/htmlCompose 文件里两个服务的参数要分开理解。mysql 服务里 MYSQL_ROOT_PASSWORD 是初始化密码MYSQL_DATABASE 会在容器首次启动时自动建好名为 crm 的空库command 段把字符集固定成 utf8mb4这是为了兼容客户备注里的 emoji 和生僻字老库常用 utf8新部署建议一步到位。php 服务用官方 php:7.4-apache 镜像8080 映射到容器 80 端口当前目录下的 crm-source 挂载到 Apache 的站点根目录。这个组合包部署完浏览器访问http://localhost:8080就能进安装向导或登录页。如果安装向导报缺少扩展不要重新编排整个 Compose写个临时 Dockerfile 补齐再构建一次FROM php:7.4-apache RUN docker-php-ext-install pdo pdo_mysql mysqli \ docker-php-ext-install mbstring fileinfo \ docker-php-ext-enable opcache构建命令是docker build -t crm-php:7.4 .然后把 Compose 里 php 的 image 改成 crm-php:7.4。这四行扩展是 CRM 系统的刚需pdo_mysql 和 mysqli 负责数据库连接mbstring 处理中文编码fileinfo 是文件上传时校验 MIME 类型的依赖很多源码包在文件上传功能里直接调用 finfo 类没装这个扩展会报「Class finfo not found」。opcache 不是必须但装上后 PHP 执行效率有明显提升编译一次可以长期用。2.4 数据库导入和配置文件黑匣子也能拆开看带安装向导的包浏览器里填完数据库地址、账号、库名就能自动建表这部分没有太多可讲的。怕的是那种不带向导、只给你 SQL 文件的包这时需要手动导库。导之前先确认文件里的表前缀有些包默认前缀是 crm_有些是随意写的改配置文件时必须用同一个前缀否则框架找不到表。mysql -h127.0.0.1 -uroot -pRoot123456 crm crm.sql mysql -h127.0.0.1 -uroot -pRoot123456 -e USE crm; SHOW TABLES;第一条命令把 crm.sql 导入刚建好的 crm 库注意 -h 写成 127.0.0.1不要写 localhost。在 MySQL 里这两种写法走的通道不一样localhost 默认走 unix socket127.0.0.1 走 TCPPHP 容器连接数据库时走的是 TCP如果在导入时用了 localhost 导致权限校验方式不一致后续会出现「连接被拒」的怪问题。第二条命令列出所有表目的是核对表前缀和表数量如果一张表都没有说明 SQL 文件里可能带了 CREATE DATABASE 语句而当前客户端没权限执行需要打开 SQL 文件把建库语句删掉只保留建表部分。配置文件是最后一道关。PHP 写的 CRM 配置路径千奇百怪常见的有config/database.php、application/database.php、includes/config.inc.php。找到后改四个值就够数据库地址、库名、账号、密码。如果包内 README 没写配置文件位置用 grep 搜关键词最快。grep -rl DB_HOST\|db_host\|database.*host /data/wwwroot/crm --include*.php这条命令会把所有包含数据库连接关键词的 PHP 文件路径列出来一般第一个命中就是配置文件。打开后把 localhost 改成 127.0.0.1 这类实际地址账号密码改成刚建好的保存后重启 PHP 容器源码包就能跑起来了。到这里部署路径已经走通一半剩下的是登录进去核验功能完整性。3. 功能齐全到底齐在哪模块清单、权限模型和数据表对照部署成功只是开始接下来你要回答的问题是这个包的「旗舰版功能齐全」有没有掺水。判断依据不是页面上的菜单数量而是数据库里的表和关键字段。菜单可以随便堆按钮点了报错也没人管表结构骗不了人。一套正经 CRM 至少要有客户、联系人、商机、合同、跟进记录、回款计划、工单这七个核心域的支撑每个域对应一组数据表和关联关系。下面这套对照表是我核对源码包功能时固定会走的清单你也可以按这个思路去盘你手上那个包。3.1 七个核心模块和它们的数据库影子先把一个真实 CRM 的核心模块列出来对着表检查你手里的包模块功能职责数据库表形态关键字段客户管理客户档案、公海池、分配回收crm_customerstatus, owner_uid, in_pool联系人客户下的多联系人crm_contactcustomer_id, mobile, position商机管理销售漏斗、阶段推进crm_opportunitystage_id, amount, expect_deal_date合同管理合同登记、审批、归档crm_contractcontract_no, amount, sign_date跟进记录电话、拜访、回访日志crm_follow_logcustomer_id, content, next_follow_time回款计划分期回款、逾期提醒crm_receipt_plancontract_id, plan_date, status工单售后售后问题流转crm_ticketticket_no, priority, status这个表格的价值在于你可以在数据库里快速验证。你有没有注意到这七个表之间是关联的联系人挂在客户下面商机挂在客户下面合同挂在商机或客户下面回款计划挂在合同下面。一个功能齐全的 CRM表之间外键可以不建但逻辑关联必须存在也就是说 crm_contact 里必须有一列 customer_id 指向 crm_customer。有些伪「齐全」的包联系人表和客户表毫无关系这种包上线跑一个月你就想扔了。3.2 公海池和权限模型两个最能看出成色的功能公海池是这个品类区别于普通客户登记表的标志性功能。逻辑是客户在分配人手里超过 N 天没跟进自动掉回公海池其他销售可以认领自己也可以主动把无效客户放回公海。对应到数据库crm_customer 表里一般有两个关键字段owner_uid 表示当前归属人in_pool 表示是否在公海。回收逻辑不是前端按钮是服务器定时任务扫描 next_follow_time 和 last_follow_time超期就把 owner_uid 置空、in_pool 置 1。数据结构允许你查出「这个客户谁在看、什么时候掉的、被谁捡走了」这类包才算成熟。权限模型是第二个验成色的点。多数源码包是 RBAC 模型user 表存用户role 表存角色role_user 关联表和 user_auth 表存权限点。数据权限这块做得好的是三档本人数据、本部门数据、全部数据。每张业务表上会有 create_uid 和 dept_id 两个隐含字段查询时框架根据当前用户的角色档位决定要不要拼这两个字段的过滤条件。做粗糙的包只有菜单显隐控制也就是说你点了客户的菜单看到的是全公司所有人的客户这种权限在真实业务里没法用。3.3 用三条 SQL 把包的真实结构查出来核对模块不用去翻源码直接查数据库里的元数据更快。运行这三条 SQL包的功能底细基本就清楚了-- 1. 看所有业务表数量和表名 SELECT table_name, table_comment FROM information_schema.tables WHERE table_schema crm AND table_name LIKE crm_% ORDER BY table_name; -- 2. 看客户表里的关键字段是否齐全 SHOW FULL COLUMNS FROM crm_customer; -- 3. 看角色表和用户数量判断权限体系是否真的生效 SELECT role_id, role_name, data_scope FROM crm_role;第一条语句把和业务相关的表全部列出来如果只有 crm_customer 和 crm_contact 这种零星几张说明包的模块深度有限。第二条语句检查 crm_customer 的字段至少要看到 owner_uid、create_uid、dept_id、in_pool 这四个字段缺少任何一个都意味着公海池或数据权限是假的。第三条语句查询角色表data_scope 字段的值一般是 1、2、3对应全部、部门、本人如果没有这个字段说明数据权限只有菜单级控制。这三条 SQL 跑完你对该不该在这个包上继续花时间心里基本有数了。3.4 跟进记录怎么存时间线和下次跟进时间的设计跟进记录是 CRM 最容易被忽略但一天都不会少用的模块。这里有一个常见设计跟进记录和待办提醒是一体的。crm_follow_log 表存每次跟进内容同时记录一个 next_follow_time系统每天跑定时任务扫出 next_follow_time 在今天之前的客户给负责人生成待办或站内通知。这个设计验证起来也简单查最新一条跟进记录和客户表上的 last_follow_time 是否一致再看看有没有定时任务的脚本文件。SELECT customer_id, content, create_time, next_follow_time FROM crm_follow_log WHERE customer_id 1001 ORDER BY create_time DESC LIMIT 10;这条 SQL 把某个客户最近的跟进按时间倒序列出来观察点有两个next_follow_time 是否由界面上的「下次跟进时间」控件写入以及 create_time 和写入时间是否匹配。如果 next_follow_time 全是 NULL说明提醒功能是摆设页面控件只是存了个寂寞。这个字段直接决定了你未来要不要在这个包上做二次开发一个连跟进闭环都做不完整的 CRM二开成本会把你拖垮。4. CRM 源码部署避坑指南5 个让人想摔键盘的故障同一个源码包在不同人手里命运完全不同。有人半小时跑起来有人折腾一天还是白屏。下面这五个坑是我反复在客户服务器上排过的按出现频率排序列出来每条都是「现象 → 原因 → 解决」的结构你可以直接当排查手册用。4.1 安装向导或登录页白屏浏览器 F12 看到 HTTP 500这是遇到最多的现象。原因基本锁定在 PHP 版本不兼容。老源码包用了大量 PHP 5.x 时代的函数比如 each()、split()这些函数在 PHP 7.2 以后被移除一旦调用直接 fatal error同时很多虚拟主机默认把 display_errors 关掉fatal error 被吞掉页面就是纯白。解决办法分两步先确认版本再打开报错显示。php -v php -m | grep -E pdo_mysql|mysqli|mbstring|fileinfo|curl第一条看当前 PHP 版本7.4 以下比较稳如果已经在 8.0 以上直接换容器重新跑PHP 8 对老代码的破坏性改动太大不值得一个个改。第二条检查扩展列表缺哪个补哪个常见缺 fileinfo 和 mbstring。如果版本没问题且扩展齐全临时把错误显示打开在入口 index.php 第一行加ini_set(display_errors, 1); error_reporting(E_ALL);刷新页面就能看到具体报错行号按报错去找源码对应的函数。4.2 首页能开点菜单就 404这种问题几乎都出在伪静态规则没配。老 PHP 框架的 URL 是 index.php?mhomecuseraindex 这种 queryString 风格后来为了美观改成 pathinfo 风格index.php/home/user/index。Apache 下 .htaccess 自动生效Nginx 不吃 .htaccess必须手写 rewrite 规则。没有规则时首页 index.php 能访问但 /home/user/index 这个路径找不到对应文件直接 404。Nginx 的 location 规则要放到站点配置里location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s$1 last; } }参数说明if (!-e $request_filename)表示文件不存在才走重写存在就直接返回静态文件rewrite把路径参数拼到 s 参数上对应框架的 PATH_INFO 解析入口。不同框架这里不一样ThinkPHP 3.x 用 s 参数Laravel 用rewrite ^(.*)$ /index.php/$1 last;。你那个包到底用哪种看入口文件里解析参数的方式或者看包内有没有现成的 nginx.conf 示例。4.3 安装向导提示数据库连接失败但命令行能连这个现象很有迷惑性你在服务器上用 mysql 命令能连数据库网页向导却说连不上。原因是 PHP-FPM 进程和你的 shell 进程访问数据库时走的网络通道不同。常见有两种情况MySQL 8 的 caching_sha2_password 认证插件老版 PHP 的 mysqlnd 不认或者在安装向导里填数据库地址 localhostPHP 容器里解析到了 unix socket而 MySQL 容器只监听了 TCP 3306 端口。解决方案按优先级排先看 MySQL 版本5.7 最省事如果已经是 8.0不要改全局认证插件配置单独给这套系统建一个 mysql_native_password 用户影响最小最后检查配置里的连接地址容器化部署一律填127.0.0.1:3306别填 localhost。改完重启 PHP 容器再试这个坑基本一次解决。4.4 登录后一分钟就掉线或者验证码图片一直不显示掉线和验证码失效是同一类坑的两种表现根因都指向会话存储。PHP 默认把 session 文件写到 /tmp 或 /var/lib/php/sessions这个目录的拥有者必须是运行 PHP 的用户。如果目录属于 rootwww 用户写不进去session_start 失败登录状态存不住验证码那种把值写 session 的功能自然全废。解决就是把目录归属改掉chown -R www:www /var/lib/php/sessions chmod 733 /var/lib/php/sessions注意目录权限是 733 而不是 777因为 session 文件本身要 600 权限目录可写即可多给权限反而有风险。如果改完还掉线检查 php.ini 里 session.save_path 是否指向别的目录有的镜像默认指向空路径需要 uncomment 并把路径改到实际存在的目录然后重启 PHP-FPM。4.5 定时任务不触发公海回收、跟进提醒全不跑页面功能都正常但客户回收、跟进提醒、合同到期预警这些「自动」功能全都没反应。原因是这类功能依赖 crontab 调度源码包交付时不会帮你把 crontab 也配上。源码里一般有个 cli 目录或者一个单独的控制脚本负责执行这些任务。crontab -e # 每 30 分钟执行一次跟进提醒扫描 */30 * * * * /usr/bin/php /data/wwwroot/crm/cli/remind.php /dev/null 21 # 每天凌晨 2 点执行公海回收 0 2 * * * /usr/bin/php /data/wwwroot/crm/cli/pool_recycle.php /dev/null 21第一行解释crontab 的五个星号分别是分钟、小时、日、月、星期*/30表示每 30 分钟一次。第二行的0 2 * * *是每天凌晨两点。路径里的 cli 目录名各包不同可能是 cli、cron、shell解压源码后用find /data/wwwroot/crm -name *.php | xargs grep -l pool找到具体脚本。比较稳妥的做法是先手动执行一次脚本看有无报错确认脚本能跑通再交给 crontab否则你会在凌晨收到莫名其妙的告警邮件。5. 拿源码之后的下一步用 git 建基线、加客户字段、做验收清单部署通了绝对不是终点。我拿到任何源码包后的第一个动作不是去登录后天看界面而是给源码建 git 基线。这个习惯救过我太多次源码包是别人交付的你没法保证他有没有改过东西建基线后你能看到每一次改动的 diff出了问题也有后悔药吃。在源码目录里执行git init git add -A git commit -m init: 导入CRM源码基线。提交时注意先建一个 .gitignore把 runtime 缓存目录、上传目录、数据库配置文件排除掉这些文件属于运行期artifact每次生成的内容都不一样提交进去只会制造噪音/runtime/* /upload/* /config/database.php .env提交完基线改一个最常见的需求给客户表加一个「客户等级」字段。先写 SQL 加字段再找到客户编辑页模板和保存逻辑文件通过 grep 搜固定关键词定位代码位置。// 新增字段后保存逻辑里的追加代码 $data[customer_level] I(post.customer_level, 0, intval); M(customer)-where(id . intval($_POST[id]))-save($data);这节代码说明客户表单提交后把页面传过来的 customer_level 字段强制转成 int再写入客户表。M(customer) 是框架的模型方法指向 crm_customer 表I() 方法是 ThinkPHP 常见的参数获取函数第二个参数 0 是默认值。改完目录用 git diff 看一眼修改范围确认没有把别的东西蹭进去。最后验收这套源码值不值得继续投入我会按这个清单过一遍一能否跑通「新建客户 → 记跟进 → 转商机 → 签合同 → 做回款计划」的完整链路二换一个非管理员账号登录确认数据权限真的生效三手动改一条记录的归属人验证分配和回收逻辑四把服务器时间改到跟进提醒触发点看能否生成待办五备份一份数据库和源码到另外一台机器演练一次恢复过程。五项全过这个包就具备上线条件。我自己的习惯是任何源码包到手先花半天时间在本地把部署和核验跑完再决定是否引入生产环境这半天永远比上线后救火划算。每接手一套新的包把本机 Docker 环境和常用排查命令固化成一个crm-deploy.md笔记下次遇到相似包直接按笔记走。希望帮到你。本文还有配套的精品资源点击获取 CRM源码包本地部署与二次开发实战指南
简介面向中小企业客户管理场景的旗舰版CRM源码包以PHP开发功能覆盖市场、销售、采购、库存、售后等完整业务链路。该版本为非免费旗舰版无加密、无域名限制可二次开发适合需要定制客户管理系统的开发人员或企业实施团队。压缩包共1905个文件含519个PHP业务文件、383个HTML模板、185个JS交互脚本、68个CSS样式以及大量PNG/GIF图片和SQL数据库文件整体大小约11.92MB目录结构便于检索。目前已吸引384人学习下载。源码内置线索、客户、商机、合同、财务、销售、采购、库存等十大模块并支持自定义字段、审批流程、进销存管理、报价单生成合同、合同自动生成应收款与出库单等实用功能同时包含线索自动回流池、客户高级筛选、手机端图片展示等优化细节导入数据库即可安装使用。对需要快速搭建或深度改造CRM系统的读者可从其中获得完整基础框架和业务逻辑参考显著缩短开发周期。1. 先搞清楚「某CRM旗舰版功能齐全客户管理系统源码.zip」这类包的价值边界从源码站下载一个「某CRM旗舰版功能齐全客户管理系统源码.zip」解压后通常是一套 PHP 源码加一个 SQL 导出包它不是给人打开看看的是要求你自己把它部署起来的。这类包的价值不在代码量多少而在三件事数据落在你自己手里、功能可以按业务改、团队可以在上面持续二开。SaaS CRM 用一年算一笔账之后每年续费源码 CRM 是一次部署后续成本是维护和二开的人工。适合谁中小企业 IT 负责人想自建客户系统外包团队拿来给客户做私有化交付或者企业要求客户数据不能出内网、必须本地部署的项目组。但「功能齐全」四个字只是卖家标签真实情况是每个包的框架、目录结构、PHP 版本要求都不一样直接解压丢进服务器大概率白屏。本文就按这类包最常见的技术形态把环境选型、部署流程、模块核对、故障排查和二开路径一次讲完。2. 源码 zip 解压之前的功课这套 CRM 的常见架构与选型判断手里攥着一个 zip先别急着解压上传。先想明白一件事你下载的是一个「需要环境配合」的程序不是办公文档。十份国内流通的 CRM 源码包八份是 PHP MySQL 形态剩下两份可能是 Java 或 .NET。为什么 PHP 占绝对主流因为这类包大多是 2015 到 2020 年之间做的那个阶段 PHP 源码的传播成本最低虚拟主机、云服务器都能跑部署时不需要编译、不需要 Maven 拉依赖解压改个配置就能进安装向导。Java 版 CRM 源码包也有但通常要配 Tomcat、改 context 路径入门门槛高流通量反而小。你拿到 zip 后第一件事不是解压是通过文件名和包内文件清单反推它是什么技术栈再决定给不给它配环境。2.1 一小时内判断技术栈的四个线索解压前先用 unzip 的列表参数扫一眼不落盘就能看到内部结构。这个习惯能省掉后面大量试错。unzip -l crm_source.zip unzip -t crm_source.zip第一条命令列出 zip 内全部文件路径第二条测试压缩包完整性。看输出时重点抓四个线索有没有 index.php、application 或 app 目录有就是 PHP有没有 pom.xml 或 .jar那是 Java有没有 web.config 或 .aspx那是 .NET有没有 package.json 加 node_modules那是 Node。只看文件路径就能排除一半错误方向。另一个判断点是数据库脚本。unzip -l输出里如果有 install.sql、crm.sql、database.sql 这种整库导出文件说明这套系统需要手动建库导入如果只有 install 目录说明它自带网页安装向导向导会帮你执行建表 SQL。这两种包的部署路径完全不同前者要你准备数据库账号密码后者只需要你在浏览器里填表单。我一般会优先选带安装向导的包因为自动向导会处理表前缀、字符集、初始管理员这些琐碎项手动导 SQL 的文件经常出现编码不对、表前缀写死的问题。2.2 解压到服务器目录归属和权限是第一个翻车点技术栈确认无误后开始真正落盘。这里有个血泪经验不要用 root 解压完再直接跑很多包带着 runtime、cache、upload 目录这些目录在运行期要写文件。root 创建的目录权限是 755归属 rootWeb 服务用户 www 写不进去后果就是登录报错、上传图片失败、验证码不显示排查半天才发现是权限问题。规范操作是先建好运行用户再解压然后单独把可写目录的权限放大。useradd -M -s /sbin/nologin www mkdir -p /data/wwwroot/crm unzip crm_source.zip -d /data/wwwroot/crm chown -R www:www /data/wwwroot/crm find /data/wwwroot/crm -type f -exec chmod 644 {} \; find /data/wwwroot/crm -type d -exec chmod 755 {} \; chmod -R 777 /data/wwwroot/crm/runtime解压命令后的逻辑先建一个不能登录的 www 系统用户作为运行身份再把 zip 释放到 /data/wwwroot/crm然后一次性变更整个目录的归属。644 表示文件只读755 表示目录可进入这两条命令是为了防止源码目录里混入多余的可执行权限。最后单独把 runtime 目录放开到 777是因为模板编译、缓存文件、会话文件都要往这里写权限收紧后框架会直接抛「目录不可写」。注意 runtime 这个目录名在不同包里叫法不一样常见的有 runtime、cache、temp、data/log解压后先 ls 看一眼目录列表找到名字最像缓存目录的那个再赋权。2.3 用 Docker 起 MySQL 5.7 和 PHP 环境一次到位不折腾本机为了一套源码包去改本机 PHP 版本不值得我习惯用 Docker Compose 把运行环境隔离起来。老 CRM 源码包面向的 PHP 版本普遍在 5.6 到 7.4 之间MySQL 这边则跟 5.7 兼容性最好。为什么不用 MySQL 8因为 MySQL 8 默认的认证插件是 caching_sha2_password而 PHP 7.x 自带的 mysqlnd 驱动默认走 mysql_native_password两者握手直接失败报错是「Authentication plugin caching_sha2_password cannot be loaded」。与其去改 MySQL 8 的用户认证插件不如直接用 5.7 镜像少踩一个坑。services: mysql: image: mysql:5.7 container_name: crm-mysql environment: MYSQL_ROOT_PASSWORD: Root123456 MYSQL_DATABASE: crm command: - --character-set-serverutf8mb4 - --collation-serverutf8mb4_unicode_ci volumes: - ./mysql-data:/var/lib/mysql ports: - 3306:3306 php: image: php:7.4-apache container_name: crm-php ports: - 8080:80 volumes: - ./crm-source:/var/www/htmlCompose 文件里两个服务的参数要分开理解。mysql 服务里 MYSQL_ROOT_PASSWORD 是初始化密码MYSQL_DATABASE 会在容器首次启动时自动建好名为 crm 的空库command 段把字符集固定成 utf8mb4这是为了兼容客户备注里的 emoji 和生僻字老库常用 utf8新部署建议一步到位。php 服务用官方 php:7.4-apache 镜像8080 映射到容器 80 端口当前目录下的 crm-source 挂载到 Apache 的站点根目录。这个组合包部署完浏览器访问http://localhost:8080就能进安装向导或登录页。如果安装向导报缺少扩展不要重新编排整个 Compose写个临时 Dockerfile 补齐再构建一次FROM php:7.4-apache RUN docker-php-ext-install pdo pdo_mysql mysqli \ docker-php-ext-install mbstring fileinfo \ docker-php-ext-enable opcache构建命令是docker build -t crm-php:7.4 .然后把 Compose 里 php 的 image 改成 crm-php:7.4。这四行扩展是 CRM 系统的刚需pdo_mysql 和 mysqli 负责数据库连接mbstring 处理中文编码fileinfo 是文件上传时校验 MIME 类型的依赖很多源码包在文件上传功能里直接调用 finfo 类没装这个扩展会报「Class finfo not found」。opcache 不是必须但装上后 PHP 执行效率有明显提升编译一次可以长期用。2.4 数据库导入和配置文件黑匣子也能拆开看带安装向导的包浏览器里填完数据库地址、账号、库名就能自动建表这部分没有太多可讲的。怕的是那种不带向导、只给你 SQL 文件的包这时需要手动导库。导之前先确认文件里的表前缀有些包默认前缀是 crm_有些是随意写的改配置文件时必须用同一个前缀否则框架找不到表。mysql -h127.0.0.1 -uroot -pRoot123456 crm crm.sql mysql -h127.0.0.1 -uroot -pRoot123456 -e USE crm; SHOW TABLES;第一条命令把 crm.sql 导入刚建好的 crm 库注意 -h 写成 127.0.0.1不要写 localhost。在 MySQL 里这两种写法走的通道不一样localhost 默认走 unix socket127.0.0.1 走 TCPPHP 容器连接数据库时走的是 TCP如果在导入时用了 localhost 导致权限校验方式不一致后续会出现「连接被拒」的怪问题。第二条命令列出所有表目的是核对表前缀和表数量如果一张表都没有说明 SQL 文件里可能带了 CREATE DATABASE 语句而当前客户端没权限执行需要打开 SQL 文件把建库语句删掉只保留建表部分。配置文件是最后一道关。PHP 写的 CRM 配置路径千奇百怪常见的有config/database.php、application/database.php、includes/config.inc.php。找到后改四个值就够数据库地址、库名、账号、密码。如果包内 README 没写配置文件位置用 grep 搜关键词最快。grep -rl DB_HOST\|db_host\|database.*host /data/wwwroot/crm --include*.php这条命令会把所有包含数据库连接关键词的 PHP 文件路径列出来一般第一个命中就是配置文件。打开后把 localhost 改成 127.0.0.1 这类实际地址账号密码改成刚建好的保存后重启 PHP 容器源码包就能跑起来了。到这里部署路径已经走通一半剩下的是登录进去核验功能完整性。3. 功能齐全到底齐在哪模块清单、权限模型和数据表对照部署成功只是开始接下来你要回答的问题是这个包的「旗舰版功能齐全」有没有掺水。判断依据不是页面上的菜单数量而是数据库里的表和关键字段。菜单可以随便堆按钮点了报错也没人管表结构骗不了人。一套正经 CRM 至少要有客户、联系人、商机、合同、跟进记录、回款计划、工单这七个核心域的支撑每个域对应一组数据表和关联关系。下面这套对照表是我核对源码包功能时固定会走的清单你也可以按这个思路去盘你手上那个包。3.1 七个核心模块和它们的数据库影子先把一个真实 CRM 的核心模块列出来对着表检查你手里的包模块功能职责数据库表形态关键字段客户管理客户档案、公海池、分配回收crm_customerstatus, owner_uid, in_pool联系人客户下的多联系人crm_contactcustomer_id, mobile, position商机管理销售漏斗、阶段推进crm_opportunitystage_id, amount, expect_deal_date合同管理合同登记、审批、归档crm_contractcontract_no, amount, sign_date跟进记录电话、拜访、回访日志crm_follow_logcustomer_id, content, next_follow_time回款计划分期回款、逾期提醒crm_receipt_plancontract_id, plan_date, status工单售后售后问题流转crm_ticketticket_no, priority, status这个表格的价值在于你可以在数据库里快速验证。你有没有注意到这七个表之间是关联的联系人挂在客户下面商机挂在客户下面合同挂在商机或客户下面回款计划挂在合同下面。一个功能齐全的 CRM表之间外键可以不建但逻辑关联必须存在也就是说 crm_contact 里必须有一列 customer_id 指向 crm_customer。有些伪「齐全」的包联系人表和客户表毫无关系这种包上线跑一个月你就想扔了。3.2 公海池和权限模型两个最能看出成色的功能公海池是这个品类区别于普通客户登记表的标志性功能。逻辑是客户在分配人手里超过 N 天没跟进自动掉回公海池其他销售可以认领自己也可以主动把无效客户放回公海。对应到数据库crm_customer 表里一般有两个关键字段owner_uid 表示当前归属人in_pool 表示是否在公海。回收逻辑不是前端按钮是服务器定时任务扫描 next_follow_time 和 last_follow_time超期就把 owner_uid 置空、in_pool 置 1。数据结构允许你查出「这个客户谁在看、什么时候掉的、被谁捡走了」这类包才算成熟。权限模型是第二个验成色的点。多数源码包是 RBAC 模型user 表存用户role 表存角色role_user 关联表和 user_auth 表存权限点。数据权限这块做得好的是三档本人数据、本部门数据、全部数据。每张业务表上会有 create_uid 和 dept_id 两个隐含字段查询时框架根据当前用户的角色档位决定要不要拼这两个字段的过滤条件。做粗糙的包只有菜单显隐控制也就是说你点了客户的菜单看到的是全公司所有人的客户这种权限在真实业务里没法用。3.3 用三条 SQL 把包的真实结构查出来核对模块不用去翻源码直接查数据库里的元数据更快。运行这三条 SQL包的功能底细基本就清楚了-- 1. 看所有业务表数量和表名 SELECT table_name, table_comment FROM information_schema.tables WHERE table_schema crm AND table_name LIKE crm_% ORDER BY table_name; -- 2. 看客户表里的关键字段是否齐全 SHOW FULL COLUMNS FROM crm_customer; -- 3. 看角色表和用户数量判断权限体系是否真的生效 SELECT role_id, role_name, data_scope FROM crm_role;第一条语句把和业务相关的表全部列出来如果只有 crm_customer 和 crm_contact 这种零星几张说明包的模块深度有限。第二条语句检查 crm_customer 的字段至少要看到 owner_uid、create_uid、dept_id、in_pool 这四个字段缺少任何一个都意味着公海池或数据权限是假的。第三条语句查询角色表data_scope 字段的值一般是 1、2、3对应全部、部门、本人如果没有这个字段说明数据权限只有菜单级控制。这三条 SQL 跑完你对该不该在这个包上继续花时间心里基本有数了。3.4 跟进记录怎么存时间线和下次跟进时间的设计跟进记录是 CRM 最容易被忽略但一天都不会少用的模块。这里有一个常见设计跟进记录和待办提醒是一体的。crm_follow_log 表存每次跟进内容同时记录一个 next_follow_time系统每天跑定时任务扫出 next_follow_time 在今天之前的客户给负责人生成待办或站内通知。这个设计验证起来也简单查最新一条跟进记录和客户表上的 last_follow_time 是否一致再看看有没有定时任务的脚本文件。SELECT customer_id, content, create_time, next_follow_time FROM crm_follow_log WHERE customer_id 1001 ORDER BY create_time DESC LIMIT 10;这条 SQL 把某个客户最近的跟进按时间倒序列出来观察点有两个next_follow_time 是否由界面上的「下次跟进时间」控件写入以及 create_time 和写入时间是否匹配。如果 next_follow_time 全是 NULL说明提醒功能是摆设页面控件只是存了个寂寞。这个字段直接决定了你未来要不要在这个包上做二次开发一个连跟进闭环都做不完整的 CRM二开成本会把你拖垮。4. CRM 源码部署避坑指南5 个让人想摔键盘的故障同一个源码包在不同人手里命运完全不同。有人半小时跑起来有人折腾一天还是白屏。下面这五个坑是我反复在客户服务器上排过的按出现频率排序列出来每条都是「现象 → 原因 → 解决」的结构你可以直接当排查手册用。4.1 安装向导或登录页白屏浏览器 F12 看到 HTTP 500这是遇到最多的现象。原因基本锁定在 PHP 版本不兼容。老源码包用了大量 PHP 5.x 时代的函数比如 each()、split()这些函数在 PHP 7.2 以后被移除一旦调用直接 fatal error同时很多虚拟主机默认把 display_errors 关掉fatal error 被吞掉页面就是纯白。解决办法分两步先确认版本再打开报错显示。php -v php -m | grep -E pdo_mysql|mysqli|mbstring|fileinfo|curl第一条看当前 PHP 版本7.4 以下比较稳如果已经在 8.0 以上直接换容器重新跑PHP 8 对老代码的破坏性改动太大不值得一个个改。第二条检查扩展列表缺哪个补哪个常见缺 fileinfo 和 mbstring。如果版本没问题且扩展齐全临时把错误显示打开在入口 index.php 第一行加ini_set(display_errors, 1); error_reporting(E_ALL);刷新页面就能看到具体报错行号按报错去找源码对应的函数。4.2 首页能开点菜单就 404这种问题几乎都出在伪静态规则没配。老 PHP 框架的 URL 是 index.php?mhomecuseraindex 这种 queryString 风格后来为了美观改成 pathinfo 风格index.php/home/user/index。Apache 下 .htaccess 自动生效Nginx 不吃 .htaccess必须手写 rewrite 规则。没有规则时首页 index.php 能访问但 /home/user/index 这个路径找不到对应文件直接 404。Nginx 的 location 规则要放到站点配置里location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s$1 last; } }参数说明if (!-e $request_filename)表示文件不存在才走重写存在就直接返回静态文件rewrite把路径参数拼到 s 参数上对应框架的 PATH_INFO 解析入口。不同框架这里不一样ThinkPHP 3.x 用 s 参数Laravel 用rewrite ^(.*)$ /index.php/$1 last;。你那个包到底用哪种看入口文件里解析参数的方式或者看包内有没有现成的 nginx.conf 示例。4.3 安装向导提示数据库连接失败但命令行能连这个现象很有迷惑性你在服务器上用 mysql 命令能连数据库网页向导却说连不上。原因是 PHP-FPM 进程和你的 shell 进程访问数据库时走的网络通道不同。常见有两种情况MySQL 8 的 caching_sha2_password 认证插件老版 PHP 的 mysqlnd 不认或者在安装向导里填数据库地址 localhostPHP 容器里解析到了 unix socket而 MySQL 容器只监听了 TCP 3306 端口。解决方案按优先级排先看 MySQL 版本5.7 最省事如果已经是 8.0不要改全局认证插件配置单独给这套系统建一个 mysql_native_password 用户影响最小最后检查配置里的连接地址容器化部署一律填127.0.0.1:3306别填 localhost。改完重启 PHP 容器再试这个坑基本一次解决。4.4 登录后一分钟就掉线或者验证码图片一直不显示掉线和验证码失效是同一类坑的两种表现根因都指向会话存储。PHP 默认把 session 文件写到 /tmp 或 /var/lib/php/sessions这个目录的拥有者必须是运行 PHP 的用户。如果目录属于 rootwww 用户写不进去session_start 失败登录状态存不住验证码那种把值写 session 的功能自然全废。解决就是把目录归属改掉chown -R www:www /var/lib/php/sessions chmod 733 /var/lib/php/sessions注意目录权限是 733 而不是 777因为 session 文件本身要 600 权限目录可写即可多给权限反而有风险。如果改完还掉线检查 php.ini 里 session.save_path 是否指向别的目录有的镜像默认指向空路径需要 uncomment 并把路径改到实际存在的目录然后重启 PHP-FPM。4.5 定时任务不触发公海回收、跟进提醒全不跑页面功能都正常但客户回收、跟进提醒、合同到期预警这些「自动」功能全都没反应。原因是这类功能依赖 crontab 调度源码包交付时不会帮你把 crontab 也配上。源码里一般有个 cli 目录或者一个单独的控制脚本负责执行这些任务。crontab -e # 每 30 分钟执行一次跟进提醒扫描 */30 * * * * /usr/bin/php /data/wwwroot/crm/cli/remind.php /dev/null 21 # 每天凌晨 2 点执行公海回收 0 2 * * * /usr/bin/php /data/wwwroot/crm/cli/pool_recycle.php /dev/null 21第一行解释crontab 的五个星号分别是分钟、小时、日、月、星期*/30表示每 30 分钟一次。第二行的0 2 * * *是每天凌晨两点。路径里的 cli 目录名各包不同可能是 cli、cron、shell解压源码后用find /data/wwwroot/crm -name *.php | xargs grep -l pool找到具体脚本。比较稳妥的做法是先手动执行一次脚本看有无报错确认脚本能跑通再交给 crontab否则你会在凌晨收到莫名其妙的告警邮件。5. 拿源码之后的下一步用 git 建基线、加客户字段、做验收清单部署通了绝对不是终点。我拿到任何源码包后的第一个动作不是去登录后天看界面而是给源码建 git 基线。这个习惯救过我太多次源码包是别人交付的你没法保证他有没有改过东西建基线后你能看到每一次改动的 diff出了问题也有后悔药吃。在源码目录里执行git init git add -A git commit -m init: 导入CRM源码基线。提交时注意先建一个 .gitignore把 runtime 缓存目录、上传目录、数据库配置文件排除掉这些文件属于运行期artifact每次生成的内容都不一样提交进去只会制造噪音/runtime/* /upload/* /config/database.php .env提交完基线改一个最常见的需求给客户表加一个「客户等级」字段。先写 SQL 加字段再找到客户编辑页模板和保存逻辑文件通过 grep 搜固定关键词定位代码位置。// 新增字段后保存逻辑里的追加代码 $data[customer_level] I(post.customer_level, 0, intval); M(customer)-where(id . intval($_POST[id]))-save($data);这节代码说明客户表单提交后把页面传过来的 customer_level 字段强制转成 int再写入客户表。M(customer) 是框架的模型方法指向 crm_customer 表I() 方法是 ThinkPHP 常见的参数获取函数第二个参数 0 是默认值。改完目录用 git diff 看一眼修改范围确认没有把别的东西蹭进去。最后验收这套源码值不值得继续投入我会按这个清单过一遍一能否跑通「新建客户 → 记跟进 → 转商机 → 签合同 → 做回款计划」的完整链路二换一个非管理员账号登录确认数据权限真的生效三手动改一条记录的归属人验证分配和回收逻辑四把服务器时间改到跟进提醒触发点看能否生成待办五备份一份数据库和源码到另外一台机器演练一次恢复过程。五项全过这个包就具备上线条件。我自己的习惯是任何源码包到手先花半天时间在本地把部署和核验跑完再决定是否引入生产环境这半天永远比上线后救火划算。每接手一套新的包把本机 Docker 环境和常用排查命令固化成一个crm-deploy.md笔记下次遇到相似包直接按笔记走。希望帮到你。本文还有配套的精品资源点击获取