简介这是一套基于likeadmin-php开发的开源家政上门预约系统完整源码适用于希望搭建本地生活服务或家政O2O平台的开发者与创业者。系统提供用户端与师傅端双端融合架构覆盖地图定位、在线预约、系统派单、后台派单、下单支付、核销订单等核心业务闭环后台基于Thinkphp框架、前端采用Vue与Uniapp技术栈支持小程序与H5端运行。资源共计2000个文件以js脚本、vue组件、css样式为主要构成另含java服务端代码、md说明文档与json配置文件压缩包整体86.93MB目录结构清晰便于二次开发。支付已对接微信与支付宝官方渠道地图对接腾讯地图存储支持本地与OSS并可个性化设置预约时段、服务多规格、首页DIY及师傅保证金与每日限单规则。已有114人学习适合具备PHP和Vue基础的开发者获取一套可直接部署上线的家政平台开源方案。1. 家政系统开源版源码先别急着解压这套 likeshop 包到底能给什么拿到likeshop_家政系统开源版源码.rar这样的压缩包第一反应通常是解压、导入数据库、登录后台然后就能做在线预约保洁了。但等你真正在本地跑完一遍会发现这套代码更像是一个「装了家政模块的电商脚手架」用户体系、订单流程、后台权限、支付回调都是现成的而家政特有的服务项目、技师派单、预约时间段这些业务逻辑需要自己往前补一层。它解决的是从 0 到 1 的搭建问题不是从 1 到 100 的运营问题。这套源码最适合两类人。一类是接外包还没开工的开发者需要快速给客户演示一个家政小程序先看后台能不能维护服务项目、看订单能不能正常流转另一类是准备系统学 ThinkPHP 全栈流程的初学者把 likeshop 的目录结构和家政业务结合起来比只看教程更容易落地。如果你期待解压后打开小程序就能下单、支付、派单一条龙全自动那大概率会失望——它给出的是一块可加工的半成品不是一个能直接营业的成品。2. 部署前的三件事环境选型、目录梳理与数据库初始化likeshop 家政系统的技术底座是 ThinkPHP 6.0这套框架对 PHP 版本和扩展有比较具体的要求。很多人卡在第一步不是代码问题而是本地环境里的 PHP 版本太新或者太老导致安装包里的函数没法跑。先把环境选型定下来后面的一切才有意义。2.1 运行环境选型为什么是 PHP 7.4 MySQL 5.7 Redis基于 likeshop 开发的系统在官方文档里通常建议 PHP 7.4原因很直接ThinkPHP 6.0 要求 PHP 版本大于等于 7.2但 PHP 8.0 出来之后不少老代码里依赖的each()、create_function()这些函数被移除了如果你拿一套 2023 年前写的家政源码跑在 PHP 8.1 上很可能会在支付回调或者队列处理时撞上「Call to undefined function」的报错。反过来如果装在 PHP 7.0 上框架本身的新语法又不支持。所以我的习惯是本地统一用 PHP 7.4线上如果确实要上 8.0先用服务商提供的配置切换到 7.4 跑通再说。数据库版本选 MySQL 5.7 而不是 8.0不是 8.0 不行而是这套源码里的 SQL 建表语句大概率使用了「datetime」默认值、ENGINEInnoDB这类兼容写法MySQL 8.0 对默认值和严格模式要求更严导入时容易出现Invalid default value的警告。5.7 是 ThinkPHP 类项目里用户量最大的组合踩坑资料也最多。Redis 主要用来处理验证码、登录 token 和部分队列数据家政系统里常见的场景是「师傅端轮询新订单」如果没有 Redis用数据库轮询也能跑但并发上来之后数据库连接会被拖死。我一般建议只要源码里带了 queue 或 cache 配置就老老实实装一个 Redis 6.x成本很低。2.2 解压后的目录怎么看懂业务代码和框架代码的边界拿到压缩包后不要急着双击运行先看目录。常见 likeshop 源码解压后大致是下面这种结构likeshop_home_service/ ├── app/ # 应用目录业务代码主要在这 │ ├── admin/ # 后台管理端模块 │ ├── api/ # 小程序/App 接口模块 │ └── common/ # 公共函数、模型、服务类 ├── config/ # 配置文件路由、数据库、缓存 ├── public/ # 入口目录站点根目录必须指向这里 │ ├── index.php # 唯一入口文件 │ └── install/ # 可视化安装脚本如果有 ├── route/ # 路由定义 ├── runtime/ # 运行时日志、缓存需要可写权限 ├── sql/ # 数据库初始化脚本 └── .env # 环境变量配置部署时要改的核心文件看清楚这个边界很重要。app目录里admin和api是两个不同入口一个给后台网页用一个给小程序用两者的登录态不能混用。public才是 web 服务器要指向的根目录如果你把站点根目录指到项目根目录会出现访问http://域名/index.php能打开但静态资源全部 404 的情况。runtime目录如果不能写入页面会直接白屏报错却不显示这是很多人装完系统后最常见的第一道坎。2.3 本地用 PHP 内置服务器跑通的最小命令如果你只是想先在本地看一眼不打算立刻配 Nginx可以使用 PHP 内置服务器。下面是一组能跑通的最小命令# 解压源码包rar 格式在 Linux 下用 unrar 或 7z unrar x likeshop_家政系统开源版源码.rar cd likeshop_家政系统开源版源码 # 复制环境配置如果包内没有 .env.example就手动创建一个 .env 按模板写 cp .env.example .env # 创建数据库并导入初始数据 mysql -uroot -p -e CREATE DATABASE likeshop_home DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; mysql -uroot -p likeshop_home sql/likeshop_home.sql # 启动 PHP 内置服务端口用 8080避免和已有服务冲突 php think run --host 0.0.0.0 --port 8080这里的逻辑是先用unrar x解压到当前目录注意x参数会保留完整路径而不是e把文件全部平铺。cp .env.example .env是为了生成独立的环境配置这样代码里写死的配置不会污染到本地环境。导入数据库时一定要指定utf8mb4因为家政系统里用户昵称、服务地址里可能有 emojiutf8会报Incorrect string value错误。最后用php think run启动它是 ThinkPHP 自带的开发服务器命令等价于手动启动php -S 0.0.0.0:8080 -t public但会自动处理public/index.php的路由。2.4 数据库初始化时必改的三个参数目录能跑起来之后第一时间打开.env文件找到数据库相关配置。最核心的是下面这一组APP_DEBUG true [DATABASE] HOSTNAME 127.0.0.1 HOSTPORT 3306 DATABASE likeshop_home USERNAME root PASSWORD 123456 PREFIX ls_第一个必改参数是PASSWORD很多人从网上下载源码包里默认带一个密码本地一看PASSWORD root如果刚好你的 MySQL root 不是这个密码连接会失败页面提示SQLSTATE[HY000] [1045] Access denied for user。第二个关键参数是PREFIXlikeshop 默认数据表前缀是ls_但家政二开版本可能改成了home_或ms_。如果源码里 SQL 建的表是ls_user而你.env写的是home_user后台能进但列表全部空白因为 thinkphp 查询器会自动拼接前缀。第三个要改的是DATABASE要和你在命令行里创建的库名完全一致注意大小写MySQL 在 Linux 下对大小写敏感Likeshop_Home和likeshop_home是两个库。改完.env后不要急着刷新页面先执行一次php think clear清掉配置缓存。ThinkPHP 会把.env的内容缓存到runtime目录里如果之前启动过一次配置改动不会立刻生效。这个动作看起来像玄学实际上是因为框架为了性能默认缓存了配置清完缓存再访问才真正加载新的数据库前缀。3. 把一条家政订单从「选服务」跑到「接单结算」后端逻辑与数据表关系能够登录后台只算完成了 30%家政系统真正核心的价值在于订单链路是否闭环。用户在小程序里选了保洁服务选择了时间段提交订单支付成功师傅端出现一条新订单开始服务服务结束订单进入结算状态。这一整套流程依赖数据表之间的外键关联和状态字段的流转单独看一眼order表看不出全局必须把服务、技师、订单、支付四张表放在一起理解。3.1 服务项目、技师、订单的三张核心表长什么样likeshop 的通用模型里已经有goods商品和user用户家政二开通常会在此基础上增加service、technician、order三张业务表。我一般会先打开 SQL 文件搜索CREATE TABLE把这三张表的关系画出来逻辑如下ls_service表存放服务项目字段包括id、name、price、original_price、duration、status、sort。这里的duration用于计算预约冲突比如一次保洁是 2 小时某个技师在上午 10 点到 12 点已经排了单就不能再接受同一时间的订单。ls_technician表存放技师信息字段包括id、name、mobile、avatar、service_ids、status。service_ids通常以逗号分隔的字符串存储比如1,3,7这种设计查询简单但统计每个技师服务了多少项目时比较别扭需要FIND_IN_SET查询。ls_order表是订单主表除了基础的用户、金额字段家政场景会增加technician_id、service_time、address、status字段。status一般用数值表示例如 0 待支付、1 待派单、2 已接单、3 服务中、4 待验收、5 已完成、6 已取消。这三张表的关系是ls_order通过service_id引用ls_service通过technician_id引用ls_technician。在后台新建订单时如果technician_id为空订单会进入「待派单」状态需要管理人员手动指派如果用户选择了指定技师下单时就直接绑定。这里最容易出的问题是没有做「技师和时间的唯一索引」导致同一技师同一时间段被预约两次后下单的用户会在服务当天被放鸽子。3.2 下单到支付的回调流程状态字段怎么流转家政订单的状态流转不是只在 PHP 代码里改status它通常由三条链路共同驱动用户在小程序端提交订单、支付平台异步回调、管理员后台手动操作。下面是一段简化后的状态更新逻辑我用 api 模块的订单模型来说明// 订单提交后先写订单再创建支付单 public function createOrder($userId, $serviceId, $serviceTime) { try { $service Service::find($serviceId); // 检查技师是否可预约 $exist Order::where(service_time, $serviceTime) -where(technician_id, $service-technician_id) -whereIn(status, [1, 2, 3]) -find(); if ($exist) { throw new Exception(该时间段已被预约请更换时间); } // 生成唯一订单号 $orderNo date(YmdHis) . random_int(100000, 999999); $order Order::create([ order_no $orderNo, user_id $userId, service_id $serviceId, technician_id $service-technician_id, service_time $serviceTime, amount $service-price, status 0, // 待支付 ]); // 创建支付单这里只记录真正调用支付在下一层 Payment::create([ order_id $order-id, order_no $orderNo, amount $service-price, channel wechat, // 微信支付 status 0, ]); return $orderNo; } catch (\Exception $e) { // 记录日志到 runtime/log Log::error(创建订单失败 . $e-getMessage()); throw $e; } }这段代码的逻辑要点有三个。第一个是预约冲突检查使用了whereIn(status, [1, 2, 3])把「待派单、已接单、服务中」三种状态统一判定为占位状态只有待支付和已取消的订单可以允许其他用户下单。第二个是订单号生成date random_int在高并发下仍有可能重复更好的做法是加OrderNo::get()封装它内部会加一个数据库唯一索引重试机制。第三个是支付单表和订单表分开原因是一笔订单可能尝试多次支付渠道或者存在部分退款单独一张payment表可以记录每一次支付尝试的结果避免改原订单字段把主流程搞脏。3.3 师傅端接单的接口逻辑状态机与并发保护师傅端接口通常挂在app/api模块下功能是「查询我的待接单列表」和「点击接单」。这里的核心不是让师傅看到订单而是两个动作之间的状态转换是否原子。常见的小白写法是这样// 接单动作错误示范没有乐观锁 public function accept($orderId, $technicianId) { $order Order::find($orderId); if ($order-status ! 1) { return json([code -1, msg 订单已被接走]); } // 这里两个请求同时进来会都通过检查 $order-technician_id $technicianId; $order-status 2; $order-save(); }这个写法在并发环境下会翻车。两个师傅同时点击同一个订单两个请求都读到了status 1然后都执行save()最后这个订单被第二个师傅覆盖第一个师傅看到自己「接单成功」但后台其实已经换人了。正确做法是加上条件更新的乐观锁// 接单动作正确示范把状态条件放到更新语句里 public function accept($orderId, $technicianId) { $affected Order::where(id, $orderId) -where(status, 1) -update([ technician_id $technicianId, status 2, ]); if ($affected 0) { return json([code -1, msg 手慢了订单已被其他师傅接走]); } // 记录接单日志 OrderLog::create([ order_id $orderId, type accept, operator $technicianId, ]); return json([code 0, msg 接单成功]); }这里的affected是数据库受影响行数只有状态确实从 1 变成 2 时才返回 1如果是 0 就说明条件不满足订单已经被处理过。这种「状态写在 where 里」的做法是状态机落地的关键。另外要补一个ls_order_log操作日志表记录每一次状态变更后续排查「为什么这个订单被取消了」时就不用问其他人后台翻聊天记录了。4. 改造成自己品牌的家政系统二次开发三个典型切入点家政系统的开源版源码不是给你原样上线的它更像一个起跑器。上线的第一步是改品牌信息第二步是把服务类目改成你所在城市真正能卖的产品第三步是接上你自己的支付商户号。这三个切入点覆盖了 90% 的轻量定制需求改完基本可以交付。4.1 新增一个「保洁深度保洁」服务包要动几张表假设你的平台现在只卖「日常保洁」要新增一个「深度保洁」服务包包含擦玻璃、高温消毒、地板打蜡三个子项目。在 likeshop 的既定模型里最省事的方式是继续沿用ls_service表新增一个service记录再在service_item子表里记录三个子项目。数据上的改动是两张表-- 新增服务主记录 INSERT INTO ls_service (name, price, original_price, duration, status, sort) VALUES (深度保洁, 299.00, 399.00, 4, 1, 10); -- 新增服务子项这里假设新服务 id 21 INSERT INTO ls_service_item (service_id, item_name, sort) VALUES (21, 擦玻璃, 1), (21, 高温消毒, 2), (21, 地板打蜡, 3);这里有个设计选择要注意为什么不直接在service表里加一个description字段存 HTML 片段因为家政服务有「验收」环节用户下单后需要能看到具体的服务标准把子项目单独成表订单验收页就可以循环输出每一项检查点而不是让前端去解析一串带换行的字符串。新增服务后要检查一遍technician表里的service_ids是否包含21否则前台服务列表能看到但师傅端永远接不到这类订单。如果你有二十个技师最快的 SQL 是UPDATE ls_technician SET service_ids CONCAT(service_ids, ,21) WHERE FIND_IN_SET(1, service_ids);表示做过日常保洁的技师自动开通深度保洁这个逻辑要看业务是否需要不是无脑执行。4.2 把微信支付换成聚合支付的改动点家政系统里最常见的一笔「额外费用」是用户在服务中临时增加的项目比如原本只做保洁现场又要求拆空调滤网。这部分费用走原订单的微信支付会碰到一个问题原订单金额已经支付完成服务未完成时无法发起部分退款或加款。所以线上方案一般是「订单金额 服务中加项」两条支付通道主流程走微信支付加项走聚合支付或者现场扫码。源码里支付模块的改动点集中在app/common/service/pay目录常见配置项如下// config/pay.php 中的支付渠道配置 wechat [ app_id wx1234567890abcdef, mch_id 1600000000, key your-api-v2-key, notify_url https://yourdomain.com/api/pay/notify/wechat, cert_path runtime_path() . cert/apiclient_cert.pem, key_path runtime_path() . cert/apiclient_key.pem, ], alipay [ app_id 2021000000000000, private_key MII..., public_key MII..., notify_url https://yourdomain.com/api/pay/notify/alipay, ],这里要特别关注notify_url。很多人把回调地址写成了http://127.0.0.1本地测试没问题上线之后支付平台回调会被 Nginx 拦截返回 404。改这个配置前先确认服务商平台里配置的域名已经备案并且http和https不混用。微信支付的cert_path指向的是runtime/cert目录这个目录在.gitignore里通常被忽略从源码包复制过来时不要把证书文件传错位置否则支付接口会报缺少证书。改完支付配置后保险的验证方式是调用一次「统一下单」接口看返回的prepay_id是否正常不要等用户真下单才去查日志。4.3 小程序端的首页定制配置化轮播与服务分类家政系统的小程序端如果是基于 uni-app 开发的首页通常不是写死的布局而是走后端返回的接口。比如home/index接口返回轮播图列表、金刚区图标、推荐服务列表小程序的pages/index/index.vue通过v-for渲染。改首页品牌信息时不需要找前端代码直接在后端配置里改图# 后端配置存储位置一般在 admin 后台的「首页装修」菜单 # 或者直接查表 ls_home_page如果源码包里没有装修菜单最简单的方法是把轮播图路径替换成自己的图片前端接口不变。但如果想调整首页模块顺序比如把「优惠券」模块从第二位挪到第三位就得改pages/index/index.vue里的pageConfig数据源了。这里的一个细节是uni-app 项目编译后的小程序包会缓存接口返回内容改完后台配置后小程序里看到的是旧数据需要在开发者工具里清除缓存并重新编译。不要一上来就改前端逻辑先确认是不是缓存问题这是给客服省时间的一步。5. 家政系统源码里最容易踩的 5 个坑现象、原因与解法源码能跑通只是开始真正上线前的问题集中在部署细节和业务边界。下面这五个坑是我在配置 likeshop 家政系统时反复见过的每一条都是「现象 → 原因 → 解决」的结构可以直接对号入座。5.1 安装后访问首页 500日志里提示找不到模板现象后台能登录但访问小程序端首页接口时返回 500runtime/log日志里出现Template file not found或the template file ... does not exist。原因likeshop 的模板引擎默认从app/view目录加载模板但家政二开版本里接口返回的是 JSON 数据不需要模板渲染。config 文件中的default_return_type如果被改成html每个接口都会尝试加载.html模板自然就 500 了。解决打开config/app.php找到default_return_type html改为json然后执行php think clear。如果你不想全局改也可以在app/api模块基类控制器里写return type声明的属性。这种 500 不报 SQL 错只看页面永远找不到原因先看日志才是正确姿势。5.2 订单支付成功但状态没变微信支付回调 URL 和签名现象用户在小程序里付完款订单状态仍停留在「待支付」后台却能看到支付的微信账单。原因支付回调地址没有对公网开放或者支付通知没有正确验签。微信异步通知默认以 POST 方式请求notify_url如果这个地址在测试环境里被防火墙拦住了回调请求根本到不了你的服务器。更隐蔽的是回调数据里的out_trade_no和你生成的订单号不一致。解决在config/pay.php中确认notify_url是https://你的域名/api/pay/notify/wechat。然后在回调方法里先取request-post()中的result_code再用微信 SDK 的decrypt校验签名验签通过才更新订单状态。本地调试时可以在回调方法里加一行Log::write(wechat notify: . json_encode(input()))真机支付后看runtime/log里有没有这行日志没有就说明请求根本没进来。5.3 师傅端一直显示「待接单」刷新不出来队列积压现象新订单已经生成后台也能看到但师傅端刷新列表始终显示「暂无新订单」或者出现了重复订单提醒。原因家政系统为了提高师傅接单响应速度会在下单成功后通过 Redis 发布一个new_order事件师傅端使用长轮询或 WebSocket 监听。Redis 挂了或者队列消费进程没有启动事件会一直堆积在redis的 list 里前端自然刷不出来。另一个坑是 Redis 缓存了配对的technician_id order_id映射师傅端的NEW_ORDER队列里存的是旧数据。解决检查 Redis 是否在运行执行redis-cli ping看能不能返回PONG。然后看一下config/cache.php的type是不是redis如果是 file 类型队列服务需要使用数据库驱动。确认没问题后重启消费进程php think queue:listen --queuenew_order。以后每次更新订单状态记得在消费完成后del掉对应 key否则同一个订单会推送给师傅 10 遍。5.4 后台修改服务价格小程序端没变化缓存与 opcache现象后台把「日常保洁」价格从 129 改成 159小程序商城里还是显示 129。后台刷新已经看到新价格了但用户端就没有变化。原因服务列表接口在 service 模型里用了cache标签查询结果会被 ThinkPHP 的缓存驱动保存 10 分钟或更久。再叠加 PHP 的 opcache会让人误以为代码没有生效。解决后台改完价格后执行php think clear再清一次 Redisredis-cli flushdb。如果服务列表接口里的查询确实频繁且结果稳定建议在 model 里加一个Cache::tag(service)后台修改服务时主动删除该标签缓存而不是依赖手动清空。这一步不做客户在楼上等你在服务器前脸红。5.5 备份还原后登录被踢session 与 redis 的 key 冲突现象从旧服务器备份数据库和新服务器的 Redis 后后台管理员登录后同时存在两个会话一个有效一个无效或者每次跳转都被要求重新登录。原因likeshop 默认把 session 存到 Redis而备份还原时会把旧 Redis 中的 session 数据也导入新服务器的session_id和旧 session 的id规则不一致导致session校验失败。解决还原数据时只用数据库备份恢复ls_admin、ls_user等业务表不要导入 Redis 的 dump 文件。新环境部署完成后直接在 Redis 里执行flushall清空所有旧会话让用户重新登录。这个操作要在非业务高峰期做同时提醒已经登录的在用用户重新登录一次比让他们在支付时被踢出去体验好得多。6. 用一条 crontab 和一次手工流程验证系统能不能上线家政系统的上线验证不是在后台点两下就结束的而是要模拟一个真实用户走完整条链路。我习惯在上线前盯着屏幕按顺序操作一遍任何一步卡住都能定位到具体模块。你不需要自动化测试工具只需要一个测试账号和一次真实验收。6.1 手工跑一遍完整业务闭环按照下面这张表逐项确认只要有一项卡住就停下来排查不要带着疑问上线步骤操作预期结果1小程序注册账号收到验证码短信可登录2选择日常保洁选定明天上午时间下单成功生成订单号3微信支付 129 元支付成功页出现后台订单状态变「待派单」4管理员后台指派技师师傅端收到新订单提醒5师傅接单状态变「已接单」用户端可看到技师信息6服务完成后师傅上传照片状态变「待验收」用户可确认服务完成7用户确认验收订单变「已完成」师傅端显示可提现金额如果第 4 步里订单不自动派单检查后台是否开启了自动派单没开启就手动指派。如果第 6 步照片上传失败多半是public/uploads目录没有写权限用chmod -R 755 public/uploads解决这一步是家政系统里最「不编程但必须做」的运维动作。6.2 用 crontab 自动处理超时订单系统上线后一定会有用户下了单不付款或者预约了时间但师傅临时缺席。likeshop 里通常自带一个Order::cancelTimeout方法你需要把它挂到系统定时任务里# 每天凌晨 2 点自动取消超过两小时未支付的订单 0 2 * * * cd /www/project/likeshop_home php think order:cancel-expired runtime/log/crontab.log 21这条 crontab 的含义是每天凌晨 2 点执行一次命令order:cancel-expired是命令名你需要确认源码里是否定义了同名 think 命令。如果没有就用下面这条 PHP 方式实现在app/api/command目录新建OrderCancel.php文件在handle()方法里用Order::where(status, 0)-where(create_time, , time() - 7200)-update([status 6])把超时订单标记为已取消。定时任务里加 runtime/log/crontab.log是为了把输出写进文件别小看这个动作排查订单状态异常时它是最直接的证据。6.3 交付前检查的最后一件事我每次交付前都会做最后一个动作把.env里的APP_DEBUG改为false。这一步不只是为了安全更会让 HTTP 接口在出错时返回统一格式的 JSON而不是把 SQL 语句和堆栈路径直接暴露给外部用户。然后清理一遍runtime下的日志文件避免把本地测试的订单数据带到线上环境。这套流程走完likeshop 家政系统才算真正可以交出去。希望帮到你。本文还有配套的精品资源点击获取