简介这份代驾小程序源码基于微信小程序与PHP后端构建版本为135k代驾v1.2.24附带前端代码、后端程序及配置教程面向希望研究代驾业务逻辑或二次开发的开发者与创业者。资源包共3153个文件约50.95MB其中1101个PHP文件构成后端核心577个PNG与135个GIF提供界面素材362个JS与121个CSS支撑前端交互另有80个WXSS、78个WXML及100个JSON等小程序页面与配置文件目录结构完整。功能上覆盖预付定金与抵扣设定、预售期结束自动抵扣课程价格、尾款支付、报名信息填写与后台订单查看并支持多核销员微信扫码一键核销减少人工记录成本。运行环境为Linux或宝塔面板兼容PHP5.6与PHP7.3需认证服务号及MySQL数据库。目前已有741人学习下载适合具备一定PHP与小程序基础的读者下载研究快速理解代驾类项目的完整实现思路。1. 代驾小程序源码拿到手之后135k 代驾 v1.2.24 到底能跑出什么代驾小程序源码这个方向最近问的人明显变多了。我手上这套 135k 代驾 v1.2.24前端加后端一起给还带配置教程属于那种「拿到就能拆、拆完能改、改完能上线试水」的完整包。它解决的不是「代驾业务怎么做大」这种战略问题而是更靠前的一步你手里有一个能跑起来的代驾小程序司机端、用户端、订单流转、计价规则都在你可以直接看它怎么把「用户下单—司机接单—行程计费—订单结算」这条链路串起来。适合谁看三类人。第一类是想做本地代驾、跑腿类小程序的创业者需要一套能快速验证业务的底座第二类是接私活的前后端开发者客户要代驾小程序你不想从零写第三类是想学前后端分离项目实战的学生或转行者这套源码的目录结构、接口分层、数据库设计比很多教学项目更接近真实业务。下面我按「先看懂结构再本地跑通最后改出你自己的东西」这条线讲中间会穿插我踩过的坑和参数怎么调。2. 拆开 135k 代驾 v1.2.24前端、后端、数据库三层怎么分2.1 目录结构先看这三层别急着改代码拿到源码包第一件事不是打开编辑器而是把目录树看清楚。135k 代驾 v1.2.24 的典型结构是前端、后端、数据库脚本三块。前端一般是微信小程序原生或者 uni-app 编译产物后端常见的是 PHP 或 JavaSpringBoot两种这套包我见到的是 PHP 后端居多因为代驾类小项目用 PHP 部署成本低。数据库是 MySQL版本建议 5.7 或 8.08.0 要注意密码加密方式。先执行下面这条命令看整体结构别用鼠标一层层点# 查看源码包顶层目录确认前端、后端、数据库脚本的位置 find . -maxdepth 2 -type d | sort # 输出示例 # ./backend 后端接口代码 # ./frontend 小程序前端代码 # ./database 数据库 SQL 脚本 # ./docs 配置教程和说明文档逻辑说明-maxdepth 2限制只看到两层避免目录太深刷屏。参数说明-type d只看目录不看文件。这一步的目的是让你在改任何代码之前先知道「哪个文件夹是干什么的」。我见过太多人上来就改frontend/pages/order里的页面结果后端接口对不上白改。2.2 后端接口分层控制器、服务、模型别混着改PHP 后端的代驾项目常见框架是 ThinkPHP 或 Laravel。135k 代驾 v1.2.24 的后端一般分三层Controller 接请求Service 写业务逻辑Model 管数据库。计价规则、司机接单逻辑、订单状态机都在 Service 层。你要改「起步价」「里程费」「夜间加价」去 Service 里找别在 Controller 里硬改。// 典型计价逻辑位置backend/app/service/OrderService.php public function calculatePrice($distance, $duration, $isNight) { $basePrice config(price.base); // 起步价配置在 config/price.php $perKm config(price.per_km); // 每公里单价 $nightRate $isNight ? config(price.night_rate) : 1; // 夜间系数 $price ($basePrice $distance * $perKm) * $nightRate; return round($price, 2); }逻辑说明这段是计价核心$distance是里程$duration是时长$isNight判断是否夜间。参数说明config(price.base)这类配置建议单独放配置文件不要写死在代码里否则改价格要翻代码。我一般会把起步价、每公里单价、夜间系数、时长费四个参数做成后台可配这样运营改价不用找你。2.3 数据库表关系订单表是核心别漏了状态字段代驾业务的数据库核心表就几张用户表、司机表、订单表、计价配置表、司机位置表。订单表里的status字段是状态机常见取值0 待接单、1 已接单、2 行程中、3 已完成、4 已取消。这个字段设计不好后面订单流转全是坑。-- 订单表核心字段简化版 CREATE TABLE order ( id int NOT NULL AUTO_INCREMENT, user_id int NOT NULL COMMENT 用户ID, driver_id int DEFAULT NULL COMMENT 司机ID未接单为空, status tinyint DEFAULT 0 COMMENT 0待接单 1已接单 2行程中 3已完成 4已取消, start_address varchar(255) DEFAULT NULL, end_address varchar(255) DEFAULT NULL, distance decimal(10,2) DEFAULT 0.00 COMMENT 里程公里, price decimal(10,2) DEFAULT 0.00, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_status (status), KEY idx_driver (driver_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明status加索引因为司机端要频繁查「待接单」列表。driver_id加索引因为要查某个司机的订单。参数说明decimal(10,2)存金额和里程别用 float否则计价会出现 0.30000000000000004 这种玄学数字。utf8mb4支持 emoji用户地址里可能有特殊字符。3. 本地跑通 135k 代驾 v1.2.24环境、配置、启动三步走3.1 环境准备PHP、MySQL、Nginx 版本别乱选本地跑通这套源码环境版本很关键。PHP 建议 7.4 或 8.0MySQL 5.7 或 8.0Nginx 1.18 以上。如果你用 PHP 8.1 以上部分老代码会有兼容问题比如each()函数被移除。我一般用宝塔面板或者 phpstudy 快速搭环境省得配扩展。# 检查 PHP 版本和必要扩展 php -v php -m | grep -E pdo_mysql|curl|gd|mbstring|openssl # 如果缺扩展Ubuntu 下安装示例 sudo apt install php7.4-pdo php7.4-mysql php7.4-curl php7.4-gd php7.4-mbstring逻辑说明php -m列出已装扩展grep过滤出代驾项目必须的几个。参数说明pdo_mysql连数据库curl调微信接口gd处理图片mbstring处理中文openssl做加密。缺一个都可能报错而且报错信息不一定直说缺扩展可能是「数据库连接失败」这种误导性提示。3.2 数据库导入与配置SQL 文件怎么导、配置文件怎么改数据库脚本在database目录一般是一个.sql文件。导入之前先建库字符集选utf8mb4。导入命令用source比图形界面稳因为大文件图形界面容易断。# 登录 MySQL 并导入 mysql -u root -p CREATE DATABASE daijia DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE daijia; SOURCE /path/to/database/daijia.sql; # 导入完成后检查表数量 SHOW TABLES;逻辑说明SOURCE是 MySQL 客户端命令不是 SQL 语句所以不用分号结尾也可以。参数说明utf8mb4_general_ci是排序规则代驾项目用这个够用。导入后SHOW TABLES确认表都进来了一般 15 到 25 张表。如果少表看 SQL 文件是不是被截断了。配置文件一般在backend/config/database.php或.env文件里。改数据库地址、用户名、密码、库名。改完别急着启动先确认 PHP 能连上。// backend/config/database.php 关键配置 return [ type mysql, hostname 127.0.0.1, database daijia, username root, password your_password, hostport 3306, charset utf8mb4, ];逻辑说明hostname用127.0.0.1比localhost稳因为localhost可能走 socket 连接权限配置不一样。参数说明password别用空密码有些框架会拒绝。charset必须utf8mb4和数据库一致。3.3 前端配置与启动小程序 AppID、接口地址、编译预览前端如果是微信小程序原生用微信开发者工具打开frontend目录。第一件事改project.config.json里的appid换成你自己的测试号或正式号。第二件事改接口地址一般在utils/config.js或common/config.js。// frontend/utils/config.js const config { baseUrl: http://127.0.0.1:8000/api, // 本地调试用本地地址 // baseUrl: https://your-domain.com/api, // 上线换成域名 appId: wx1234567890abcdef, version: 1.2.24 }; export default config;逻辑说明baseUrl是后端接口前缀本地调试指向你本机启动的后端服务。参数说明微信开发者工具里要勾选「不校验合法域名」否则http://127.0.0.1会被拦。上线时必须换成https域名且在小程序后台配置合法域名。version字段有些项目用来做版本校验别乱改。后端启动用 PHP 内置服务器最快# 在 backend/public 目录下启动 cd backend/public php -S 127.0.0.1:8000 # 浏览器访问 http://127.0.0.1:8000/api/test 看是否返回逻辑说明php -S是 PHP 内置开发服务器适合本地调试不适合生产。参数说明127.0.0.1:8000是监听地址和端口端口别和 MySQL、Nginx 冲突。如果返回 404检查public目录下有没有index.php入口文件以及伪静态规则。4. 配置教程里没写全的坑代驾小程序部署常见问题排查4.1 接口 500 但日志没报错先看 PHP 错误日志和权限现象前端请求接口返回 500但后端日志文件空的。原因PHP 错误没写到项目日志而是写到了系统日志或者runtime目录没写权限。解决先看 Nginx 错误日志和 PHP 错误日志再给runtime目录 755 或 777 权限。# 查看 Nginx 错误日志 tail -f /var/log/nginx/error.log # 查看 PHP 错误日志位置 php -i | grep error_log # 给 runtime 目录权限 chmod -R 755 backend/runtime chown -R www-data:www-data backend/runtime逻辑说明tail -f实时看日志php -i看 PHP 配置。参数说明www-data是 Nginx 或 Apache 的运行用户不同系统可能叫nginx或apache。权限给 755 够用777 只建议本地调试。4.2 司机端定位不准坐标系没转换现象司机端地图上位置偏移几百米甚至几公里。原因微信小程序拿到的定位是wgs84而地图 SDK 可能用gcj02没转换。解决在获取定位后做坐标系转换或者统一用gcj02。// 坐标系转换示例wgs84 转 gcj02 function wgs84ToGcj02(lng, lat) { const a 6378245.0; const ee 0.00669342162296594323; let dLat transformLat(lng - 105.0, lat - 35.0); let dLng transformLng(lng - 105.0, lat - 35.0); const radLat lat / 180.0 * Math.PI; let magic Math.sin(radLat); magic 1 - ee * magic * magic; const sqrtMagic Math.sqrt(magic); dLat (dLat * 180.0) / ((a * (1 - ee)) / (magic * sqrtMagic) * Math.PI); dLng (dLng * 180.0) / (a / sqrtMagic * Math.cos(radLat) * Math.PI); return [lng dLng, lat dLat]; }逻辑说明这是标准转换算法lng、lat是原始坐标返回转换后坐标。参数说明a是地球长半轴ee是偏心率这些是固定值。如果你不想自己写可以用现成库但要注意库的坐标系定义。4.3 订单状态卡在「已接单」状态机没加事务现象司机接单后订单状态改了但司机表里的「当前订单」没更新或者反过来。原因两个更新操作没放在同一个事务里一个成功一个失败。解决用数据库事务包起来。// 接单逻辑加事务 Db::startTrans(); try { Db::name(order)-where(id, $orderId)-update([status 1, driver_id $driverId]); Db::name(driver)-where(id, $driverId)-update([current_order_id $orderId]); Db::commit(); } catch (\Exception $e) { Db::rollback(); return json([code 500, msg 接单失败]); }逻辑说明startTrans开始事务commit提交rollback回滚。参数说明where(id, $orderId)是条件update是更新内容。注意并发情况两个司机同时接一单要在where里加status0条件否则会超卖。4.4 小程序真机预览接口不通域名和 HTTPS 问题现象开发者工具里接口正常真机预览请求失败。原因真机不认http://127.0.0.1也不认未备案域名。解决本地调试用内网穿透或局域网 IP上线必须 HTTPS 备案域名。# 查看本机局域网 IP ifconfig | grep inet | grep -v 127.0.0.1 # 把前端 config.js 里的 baseUrl 改成 http://192.168.x.x:8000/api逻辑说明真机和小程序开发者工具的网络环境不同真机走的是手机网络。参数说明192.168.x.x是局域网地址手机和电脑要在同一个 WiFi 下。上线时在小程序后台「开发设置」里配置服务器域名必须是 HTTPS。4.5 计价金额对不上浮点数精度和四舍五入现象用户看到的金额和后台算的差几分钱。原因PHP 浮点数运算精度问题或者四舍五入规则不一致。解决金额用整数分存储或者用bcmath扩展计算。// 用 bcmath 计算金额避免浮点误差 $basePrice bcmul(8.00, 1, 2); // 起步价 $distanceFee bcmul(2.50, 3.2, 2); // 里程费 $total bcadd($basePrice, $distanceFee, 2); echo $total; // 输出 16.00逻辑说明bcmul乘法bcadd加法第三个参数是小数位数。参数说明金额建议统一用「分」做单位存整数展示时再除以 100。如果不想改数据库至少计算时用bcmath。5. 从能跑到能改135k 代驾 v1.2.24 的二次开发切入点5.1 改计价规则配置化比改代码更省事这套源码的计价逻辑如果你要改成「起步价 10 元含 3 公里超出每公里 3 元夜间 22 点到 6 点加收 20%」别直接改OrderService.php里的数字。我一般把计价参数抽到数据库配置表后台加个页面让运营自己改。-- 计价配置表 CREATE TABLE price_config ( id int NOT NULL AUTO_INCREMENT, base_price decimal(10,2) DEFAULT 8.00 COMMENT 起步价, base_km decimal(10,2) DEFAULT 3.00 COMMENT 起步含公里数, per_km decimal(10,2) DEFAULT 2.50 COMMENT 超出每公里, night_rate decimal(10,2) DEFAULT 1.20 COMMENT 夜间系数, night_start time DEFAULT 22:00:00, night_end time DEFAULT 06:00:00, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;逻辑说明把计价参数从代码里挪到数据库改价格不用发版。参数说明base_km是起步价包含的公里数超出部分才按per_km算。night_rate是系数1.2 表示加收 20%。night_start和night_end定义夜间时段。5.2 加一个「预约代驾」功能订单表加字段、前端加页面代驾业务里预约单很常见。改造思路订单表加order_type字段0 即时1 预约加appoint_time字段。前端下单页加时间选择器。后端接单逻辑里预约单不立即推给司机而是到时间前 30 分钟才推。ALTER TABLE order ADD COLUMN order_type tinyint DEFAULT 0 COMMENT 0即时 1预约; ALTER TABLE order ADD COLUMN appoint_time datetime DEFAULT NULL COMMENT 预约时间;逻辑说明加字段用ALTER TABLE不影响现有数据。参数说明order_type默认 0老数据自动归为即时单。appoint_time为空表示即时单。改完记得在 Model 里加字段白名单否则写入会被过滤。5.3 司机端接单推送轮询还是 WebSocket代驾司机端要实时收到新订单。常见做法两种轮询和 WebSocket。轮询实现简单司机端每 5 秒请求一次「待接单列表」但服务器压力大、有延迟。WebSocket 实时性好但要额外维护长连接服务。135k 代驾 v1.2.24 默认一般是轮询我建议小规模用轮询司机超过 200 人再考虑 WebSocket。// 司机端轮询示例 setInterval(() { wx.request({ url: config.baseUrl /order/pending, method: GET, success(res) { if (res.data.code 200 res.data.data.length 0) { // 有新订单更新列表 this.setData({ pendingOrders: res.data.data }); } } }); }, 5000); // 5 秒一次逻辑说明setInterval定时请求5000是毫秒。参数说明轮询间隔别低于 3 秒否则服务器扛不住。可以在后端加缓存减少数据库查询。如果司机端在后台运行小程序会限制定时器需要配合订阅消息。5.4 上线前检查清单这 6 项不过别发布上线前我一般过一遍清单第一数据库密码别用 root 空密码第二runtime目录权限确认第三接口域名 HTTPS 且备案第四小程序后台配置合法域名第五计价规则用真实数据跑一遍第六订单状态流转每个环节点一遍。这 6 项里最容易翻车的是第三和第四很多人本地跑通就以为能上线结果真机请求全挂。# 上线前检查 PHP 是否关闭错误显示 php -i | grep display_errors # 应该输出 display_errors Off # 检查 Nginx 是否配置了 HTTPS 跳转 nginx -t逻辑说明display_errors上线必须关否则报错信息会暴露路径和数据库信息。参数说明nginx -t测试配置文件语法改完 Nginx 配置先测试再重启。HTTPS 证书可以用免费证书但必须配。5.5 我踩过最疼的一次数据库没备份就改表最后说个血泪经验。有次给客户改代驾项目的订单表直接ALTER TABLE加字段结果字段类型和现有数据冲突订单表锁了十几分钟客户电话打爆。从那以后我改任何表之前先mysqldump备份再在测试库跑一遍。# 改表前备份 mysqldump -u root -p daijia order order_backup_$(date %Y%m%d).sql # 改完确认数据没问题再删备份逻辑说明mysqldump导出单表$(date %Y%m%d)加日期后缀。参数说明-u root -p是用户名密码daijia是库名order是表名。备份文件别放网站目录放外面。这个习惯帮我省过好几次后悔药。希望帮到你。本文还有配套的精品资源点击获取