bbprojectnet/unit-helpers

用于配置目的的简单单元辅助工具。

1.0.0 2022-10-22 09:22 UTC

This package is auto-updated.

Last update: 2024-09-22 13:36:11 UTC


README

此软件包旨在使在配置文件中更清楚地指定时间和大小变得容易。

示例 1

// Before
$query->where('size', '>=', 209715200)->get();

// After
$query->where('size', '>=', Size::mb(200))->get();

示例 2

// Before
$config = [
	'expiration' => 4680, // 3 days and 6 hours in minutes
];

// After
$config = [
	'expiration' => Time::of(days: 3, hours: 6, 'minutes'),
	// or
	'expiration' => Time::of(days: 3.25, 'minutes'),
	// or
	'expiration' => Time::days(3.25, 'minutes'),
];

示例 3

// Before
class Job
{
	protected int $timeout = 10800;
}

// After
class Job
{
	protected int $timeout = Time::HOUR * 3;
}

需求

  • PHP 8.0 及以上

安装

使用以下命令通过 composer 需要此软件包:

composer require bbprojectnet/unit-helpers

用法

作为简单的静态调用

$timeout = Time::hours(4);

指定输出单位的静态调用

$timeout = Time::hours(4, 'minutes');

作为方法参数

$timeout = Time::of(days: 2);

混合单位类型

$timeout = Time::of(days: 2, hours: 10);

混合单位类型并指定输出单位

$timeout = Time::of(days: 2, hours: 10, as: 'minutes');

混合单位类型、分数、负值并指定输出单位

$timeout = Time::of(days: 2.4, hours: -2, minutes: 0.5, as: 'minutes');

在无法调用方法的地方作为常量

protected int $timeout = Time::HOUR * 3;

许可证

Unit 辅助工具软件包是开源软件,根据 MIT 许可证授权。