PHPackages                             luffy/randomizer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. luffy/randomizer

ActiveLibrary[Utility & Helpers](/categories/utility)

luffy/randomizer
================

get random data from random.org

v1.2.4(7y ago)117[1 issues](https://github.com/hanqing757/trueRandom/issues)PHP

Since Oct 13Pushed 7y ago1 watchersCompare

[ Source](https://github.com/hanqing757/trueRandom)[ Packagist](https://packagist.org/packages/luffy/randomizer)[ RSS](/packages/luffy-randomizer/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (7)Dependencies (1)Versions (8)Used By (0)

trueRandom
==========

[](#truerandom)

基于random.org提供的API生成真正的随机数，包括整数序列、小数序列、高斯分布、字符串、uuid、二进制大对象（blob）。

在使用前先去random.org申请一个API key, 对每个API key限制了每天生成的随机数或随机字符串的数量，相关信息将会在每次获取随机数时一并返回。

安装
==

[](#安装)

通过composer，在你的composer.json文件中添加如下

```
"require":{
    "luffy/randomizer":"*"
}

```

使用
==

[](#使用)

```
use  luffy\random\Randomizer;
$generator=new Randomizer('449c131f-0171-401e-80c9-xxxxxxxxx'); //参数是你在random.org申请的API key
```

生成整数序列
======

[](#生成整数序列)

参数依次表示随机数个数，最小值，最大值，进制（2/8/10/16），是否允许重复出现随机数

```
$generator->integers($quantity,$min,$max,$base=10,$replacement=true)
```

返回一个数组

```
array(3) {
  ["errno"]=>
  int(0)
  ["error"]=>
  string(7) "success"
  ["data"]=>
  array(10) {
    [0]=>
    int(22)
    [1]=>
    int(9)
    [2]=>
    int(89)
    [3]=>
    int(98)
    [4]=>
    int(79)
    [5]=>
    int(1)
    [6]=>
    int(3)
    [7]=>
    int(83)
    [8]=>
    int(67)
    [9]=>
    int(29)
  }
}
```

出错时返回如下，比如$base出错

```
array(3) {
  ["errno"]=>
  int(201)
  ["error"]=>
  string(34) "Parameter 'base' has illegal value"
  ["data"]=>
  NULL
}
```

生成浮点数随机数
========

[](#生成浮点数随机数)

参数依次表示随机数个数，小数位数，$replacement同上

```
$generator->decimalFractions($quantity,$decimalPlaces,$replacement=true)
```

返回数据格式同上

生成高斯分布随机数
=========

[](#生成高斯分布随机数)

参数依次表示随机数个数，均值，方差，有效数字

```
$generator->gaussians($quantity,$mean,$standardDeviation,$significantDigits)
```

生成随机字符串
=======

[](#生成随机字符串)

参数依次表示 随机字符串个数，字符串长度，选取的字符集

```
$generator->strings($quantity,$length,$characters,$replacement=true)
```

生成随机的uuid
=========

[](#生成随机的uuid)

参数表示uuid的个数

```
$generator->uuids($quantity)
```

生成二进制大对象blob
============

[](#生成二进制大对象blob)

参数依次表示随机blob个数，blob长度（bit）,返回数据的编码格式

```
$generator->blobs($quantity,$size,$format='base64')
```

查看API key当前的状态信息
================

[](#查看api-key当前的状态信息)

```
$generator->usage();
```

返回数据如下

```
array(3) {
  ["errno"]=>
  int(0)
  ["error"]=>
  string(7) "success"
  ["data"]=>
  array(6) {
    ["status"]=>
    string(7) "running"
    ["creationTime"]=>
    string(20) "2018-09-30 08:17:55Z"
    ["bitsLeft"]=>
    int(249604)
    ["requestsLeft"]=>
    int(994)
    ["totalBits"]=>
    int(21471)
    ["totalRequests"]=>
    int(99)
  }
}
```

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

7

Last Release

2767d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6042365?v=4)[Qing](/maintainers/hanqing757)[@hanqing757](https://github.com/hanqing757)

---

Top Contributors

[![hanqing757](https://avatars.githubusercontent.com/u/6042365?v=4)](https://github.com/hanqing757 "hanqing757 (8 commits)")

---

Tags

random

### Embed Badge

![Health badge](/badges/luffy-randomizer/health.svg)

```
[![Health](https://phpackages.com/badges/luffy-randomizer/health.svg)](https://phpackages.com/packages/luffy-randomizer)
```

###  Alternatives

[paragonie/random_compat

PHP 5.x polyfill for random\_bytes() and random\_int() from PHP 7

8.2k655.0M405](/packages/paragonie-random-compat)[ircmaxell/random-lib

A Library For Generating Secure Random Numbers

84130.2M119](/packages/ircmaxell-random-lib)[mistic100/randomcolor

Generate attractive random colors

2431.4M6](/packages/mistic100-randomcolor)[pragmarx/random

Create random chars, numbers, strings

714.2M5](/packages/pragmarx-random)[paragonie/random-lib

A Library For Generating Secure Random Numbers

703.3M26](/packages/paragonie-random-lib)[nubs/random-name-generator

A library to create interesting, sometimes entertaining, random names.

135680.2k3](/packages/nubs-random-name-generator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)