产品列表

方法概览

项目	内容
文档类型	PHP 类方法
方法标识	`app\common\model\UpstreamHostModel::hostList`
所属业务	上下游
来源模块/系统	上游产品模型

功能说明

产品列表

调用示例

$param = ['keywords' => '示例关键字', 'supplier_id' => 1, 'billing_cycle' => 'monthly', 'status' => 'Active', 'start_time' => 1752984000, 'end_time' => 1752984000, 'page' => 1, 'limit' => 1, 'orderby' => 'id', 'sort' => 'string'];
$result = (new \app\common\model\UpstreamHostModel())->hostList($param);

参数

参数	类型	必填	默认值	校验规则	说明
`param.keywords`	`string`	否	—	—	关键字,搜索范围:ID,用户名称,邮箱,手机号,商品名称,产品标识
`param.supplier_id`	`int`	否	—	—	供应商ID
`param.billing_cycle`	`string`	否	—	—	付款周期
`param.status`	`string`	否	—	—	状态Unpaid未付款Pending开通中Active已开通Suspended已暂停Deleted已删除Failed开通失败
`param.start_time`	`int`	否	—	—	开始时间
`param.end_time`	`int`	否	—	—	结束时间
`param.page`	`int`	否	—	—	页数
`param.limit`	`int`	否	—	—	每页条数
`param.orderby`	`string`	否	—	—	排序 id
`param.sort`	`string`	否	—	—	升/降序 asc,desc

返回值

返回项	类型	说明
`list`	`array`	产品
`list[].id`	`int`	产品ID
`list[].name`	`string`	产品标识
`list[].product_name`	`string`	商品名称
`list[].status`	`string`	状态Unpaid未付款Pending开通中Active已开通Suspended已暂停Deleted已删除Failed开通失败
`list[].first_payment_amount`	`string`	金额
`list[].renew_amount`	`string`	续费金额
`list[].billing_cycle`	`string`	周期
`list[].due_time`	`string`	到期时间
`list[].client_id`	`string`	用户ID
`list[].username`	`string`	用户名
`list[].company`	`string`	公司
`list[].email`	`string`	邮箱
`list[].phone_code`	`string`	国际电话区号
`list[].phone`	`string`	手机号
`list[].ip_num`	`int`	IP数量
`list[].base_info`	`string`	产品基础信息
`count`	`int`	产品总数

正常返回

{
  "list": [
    {
      "id": 1,
      "name": "示例名称",
      "product_name": "示例名称",
      "status": "Active",
      "first_payment_amount": "string",
      "renew_amount": "string",
      "billing_cycle": "monthly",
      "due_time": "string",
      "client_id": "1",
      "username": "示例名称",
      "company": "string",
      "email": "user@example.com",
      "phone_code": "86",
      "phone": "13800138000",
      "ip_num": 1,
      "base_info": "string"
    }
  ],
  "count": 1
}

异常情况

异常类型	说明
`Throwable`	调用失败时由具体实现抛出异常，异常信息以运行时结果为准。

本页目录