README

PHP 库，用于创建 ULID 唯一标识符值

安装

版本 7.0.0 需要 PHP 8.3

版本 6.0.0 需要 PHP 8.2

版本 5.0.0 需要 PHP 8.1

版本 4.0.0 需要 PHP 7.4

版本 3.0.0 需要 PHP 7.3

版本 2.0.0 需要 PHP 7.2

版本 1.0.0 需要 PHP 7.1

推荐的安装方式是通过 Composer。

composer require not-empty/ulid-php-lib

使用方法

生成 Ulid

use Ulid\Ulid;
$ulid = new Ulid();
$ulidFromNow = $ulid->generate();
echo $ulidFromNow;

从时间戳生成 Ulid

use Ulid\Ulid;
$ulid = new Ulid();
$ulidFromTime = $ulid->generate(1585083964945);
echo $ulidFromTime;

验证字符串是否为有效的 Ulid

use Ulid\Ulid;
$ulid = new Ulid();
$invalid = $ulid->isValidFormat('1585083964945');
var_dump($invalid)

从 Ulid 恢复时间戳

use Ulid\Ulid;
$ulid = new Ulid();
$timeFromUlid = $ulid->getTimeFromUlid('01E48SD97BMWHAW82D229T0C7K');
echo $timeFromUlid;

从 Ulid 恢复日期

use Ulid\Ulid;
$ulid = new Ulid();
$dateFromUlid = $ulid->getDateFromUlid('01E48SD97BMWHAW82D229T0C7K');
echo $dateFromUlid;

从 Ulid 恢复随机性

use Ulid\Ulid;
$ulid = new Ulid();
$randomnessFromUlid = $ulid->getRandomnessFromString('01E475VQGHNW990PVHXFDT4C6R');
echo $randomnessFromUlid;

如果您想创建一个运行或测试的环境，可以按如下方式构建和安装依赖项

docker build --build-arg PHP_VERSION=8.3-rc-cli -t not-empty/ulid-php-lib:php83 -f contrib/Dockerfile .

访问容器

docker run -v ${PWD}/:/var/www/html -it not-empty/ulid-php-lib:php83 bash

验证是否已安装所有依赖项

composer install --no-dev --prefer-dist

然后运行

php sample/ulid-sample.php

开发

想贡献？太好了！

项目使用简单的代码。修改您的文件时要小心更新！任何新代码都将仅在接受所有验证后接受。

为确保整个项目良好

首先，您需要构建一个正确安装所有依赖项的环境

docker build --build-arg PHP_VERSION=8.3-rc-cli -t not-empty/ulid-php-lib:php83 -f contrib/Dockerfile .

访问容器

docker run -v ${PWD}/:/var/www/html -it not-empty/ulid-php-lib:php83 bash

安装所有依赖项

composer install --dev --prefer-dist

运行所有验证

composer check

Not Empty Foundation - 自由代码，充满热情