Download the PHP package erikwang2013/hashids without Composer

erikwang2013/hashids

PHP 多框架 Hashids 集成：Laravel、Webman、ThinkPHP、Hyperf。参考来源、配置与用法对齐 vinkla/hashids（多连接、默认连接、HashidsManager + 工厂）。

底层依赖：hashids/hashids v5。

项目说明

Hashids 是一款短 ID 生成器，可将数字 ID（如数据库主键）编码为短小、唯一且不可猜测的字符串。它不同于 UUID 或雪花 ID——Hashids 更适合用于面向用户的场景（URL、分享码、订单号等），在保持短小可读的同时隐藏原始数字。

本包 erikwang2013/hashids 是 Hashids 的 PHP 多框架集成层，在设计上参考并对齐了 vinkla/hashids 的 API 风格（多连接、默认连接、Manager + Factory 模式），并扩展支持了国内常用的其他 PHP 框架。

核心特性：

• 多框架兼容：同一套 API 同时支持 Laravel、Webman、ThinkPHP、Hyperf，迁移成本极低。
• 多连接支持：一个应用可同时配置多套 Salt/Length 组合（如用户 ID 与订单 ID 使用不同盐值），通过 connection('xxx') 切换。
• 无框架依赖：不依赖任何特定框架即可独立使用，直接 new HashidsManager($config, $factory) 即可工作。
• 对齐 vinkla/hashids：Laravel 下 Facade、容器绑定、config/hashids.php 格式均与 vinkla/hashids 一致，可平滑替换。
• 框架原生风格：各框架集成遵循各自的惯用法——Laravel 用 ServiceProvider + Facade，Webman 用 Plugin + Bootstrap，ThinkPHP 用 Service，Hyperf 用 ConfigProvider。

适用场景：

注意事项：

• Hashids 是 编码（encode/decode）而非加密。Salt 仅增加猜测难度，不可用于安全敏感场景（如 token、密码）。
• 一旦上线后修改 Salt 或 Length，所有已编码的 ID 将变为无效，请提前规划并固定配置。

安装

配置结构（Laravel / Webman / ThinkPHP）

与仓库 config/hashids.php 一致：

• default：默认连接名（如 main）。
• connections：连接名 => salt、length、可选 alphabet。

Hyperf 使用单独的配置文件格式（外层键为 hashids），见下文 Hyperf 小节。

无框架用法

可直接实例化管理器：

Laravel

与 vinkla/hashids 类似：容器注册 HashidsManager，多连接；默认连接支持 Facade 与方法转发。

Laravel 5.5+ 会读取本包 composer.json 的 extra.laravel，自动注册 HashidsServiceProvider 与 Facade 别名 Hashids。

发布配置（可选）

生成 config/hashids.php。若不发布，扩展包会在注册阶段合并内置默认配置。

Facade（默认连接）

指定连接

依赖注入 HashidsManager

注入底层 Hashids\Hashids（默认连接）

运行 Laravel 集成需要项目已安装 laravel/framework（含 illuminate/support 等）。本包将 illuminate/* 列为 require-dev，仅供包自身测试。

Webman

通过 Install 在安装时拷贝 config/plugin/erikwang2013/hashids 与根目录 config/hashids.php，并由插件 bootstrap 向 Webman 容器注册 HashidsManager。

项目的 composer.json 中若已有 support\Plugin::install / update / uninstall 钩子，安装本包时会自动执行安装脚本（WEBMAN_PLUGIN = true）。

安装后文件

• config/plugin/erikwang2013/hashids/app.php：enable 开关。
• config/plugin/erikwang2013/hashids/bootstrap.php：注册 Erikwang2013\Hashids\Webman\Bootstrap。
• config/hashids.php：多连接配置（首次安装或确认覆盖时写入）。

若自动拷贝未执行，可从扩展包内手动复制上述路径的示例配置。

关闭插件（config/plugin/erikwang2013/hashids/app.php）

容器绑定

• Erikwang2013\Hashids\HashidsManager
• 'hashids'
• Hashids\Hashids（默认连接实例）

控制器示例

指定连接

Composer 卸载包时会触发 Plugin::uninstall，移除 config/plugin/erikwang2013/hashids；不会删除 config/hashids.php，是否保留由你决定。

ThinkPHP

通过 自定义服务类 注册 HashidsManager；配置仍为顶层含 default 与 connections 的 config/hashids.php。

注册服务

在应用 config/service.php（具体路径随 TP 版本可能不同）的 services 中加入：

若使用应用级 app/AppService.php，也可在 register() 中写入等价绑定。

配置文件

将扩展包内 config/hashids.php 复制到应用 config/hashids.php（或自行合并同名配置）。

使用示例

ThinkPHP 集成继承 think\Service，需在 topthink/framework 环境中使用（本包列为 suggest）。

Hyperf

Composer extra.hyperf.config 会载入 ConfigProvider，向容器注册 HashidsFactory、HashidsManager、默认连接的 Hashids\Hashids。

将扩展包内 config/autoload/hashids.php 复制到项目 config/autoload/hashids.php（或使用项目的配置发布命令）。

该文件须满足：顶层键 hashids，供 ConfigInterface::get('hashids') 读取。

容器绑定

Controller / 构造函数注入

Hyperf 使用 config/autoload/hashids.php 且配置套在 hashids 键下；Laravel / Webman / ThinkPHP 使用扁平结构（根级 default + connections）。请勿混用格式。

开源不易，欢迎支持

License

MIT. See LICENSE.