nexophp / cart
dev-main
2025-09-20 11:37 UTC
This package is auto-updated.
Last update: 2025-09-20 11:38:12 UTC
README
购物车管理模块,支持商品添加、删除、修改等功能。
功能特性
- 购物车管理:创建、查看、删除购物车
- 购物车项目管理:添加商品、修改数量、删除商品
- 用户购物车:支持用户级别的购物车管理
- 商品规格支持:支持商品规格参数存储
- 统计功能:购物车数据统计和分析
- API接口:完整的RESTful API支持
数据库表结构
cart 表
id
: 主键type
: 购物车类型seller_id
: 卖家IDuser_id
: 用户IDnum
: 商品总数量amount
: 总金额created_at
: 创建时间updated_at
: 更新时间
cart_item 表
id
: 主键cart_id
: 购物车IDproduct_id
: 商品IDtitle
: 商品标题price
: 商品价格num
: 商品数量param_1
: 规格参数1 (JSON)param_2
: 规格参数2 (JSON)created_at
: 创建时间updated_at
: 更新时间
API 接口
获取购物车
GET /api/cart
添加商品到购物车
POST /api/cart/add
参数:
- product_id: 商品ID
- num: 数量
- param_1: 规格参数1 (可选)
- param_2: 规格参数2 (可选)
更新购物车项目数量
POST /api/cart/update
参数:
- id: 购物车项目ID
- num: 新数量
删除购物车项目
POST /api/cart/remove
参数:
- id: 购物车项目ID
批量删除购物车项目
POST /api/cart/batch-remove
参数:
- ids: 购物车项目ID数组
清空购物车
POST /api/cart/clear
获取购物车统计
GET /api/cart/count
后台管理
购物车列表
- 路径:
/cart/cart/index
- 功能:查看所有购物车,支持筛选和搜索
购物车详情
- 路径:
/cart/cart/view
- 功能:查看购物车详细信息和商品列表
购物车项目管理
- 路径:
/cart/cart/items
- 功能:管理所有购物车项目
购物车统计
- 路径:
/cart/cart/stats
- 功能:查看购物车相关统计数据
使用示例
添加商品到购物车
use modules\cart\data\CartData; $cartData = new CartData(); $result = $cartData->addToCart([ 'user_id' => 1, 'product_id' => 100, 'num' => 2, 'param_1' => json_encode(['color' => '红色', 'size' => 'L']), 'param_2' => json_encode(['material' => '棉质']) ]);
获取用户购物车
use modules\cart\data\CartData; $cartData = new CartData(); $cart = $cartData->getUserCart(1); // 用户ID为1的购物车
更新购物车项目数量
use modules\cart\data\CartData; $cartData = new CartData(); $result = $cartData->updateCartItem(1, 5); // 将ID为1的项目数量更新为5
依赖关系
- 依赖
product
模块获取商品信息 - 依赖
user
模块获取用户信息 - 使用
AppModel
基础模型类 - 使用
ApiController
基础API控制器
版本信息
- 版本:1.0.0
- 作者:sunkangchina
- 邮箱:68103403@qq.com
- 许可证:MIT