# php-tools

**Repository Path**: chenbool/php_tools

## Basic Information

- **Project Name**: php-tools
- **Description**: php-tools 工具类
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-02
- **Last Updated**: 2026-05-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 常用工具函数

PHP 常用工具函数集合，包含网络请求、邮件、验证码、短信、二维码、快递查询和汉字验证等功能。

## 功能特性

- [Curl 网络请求](#curl-网络请求)
- [邮件发送](#邮件发送)
- [条形码/二维码生成](#条形码二维码生成)
- [短信 SDK](#短信-sdk)
- [验证工具](#验证工具)
- [快递查询](#快递查询)
- [汉字验证](#汉字验证)

## 目录结构

```
tools/
├── curl/               # Curl 网络请求库
├── mail/               # 邮件发送
├── phpBulidCode/       # 条形码和二维码生成
├── sms_sdk/            # 短信 SDK
├── verify/             # 验证工具类
├── express.php         # 快递查询
└── hanzi.php           # 汉字验证
```

---

## Curl 网络请求

PHP Curl 网络请求库，支持 GET、POST、文件上传、文件下载、方法链式调用。

### 文件说明

| 文件 | 功能 |
|------|------|
| `curl/src/Curl.php` | Curl 操作类 |

### 安装

```bash
composer require chenbool/curl
```

### 使用示例

```php
use chenbool\Curl;

$curl = new Curl;
$curl->get('http://example.com/api');
```

详细文档：[curl/README.md](file:///f:/代码/2/tools/curl/README.md)

---

## 邮件发送

PHP 原生实现的 SMTP 邮件发送工具，无需 PHP 扩展支持。

### 文件说明

| 文件 | 功能 |
|------|------|
| `mail/mail.php` | 邮件发送类 |

### 安装

```bash
composer require chenbool/mail
```

### 使用示例

```php
include 'mail/mail.php';

$config = [
    'smtp_host' => 'smtp.163.com',
    'smtp_port' => 25,
    'smtp_user' => 'bool1993@163.com',
    'smtp_pass' => 'your_password',
    'smtp_name' => 'bool',
    'html'      => true,
];

$mail = new Mail($config);
$mail->send('bool1993@qq.com', 'Subject', '<h1>Content</h1>');
```

详细文档：[mail/README.md](file:///f:/代码/2/tools/mail/README.md)

---

## 条形码/二维码生成

PHP 实现的条形码和二维码生成工具。

### 文件说明

| 文件 | 功能 |
|------|------|
| `phpBulidCode/barcode.php` | Code 39 条形码生成 |
| `phpBulidCode/phpqrcode.php` | 二维码生成类 |

### 使用示例

```php
header('Content-type: image/png');

require_once 'phpBulidCode/barcode.php';
barcode::code39('text to encode');
```

详细文档：[phpBulidCode/README.md](file:///f:/代码/2/tools/phpBulidCode/README.md)

---

## 短信 SDK

PHP 短信发送 SDK，整合多个短信服务商接口。

### 支持平台

云通讯、短信宝、叮咚云、聚合数据、LuosiMao、云短信、JSMS、凯信通

### 文件说明

| 文件 | 功能 |
|------|------|
| `sms_sdk/Sms.php` | 主类 |
| `sms_sdk/config.php` | 配置文件 |
| `sms_sdk/extend/*.php` | 各平台扩展实现 |

### 使用示例

```php
include './sms_sdk/Sms.php';

$sms = new Sms();
$sms->yuntongxun('4280', '130****0083');  // 云通讯
```

详细文档：[sms_sdk/README.md](file:///f:/代码/2/tools/sms_sdk/README.md)

---

## 验证工具

PHP 验证工具类，用于验证 IP 地址、手机号、邮箱等常用功能。

### 文件说明

| 文件 | 功能 |
|------|------|
| `verify/src/Verify.php` | 验证工具类 |

### 安装

```bash
composer require chenbool/verify
```

### 功能列表

- 验证 IP 地址（IPv4/IPv6）
- 验证邮箱格式
- 检测手机设备访问
- 检测微信访问
- 验证手机号码格式
- 验证固定电话格式
- 检测 HTTPS 请求

### 使用示例

```php
use ChenBool\Verify;

$verify = new Verify();
$verify->isIPAddress('192.168.1.1');
$verify->isEmail('test@example.com');
```

详细文档：[verify/README.md](file:///f:/代码/2/tools/verify/README.md)

---

## 快递查询

### 函数说明

```php
get_express($sn)
```

### 参数

| 参数 | 类型 | 说明 |
|------|------|------|
| `$sn` | string | 快递单号 |

### 返回值

返回物流信息数组，包含以下字段：

| 字段 | 说明 |
|------|------|
| `comCode` | 快递公司代码 |
| `message` | 物流状态 |
| `time` | 时间节点 |
| `context` | 物流详情 |

### 使用示例

```php
include 'express.php';

$res = get_express('3924730222455');
print_r($res);
```

---

## 汉字验证

### 函数说明

```php
is_Chinese($str)
```

### 参数

| 参数 | 类型 | 说明 |
|------|------|------|
| `$str` | string | 待验证字符串 |

### 返回值

- 全是中文
- 含有中文
- 没有包含中文

### 使用示例

```php
include 'hanzi.php';

$str = '开放所有函数,超时时间';
is_Chinese($str);  // 输出：含有中文
```

---

## 依赖

- PHP 5.6+（部分模块需要 PHP 5.3+）
- cURL 扩展（用于快递查询和网络请求）
- Composer（用于安装依赖包）