轻量级PHP电商系统实战:Workerman队列、长连接与定时任务解析
简介:这是一份使用PHP开发的轻量级高性能电商商城系统源代码包,面向需要快速搭建电商平台或进行二次开发的PHP开发者。系统内置消息队列、动态表单生成、长链接与定时任务能力,便于处理异步任务与业务轮询;提供完善的权限管理、会员管理、产品订单管理及CMS管理模块,支持PC、H5等多端适配,可一键开通短信服务、产品采集、物流查询等第三方接口,降低外部服务集成成本,适合中小型电商项目快速落地。源码包共含2000个文件,以PHP、JavaScript、Vue、CSS等前后端文件为主,辅以较多图片、图标及配置文件,整体大小约77.72MB,目录结构清晰,可快速定位控制器、模型与前端页面。目前已有171人学习下载,无论是学习商城系统的模块设计,还是在此基础上做功能扩展与二次开发,这套源码都能提供扎实的参考价值。
1. 轻量级 PHP 电商系统为什么还要自带队列和常驻进程
很多团队拿到一套 PHP 电商商城系统源码时,第一反应是把它当成传统 PHP 项目,Nginx + PHP-FPM 跑起来就开始搭商品、配订单。但解压这套源码后,如果注意到目录里有 workerman.bat 、 pimple.c 、 random_compat 和 CHANGELOG 这些散落文件,就应该意识到:这不是一个“每次请求都重新加载框架”的简单 PHP 商城,而是一个把队列、长链接、定时任务都揉进 PHP 运行时的轻量级电商系统。它解决了中小电商最常遇到的三个问题:订单超时没人关、接口慢在数据库轮询、商品采集要定期抓却不知怎么调度。相比动辄上 G 的 Java 微服务电商,这套方案可以用一台 2C4G 的云主机扛起初始流量,适合需要快速上线、又要保留二次开发空间的技术团队。
这套 PHP 电商系统源码的精髓不在 CURD 页面,而在常驻内存的进程管理。接下来我从入口路由讲到 Workerman 的队列消费,再拆到业务模块和第三方接口,最后给一份可以直接抄到生产环境的验证清单。
2. 入口与生命周期:从 Nginx 到 index.php 再到容器
2.1 单入口路由与伪静态
这套源码的 Web 入口是 public/index.php ,所有 HTTP 请求都经过它,再由路由组件分发到具体控制器。传统 PHP 项目用 ?r=admin/goods/index 这类参数路由,这套系统则默认使用 pathinfo 模式,URL 形如 /index.php/api/goods/list 。Nginx 下更推荐的配置是重写到 index.php ,让路由更干净,同时让静态资源直接命中:
server {
listen 80;
server_name shop.example.com;
root /var/www/shop/public;
index index.php;
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
}
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
expires 7d;
access_log off;
}
}
这里的细节要注意:如果把 if (!-e $request_filename) 写成 if (-e $request_filename) ,所有真实文件都会被重写掉,静态资源全部 404。我一般会再检查一下 Nginx 的 try_files 是否与框架路由冲突, try_files $uri $uri/ /index.php?s=$uri 在 ThinkPHP 系里也兼容,但上面这种写法更容易排查。
进入 index.php 后,框架先加载 config/ 目录下的配置,再注册全局异常处理和应用容器。这里的关键是,应用容器不只是保存配置数组,还保存了后续队列消费和定时任务都要复用的服务实例。
2.2 用 Pimple 容器组织服务
源码里能看到 pimple 相关文件,说明作者用 Pimple 作为依赖注入容器。Pimple 是一个很小的 PHP 容器,很多轻量级系统用它替代重量级服务容器。在电商系统里,常见的做法是把数据库、Redis、缓存、日志都注册成单例服务,避免每个请求重复初始化。
use Pimple\Container;
$container = new Container();
$container['redis'] = function ($c) {
$redis = new Redis();
$redis->connect($c['config']['redis_host'], $c['config']['redis_port']);
$redis->auth($c['config']['redis_password'] ?? '');
$redis->select((int) ($c['config']['redis_db'] ?? 0));
return $redis;
};
$container['order_service'] = function ($c) {
return new OrderService($c['redis']);
};
return $container;
这里把 redis 声明为匿名函数,第一次调用时才真正连接建立,之后每次 $container['redis'] 拿到的都是同一个实例。对应到电商场景,购物车、库存预扣、黑名单、验证码都共用这一份连接复用;如果像传统写法在控制器里 new Redis() ,高峰期一个请求可能创建十几条连接,Redis 的 maxclients 很容易被打满。 config 数组我建议单独放在 config/config.php ,不要在容器定义里写死主机和端口,这样本地、测试机、生产环境之间部署时,唯一要改的就是这份配置。
2.3 兼容层与前端构建产物
解压列表里的 random_compat 相关文件是 PHP 兼容包。老项目要跑在 PHP 7.4 以下时, random_bytes() 这类函数可能不可用, random_compat 补的就是这个缺口。放到现代 PHP 8.x 环境里它会被自动跳过,但源码作者保留它,说明这套商城在上线时经历过旧版本 PHP 升级。部署前先执行一次 php -v 和 composer check-platform-reqs ,确认环境高于代码里写的 PHP_VERSION 约束。
.babelrc 是前端资源编译的 Babel 配置。也就是说这套源码的管理后台或 H5 端并不是纯 jQuery 老式页面,而是使用 ES6+ 语法,打包后变成 dist 目录下的静态文件。对后端工程师来说,更新前端样式时不要直接改 public/assets 里压缩过的 JS,要去改 src/ 下的源文件,然后执行 npm install && npm run build 。否则下次重新编译会把改动覆盖掉,这也是不少团队反馈“怎么改完刷新没效果”的常见原因。
3. Workerman 在电商里的角色:队列、长链接和定时任务
3.1 常驻进程的启动方式
目录里的 workerman.bat 是 Windows 环境下启动 Workerman 的批处理文件,但生产服务器基本是 Linux,常见启动方式是命令行常驻。这套源码在 ThinkPHP 生态里封装了 worker 命令,可以直接:
cd /var/www/shop
php think worker:start --daemon
--daemon 是守护进程模式,启动后进程退到后台,通过 php think worker:stop 停止, php think worker:reload 平滑重载业务代码。如果没加 --daemon ,关闭 SSH 进程就会跟着死掉。可以用 ps -ef | grep worker 确认进程状态,正常会看到 Master 和多个 Worker 进程。
Workerman 不依赖 Nginx 或 Apache,它自带基于事件循环的 Socket 服务器,因此可以单独监听端口。这套系统里常驻进程通常分三类:
| 进程 | 协议 | 默认端口 | 用途 |
|---|---|---|---|
| HTTP API Worker | tcp/http | 8080 | 对外提供高性能 API,替代部分 PHP-FPM 场景 |
| WebSocket Worker | websocket | 8282 | 后台订单提醒、在线客服、前台消息 |
| Queue Worker | tcp/text | 无固定端口 | 消费 Redis 队列里的订单、短信、采集任务 |
实际生产里,HTTP API 和 WebSocket 可以分开部署,减少业务相互影响。如果一个进程既要处理 HTTP 请求又要维护长连接,某个慢接口会把事件循环阻塞,导致 WebSocket 推送给全部卡住。我的做法是启动多个独立的 Workerman 应用,进程间通过 Redis 解耦。
3.2 Redis 队列:订单超时与消息消费
电商里逃不开的队列场景是订单超时未支付、退货审核、商品采集。这套系统用的队列是在 Redis 的 LIST 上加阻塞读取,也就是典型的 lpush/rpush + blpop 模式。投递方与消费方都只跟 Redis 打交道,不直接依赖彼此。
下面是一个消费者脚本的简化逻辑:
while (true) {
$data = $redis->blPop(['order:close:queue'], 30);
if (!$data) {
continue;
}
$orderId = $data[1];
$order = OrderModel::find($orderId);
if ($order && $order->status == 0) {
$order->status = -1;
$order->close_reason = 'timeout';
$order->save();
// 回滚库存
foreach ($order->items as $item) {
$redis->incrBy('stock:' . $item->sku_id, $item->quantity);
}
}
}
关键的参数是 blPop 的第二个参数 timeout=30 ,意思是阻塞等待 30 秒,没有消息就返回空数组,继续循环,这样可以让 worker 不空转消耗 CPU。弹出的数据结构是数组,第一个元素是队列名,第二个是取出的值。一定要先判断订单状态再关单,避免用户刚支付成功就被定时关单逻辑误杀。
还可以利用 Redis 的 ZSET 做延迟队列:把 score 设为预计执行时间,用 zRangeByScore 扫到期任务,处理完再删除。订单超时这种场景用延迟队列比 sleep 精准得多,不会因为进程重启丢失任务。生产环境要为每条消息加一个唯一 job id,处理成功后写入已消费集合,重启后先扫描未确认消息做补偿,否则消费者崩溃时消息会丢。
3.3 WebSocket 长连接:后台订单提醒与在线客服
长链接在源码里对应 Workerman 的 WebSocket 能力,典型场景是用户下单成功后,后台管理端实时弹出一个新订单提示,或者用户咨询时客服窗口能收到在线状态。WebSocket 服务独立监听 8282 端口,连接建立后要在 onConnect 阶段把用户身份绑定到当前连接 fd:
use Workerman\Worker;
$wsWorker = new Worker('websocket://0.0.0.0:8282');
$wsWorker->count = 4;
$wsWorker->onConnect = function ($connection) {
$connection->onWebSocketConnect = function ($connection) {
$userId = $_GET['user_id'] ?? 0;
$connection->uid = $userId;
$GLOBALS['userConnections'][$userId] = $connection;
};
};
$wsWorker->onMessage = function ($connection, $data) {
// data 是 JSON 格式,如 {"type":"chat","to":123,"content":"hi"}
$msg = json_decode($data, true);
$to = $msg['to'] ?? 0;
if (isset($GLOBALS['userConnections'][$to])) {
$GLOBALS['userConnections'][$to]->send(json_encode([
'type' => 'chat',
'from' => $connection->uid,
'content' => $msg['content']
]));
}
};
$wsWorker->onClose = function ($connection) {
unset($GLOBALS['userConnections'][$connection->uid]);
};
Worker::runAll();
这个示例里 user_id 通过 query string 传过来,生产上不能直接信任,WebSocket 的鉴权一般通过 token 换取用户信息再绑定 uid。 $connection->uid 是把动态属性挂到连接对象上,方便消息路由。因为 Worker 是多进程模型, $GLOBALS['userConnections'] 只保存在当前进程内,有四个 Worker 进程时,一条推送不一定落在目标连接所在进程。要跨进程推送,需要通过 Redis 频道订阅,或者使用 GatewayWorker 组件做分布式消息分发,这是长连接方案从单机到多机扩展时最容易踩的坑。
3.4 定时任务:扫单、同步物流
普通 PHP 项目要做定时任务通常直接用 crontab,但持久化任务状态、查看上次执行时间、避免重复执行,需要框架自带的命令调度。这套源码里把扫订单、生成每日对账单、抓取采集商品封装成 think\console 命令,然后在 crontab 里写:
* * * * * cd /var/www/shop && php think cancel_order >> runtime/logs/cancel_order.log 2>&1
*/5 * * * * cd /var/www/shop && php think sync_express >> runtime/logs/sync_express.log 2>&1
第一条命令每分钟扫描一次待支付且超过 30 分钟的订单;第二条命令每 5 分钟拉一次物流轨迹。 2>&1 一定要写,否则 PHP 的 warning 会通过 cron 邮件发给 root,而且日志里看不到出错信息。命令内部用 where('create_time', '<', time() - 1800)->where('status', 0) 做扫单时,如果历史订单堆积,必须为 status 和 create_time 建立联合索引,否则一次扫描就是全表慢查询。
共享主机没有 crontab 权限时,可以利用 Workerman 内置 Timer 做秒级调度,但进程重启后定时器会丢失,所以启动脚本里要先做一次历史补偿。我的经验是:能用系统 crontab 就尽量用系统的,把 Workerman 留给实时队列和长连接,不要让定时任务依赖常驻进程的存活状态。
4. 业务模块:权限、会员、产品、订单与 CMS
4.1 RBAC 权限:从表结构到接口鉴权
这套系统的权限管理是标准 RBAC 模型,表结构如下:
| 表名 | 主要字段 | 作用 |
|---|---|---|
system_admin | id, username, password, last_login_time | 后台管理员 |
system_role | id, role_name, status | 角色 |
system_menu | id, title, path, is_menu, status | 菜单/接口 |
system_role_menu | role_id, menu_id | 角色与菜单关联 |
管理员登录成功后,根据角色查出所有允许访问的菜单和接口,写入 Redis 缓存。接口请求时通过中间件做校验:
class PermissionCheck
{
public function handle($request, \Closure $next)
{
$adminId = $request->adminId;
$path = $request->pathinfo();
$allowed = $this->getMenuCache($adminId);
if (!in_array($path, $allowed, true)) {
return json(['code' => 403, 'msg' => '无权限访问']);
}
return $next($request);
}
}
这里的注意点是:RBAC 缓存一定要在角色菜单变更后立刻清掉。常见错误是在控制台勾完权限,前端没反应,排查半天发现管理员的菜单缓存还在。我一般会把菜单缓存 key 设计成 rbac:admin:{$adminId} ,并在角色保存事件里主动删除该角色涉及的管理员缓存。
另一个容易被忽略的问题是按钮级权限。接口鉴权只到 path 粒度不够,后台页面上的“删除”“导出”按钮需要对应到具体规则,建议菜单表加一个 permission 字段,前端根据按钮权限渲染,后端在接口判断时比对 permission 而不是 path 。
4.2 会员体系:注册登录与 JWT
会员模块与后台管理员的区别在于会员端接口都是无状态的,多端(小程序/H5/APP)共用同一套认证。这套源码用的是 JWT 方案,登录成功签发 access_token ,过期后通过 refresh_token 续期。
$header = ['typ' => 'JWT', 'alg' => 'HS256'];
$payload = [
'uid' => $user['id'],
'iat' => time(),
'exp' => time() + 7200,
];
$base64Header = rtrim(base64_encode(json_encode($header)), '=');
$base64Payload = rtrim(base64_encode(json_encode($payload)), '=');
$signature = hash_hmac('sha256', "$base64Header.$base64Payload", config('app.jwt_secret'));
$token = "$base64Header.$base64Payload.$signature";
JWT 的好处是服务端不需要保存会话,但 exp 在签发后固定,用户被禁用后 token 在剩余时间内依然有效,所以敏感操作还要查会员状态再放行。推荐把 jwt_secret 单独放环境变量,别写进代码库,否则源码泄露后攻击者可以伪造任意会员身份。
会员表字段建议除了手机号、昵称、头像,还要预留 level_id 、 balance 、 points 、 growth 。余额和积分这类账户金额字段,不要在每次请求里实时汇总,正确做法是在会员表冗余一个 balance 字段,变动时用条件 UPDATE:
UPDATE member SET balance = balance - 100
WHERE id = 1 AND balance >= 100;
影响行数为 0 就说明余额不足,MySQL 内部通过行锁保证原子性。
4.3 商品 SKU 与库存扣减方案
多规格商品在数据库一般拆成商品表 product 和 SKU 表 product_sku ,SKU 表存价格、库存、原价和规格键值对 JSON。用户选中规格后查到 SKU id,下单扣减有两种路线:秒杀场景先扣 Redis 再异步同步 MySQL,或直接 MySQL 条件更新。
对于秒杀场景,Redis 预扣更合适:
$skuId = $request->post('sku_id');
$quantity = (int) $request->post('quantity');
$stockKey = "stock:$skuId";
$result = $redis->eval(
"local s = redis.call('DECRBY', KEYS[1], ARGV[1]) " .
"if s < 0 then redis.call('INCRBY', KEYS[1], ARGV[1]) return -1 end " .
"return s",
[$stockKey, $quantity],
1
);
if ($result < 0) {
throw new \Exception('库存不足');
}
这里用 Lua 脚本保证 DECRBY 后负数回补是原子操作,避免超卖。扣减成功后订单进入待支付状态,用户不支付则关单队列回补 Redis 库存。缺点是 Redis 和 MySQL 之间会短暂不一致,但只要订单支付成功以 MySQL 为准做最终一致性,就能把大流量挡住。
如果不想维护两套库存,就直接条件更新:
$res = SkuModel::where('id', $skuId)
->where('stock', '>=', $quantity)
->dec('stock', $quantity)
->update();
影响行数为 0 表示库存不足。这条方案简单,但高并发下单时数据库行锁会排队,适合日常下单,不适合秒杀。
4.4 订单状态机与支付回调幂等性
订单状态不能只靠一个字段改来改去,否则支付回调、超时关单、用户取消同时发生时会乱。建议用整型字段 status 并约定状态值:
| 状态值 | 含义 | 可流转到 |
|---|---|---|
| 0 | 待支付 | -1, 1 |
| 1 | 已支付/待发货 | 2, -2 |
| 2 | 已发货/待收货 | 3 |
| 3 | 已完成 | null |
| -1 | 已关闭 | null |
| -2 | 退款中/已退款 | -1 |
支付回调最怕重复。支付宝/微信回调可能重试多次,处理必须幂等。稳妥的写法是先把回调内容落库,再用订单号加锁处理:
$lock = $redis->set("pay:lock:{$orderNo}", 1, ['NX', 'EX' => 30]);
if (!$lock) {
return '处理中';
}
$order = OrderModel::where('order_no', $orderNo)->find();
if ($order && $order->status == 0) {
$order->status = 1;
$order->paid_at = time();
$order->transaction_id = $request->post('transaction_id');
$order->save();
// 发送短信、扣减积分等后续动作
}
这里的 set NX EX 是 Redis 分布式锁,保证同一订单的多个回调不会并发处理。特别提醒:回调里要校验支付金额与订单金额一致,否则就是“改金额支付”漏洞。
4.5 CMS 与动态表单生成
CMS 管理不仅是文章列表,这套系统还带表单生成,用于报名、留言、预约这类页面。表单生成器的思路是先把字段结构存 JSON:
{
"fields": [
{"name": "username", "label": "姓名", "type": "input", "required": true},
{"name": "phone", "label": "手机号", "type": "input", "required": true},
{"name": "content", "label": "留言内容", "type": "textarea", "required": false}
]
}
后端提交时不用为每个表单建表,把内容按提交记录 JSON 序列化存储,读取时按字段配置校验和展示。这种设计开发效率高,但后台做模糊搜索很吃亏。所以如果要支持按字段筛选,至少把常用字段冗余到单独列,或者把表单定义升级成独立表 + 字段表。表单数量不超过 20 个的场景用 JSON 没问题,否则还是规规矩矩建表,减少报表统计时的痛苦。
CMS 内容本身用 article 和 article_category 两张表就够了,前端 PC、H5、小程序都通过 API 获取,不需要每端单独出模板。
5. 接口扩展与上线:短信、物流、采集与线上排错
5.1 短信与物流查询接口调度
管理后台上配置好短信服务商 AppKey/AppSecret,系统通过 Guzzle 请求服务商接口,发送动作不放在支付主流程里,而是丢到 Redis 队列异步调用。超时时间设 3 秒、读取 5 秒,失败进入重试队列。物流查询同样先查 Redis 缓存,再请求第三方,响应后回写。签名拼接顺序必须对着服务商文档来,很多接入失败都是 AppSecret 放错位置导致的。
5.2 商品采集的适配器写法
商品采集的每个平台写一个驱动,实现 CollectorInterface ,通过 URL 域名分发到对应驱动。解析时优先提取页面里的 JSON-LD,拿不到再回退 XPath。图片必须下载到本地 OSS,否则对方加防盗链后商品图直接裂掉。
5.3 多端 API 响应与跨域
多端共用同一套 JWT 鉴权,响应统一为 {"code":200,"msg":"ok","data":{}} ,H5 跨域时按来源域名返回白名单。 Access-Control-Allow-Credentials: true 时不能配 * ,Origin 一定要校验白名单。
header('Access-Control-Allow-Origin: ' . $origin);
header('Access-Control-Allow-Credentials: true');
header('Access-Control-Allow-Headers: Authorization, Content-Type');
5.4 上线检查与队列验证
部署后先确认 Opcache、Redis 连接和 MySQL 慢查询日志,再手动向队列投一条测试消息:
redis-cli lpush order:close:queue 10086
然后用 LLEN order:close:queue 看积压,用 ps -ef | grep worker 看消费进程。这个命令我每次排查队列问题都会先跑一遍,队列不消费时先别改代码,第一步永远确认进程和 Redis key 状态。
更多推荐




所有评论(0)