rm/unique

生成唯一文件名的库。

v0.1.0 2015-04-26 10:07 UTC

This package is auto-updated.

Last update: 2024-09-05 20:13:12 UTC


README

Build Status Code Quality Code Coverage Packagist

Uniqe是一个简单的库,用于在目录中生成唯一的文件名。

要求

Unique需要PHP 5.4或更高版本。

安装

安装Unique的最佳方式是使用Composerrm/unique,或者从GitHub手动下载最新的ZIP包。

$ composer require rm/unique

示例

我需要将文件something.png上传到目录/images中。

如果需要防止覆盖现有文件,您需要生成唯一的文件名。

现在很简单!

$filename = Unique::get('something.png', '/images'); // return 'something.png'

如果目录中已经包含文件something.png和例如something-1.png呢?

返回something-2.png

Unique::get()会自动生成格式为<filename><separator><order>.<extension>的文件名,并检查在指定的目录中是否存在。如果是唯一的,则返回它。

API

get()

方法get()有两个参数

  • string $filename 文件名
  • string $dir 文件将保存到的目录

返回

  • string 输出文件名

$separator

默认的文件名分隔符和顺序是-。可以更改它,例如

Unique::$separator = '|';

贡献

  • 使用它!
  • 将错误报告或想法写入问题跟踪器
  • 分支仓库并发送包含问题编号、源代码和测试的拉取请求。

联系方式

Roman Mátyus romanmatyus@romiix.org