PHPackages                             wenshuai/tools - 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. wenshuai/tools

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

wenshuai/tools
==============

v1.0.8(2mo ago)013MITPHP

Since Feb 14Pushed 2mo agoCompare

[ Source](https://github.com/1161690804/tools)[ Packagist](https://packagist.org/packages/wenshuai/tools)[ RSS](/packages/wenshuai-tools/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (5)Used By (0)

wenshuai/tools
--------------

[](#wenshuaitools)

一个简单实用的 PHP 工具库，目前提供：

- **`StringTool`**: 生成随机验证码 / 随机字符串（支持大写、小写、长度、自定义数量等）
- **`HttpRequest`**: 封装的 GET / POST 请求（支持自定义 Header、超时时间、状态码校验）

> 代码命名空间为 `wenshuai\tools`，Composer 自动加载前缀为 `Wenshuai\Tools\`，请按你项目中实际使用的命名空间来 `use`。

---

### 安装

[](#安装)

- **通过 Composer 安装**

```
composer require wenshuai/tools
```

如果是本地开发包/私有仓库，请在你项目的 `composer.json` 中配置仓库源，然后再执行 `composer require`。

---

### 自动加载

[](#自动加载)

`composer.json` 中已经配置了 PSR-4 自动加载：

```
{
  "autoload": {
    "psr-4": {
      "Wenshuai\\Tools\\": "src/"
    }
  }
}
```

在你的项目中引入 Composer 自动加载：

```
require __DIR__ . '/vendor/autoload.php';
```

然后即可使用工具类（根据你实际使用的命名空间调整）：

```
use Wenshuai\Tools\StringTool;
use Wenshuai\Tools\HttpRequest;
```

---

### StringTool 使用示例

[](#stringtool-使用示例)

- **生成单个随机字符串**

```
use Wenshuai\Tools\StringTool;

// 生成 4 位，仅数字 + 大写字母
$code = StringTool::generateCode(4);

// 生成 6 位，包含数字 + 大写 + 小写
$codeWithLower = StringTool::generateCode(6, true);
```

参数说明：

- **`$length`**: 随机字符串长度，默认为 `4`
- **`$includeLowercase`**: 是否包含小写字母，默认为 `false`
- **生成多个不重复随机字符串**

```
use Wenshuai\Tools\StringTool;

// 生成 10 个不重复的 6 位随机码，包含大小写
$codes = StringTool::generateMultipleCodes(10, 6, true);

foreach ($codes as $item) {
    echo $item . PHP_EOL;
}
```

参数说明：

- **`$count`**: 需要生成的数量
- **`$length`**: 每个随机字符串长度，默认为 `4`
- **`$includeLowercase`**: 是否包含小写字母，默认为 `false`

返回值：

- 返回一个数组，每一项为一个随机字符串。

---

### HttpRequest 使用示例

[](#httprequest-使用示例)

`HttpRequest` 封装了简单的 GET / POST 请求，底层使用 `curl`。

- **GET 请求**

```
use Wenshuai\Tools\HttpRequest;

$url = 'https://api.example.com/user';
$params = [
    'id' => 1,
];

$response = HttpRequest::get($url, $params);

echo $response;
```

- **POST 请求**

```
use Wenshuai\Tools\HttpRequest;

$url = 'https://api.example.com/login';
$data = [
    'username' => 'test',
    'password' => '123456',
];

$response = HttpRequest::post($url, $data);

echo $response;
```

- **自定义 Header / 超时时间 / 校验 HTTP 状态码**

```
use Wenshuai\Tools\HttpRequest;

$url = 'https://api.example.com/data';
$data = ['foo' => 'bar'];
$header = [
    'Content-Type: application/json',
    'Accept: application/json',
];

// 超时时间 10 秒，期望 HTTP 状态码为 200
$response = HttpRequest::post($url, json_encode($data), $header, 10, 200);

echo $response;
```

方法签名：

```
public static function get($url, $data = [], $header = [], $timeOut = 15, $httpCode = null)
public static function post($url, $data = [], $header = [], $timeOut = 15, $httpCode = null)
```

参数说明：

- **`$url`**: 请求地址
- **`$data`**: 请求参数
    - GET 时会自动拼接到 URL 上
    - POST 时直接作为 `CURLOPT_POSTFIELDS` 发送
- **`$header`**: 自定义请求头数组，不传则使用内置的浏览器 UA
- **`$timeOut`**: 超时时间（秒），默认 `15`
- **`$httpCode`**: 期望的 HTTP 状态码（可选）
    - 传入具体状态码（如 `200`）时，如果不匹配，将返回错误信息字符串
    - 不传则直接返回请求结果内容

返回值：

- 默认返回接口响应内容（字符串）
- 如果设置了 `$httpCode` 且响应码不符合预期，则返回一段错误描述字符串

---

### 环境要求

[](#环境要求)

- **PHP 版本**: 建议 PHP 7.0 及以上（`StringTool` 使用了 `random_bytes`）
- **扩展依赖**:
    - `curl` 扩展（用于 `HttpRequest`）

---

### 许可证

[](#许可证)

本项目基于 `LICENSE` 文件中所述的开源许可证发布。

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance86

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 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 ~6 days

Total

4

Last Release

74d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a8a07113213ad5eaa41085ddb077ca1879202e4ba35bcbb31e2a4727e83405e4?d=identicon)[wenshuai\_5](/maintainers/wenshuai_5)

---

Top Contributors

[![1161690804](https://avatars.githubusercontent.com/u/26269782?v=4)](https://github.com/1161690804 "1161690804 (13 commits)")

### Embed Badge

![Health badge](/badges/wenshuai-tools/health.svg)

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

PHPackages © 2026

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