# number-pool

**Repository Path**: 3433/number-pool

## Basic Information

- **Project Name**: number-pool
- **Description**: 订单号码池
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-04-30
- **Last Updated**: 2021-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# number-pool

#### 介绍
订单号码池,利用Redis提前生成一批订单号存入list,根据使用量自动调整单号预存数量

毫秒时间戳(13)-数据中心(2)-机器码(3)-序列号(4)
> 例：1588128483000-55-666-0000
理论单机450万/单机

#### 使用说明

```php
<?php
include 'NumberPool.php'

// 直接获取
$trade_no = NumberPool::getOne();
echo $trade_no;
# 输出 1588263158688000000045


// 切换到数据库1获取
$trade_no = NumberPool::db(1)->getOne();
echo $trade_no;
# 输出 1588263158691000000076


// 切换到数据库2、数据中心2、机器码2 获取
$trade_no = NumberPool::db(2)->center(2)->worker(2)->getOne();
echo $trade_no;
# 输出 1588263158693020020688


// 初始化配置，切换到数据库3、数据中心3、机器码2 获取
$options = [
    'host'       => '127.0.0.1',
    'port'       => 6379,
    'password'   => '',
    'select'     => 0,                      // 选择数据库
    'prefix'     => 'redisNumberPool',      // 前缀
];
$numberPool = NumberPool::getInstance($options);
$trade_no = $numberPool->center(3)->worker(2)->getOne();
echo $trade_no;
# 输出 1588263158696030020025

?>
```


#### 接口

> getInstance 获取单例

<table>
    <tr>
        <th align="left">参数名称</th>
        <th align="left">类型</th>
        <th align="left">必选</th>
        <th align="left">默认</th>
        <th align="left">描述</th>
    </tr>
    <tr>
        <td>option</td>
        <td>Array</td>
        <td>否</td>
        <td></td>
        <td>基础配置</td>
    </tr>
    <tr>
        <td>option[host]</td>
        <td>String</td>
        <td>否</td>
        <td>127.0.0.1</td>
        <td>Redis 服务器</td>
    </tr>
    <tr>
        <td>option[port]</td>
        <td>Int</td>
        <td>否</td>
        <td>6379</td>
        <td>Redis 端口</td>
    </tr>
    <tr>
        <td>option[password]</td>
        <td>String</td>
        <td>否</td>
        <td>127.0.0.1</td>
        <td>Redis 密码</td>
    </tr>
    <tr>
        <td>option[select]</td>
        <td>int</td>
        <td>否</td>
        <td>0</td>
        <td>Redis 指定数据库</td>
    </tr>
    <tr>
        <td>option[prefix]</td>
        <td>String</td>
        <td>否</td>
        <td>redisNumberPool</td>
        <td>Redis key前缀</td>
    </tr>
</table>

> db 切换数据库

<table>
    <tr>
        <th align="left">参数名称</th>
        <th align="left">类型</th>
        <th align="left">必选</th>
        <th align="left">默认</th>
        <th align="left">描述</th>
    </tr>
    <tr>
        <td>id</td>
        <td>Int</td>
        <td>否</td>
        <td>0</td>
        <td>切换到指定数据库</td>
    </tr>
</table>

> center 切换数据中心

<table>
    <tr>
        <th align="left">参数名称</th>
        <th align="left">类型</th>
        <th align="left">必选</th>
        <th align="left">默认</th>
        <th align="left">描述</th>
    </tr>
    <tr>
        <td>id</td>
        <td>Int</td>
        <td>否</td>
        <td>0</td>
        <td>切换到指定数据中心 0~99</td>
    </tr>
</table>

> worker 切换机器码

<table>
    <tr>
        <th align="left">参数名称</th>
        <th align="left">类型</th>
        <th align="left">必选</th>
        <th align="left">默认</th>
        <th align="left">描述</th>
    </tr>
    <tr>
        <td>id</td>
        <td>Int</td>
        <td>否</td>
        <td>0</td>
        <td>切换到指定机器码 0~999</td>
    </tr>
</table>

> getOne 获取一个号码

<table>
    <tr>
        <th align="left">参数名称</th>
        <th align="left">类型</th>
        <th align="left">必选</th>
        <th align="left">默认</th>
        <th align="left">描述</th>
    </tr>
    <tr>
        <td>无</td>
        <td>-</td>
        <td>-</td>
        <td>-</td>
        <td>-</td>
    </tr>
</table>

> getMultiple 获取一组号码

<table>
    <tr>
        <th align="left">参数名称</th>
        <th align="left">类型</th>
        <th align="left">必选</th>
        <th align="left">默认</th>
        <th align="left">描述</th>
    </tr>
    <tr>
        <td>number</td>
        <td>Int</td>
        <td>是</td>
        <td>-</td>
        <td>指定获取数量</td>
    </tr>
</table>


> flush 清空已存储的所有号码

<table>
    <tr>
        <th align="left">参数名称</th>
        <th align="left">类型</th>
        <th align="left">必选</th>
        <th align="left">默认</th>
        <th align="left">描述</th>
    </tr>
    <tr>
        <td>无</td>
        <td>-</td>
        <td>-</td>
        <td>-</td>
        <td></td>
    </tr>
</table>