PHP Helpers

PHP Helpers 是一个简单易用的 PHP 工具集合，它提供了许多常用的辅助函数，可以帮助你更快速、更方便地完成 PHP 开发工作。无论你是 PHP 新手还是有经验的开发者，这个工具包都能让你的编码更加高效。

安装

基本使用方法

1. 在项目中引入

安装完成后，你需要在你的 PHP 文件中引入 Composer 的自动加载文件：

1

require_once 'vendor/autoload.php';

2. 使用辅助函数

PHP Helpers 提供了多种辅助函数，你可以直接调用它们：

1
2
3
4
5


// 例如使用数组辅助函数
$result = \Hollisho\Helpers\ArrayHelper::get($array, 'user.name', '默认值');

// 例如使用字符串辅助函数
$slug = \Hollisho\Helpers\StringHelper::slug('Hello World');

常用功能示例

数组操作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


// 从多维数组中安全获取值
$user = [
    'profile' => [
        'name' => '张三',
        'age' => 25
    ]
];

// 获取用户名
$name = \Hollisho\Helpers\ArrayHelper::get($user, 'profile.name');
echo $name; // 输出: 张三

// 如果键不存在，返回默认值
$address = \Hollisho\Helpers\ArrayHelper::get($user, 'profile.address', '未设置');
echo $address; // 输出: 未设置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10



### 字符串处理
```php
// 生成URL友好的字符串
$slug = \Hollisho\Helpers\StringHelper::slug('你好 世界');
echo $slug; // 输出: ni-hao-shi-jie 或类似格式

// 随机字符串生成
$random = \Hollisho\Helpers\StringHelper::random(8);
echo $random; // 输出: 类似 a1b2c3d4 的8位随机字符串

日期时间处理

1
2
3
4
5
6
7


// 格式化日期
$formatted = \Hollisho\Helpers\DateHelper::format('2023-01-01', 'Y年m月d日');
echo $formatted; // 输出: 2023年01月01日

// 获取两个日期之间的天数
$days = \Hollisho\Helpers\DateHelper::diffInDays('2023-01-01', '2023-01-10');
echo $days; // 输出: 9

环境变量功能

如果你需要使用环境变量功能（EnvHelper），需要额外安装 vlucas/phpdotenv 扩展：

1

composer require vlucas/phpdotenv:^5.6

安装后，你可以这样使用：

1
2
3
4
5
6


// 加载 .env 文件
\Hollisho\Helpers\EnvHelper::load('/path/to/your/project');

// 获取环境变量
$dbName = \Hollisho\Helpers\EnvHelper::get('DB_NAME', 'default_db');
echo $dbName;

如何测试

创建一个测试文件，例如 test.php ：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


<?php
// 引入自动加载文件
require_once 'vendor/autoload.php';

// 测试数组辅助函数
$array = ['user' => ['name' => '李四', 'email' => 'lisi@example.com']];
$name = \Hollisho\Helpers\ArrayHelper::get($array, 'user.name');
echo "用户名: " . $name . "\n";

// 测试字符串辅助函数
$random = \Hollisho\Helpers\StringHelper::random(10);
echo "随机字符串: " . $random . "\n";