README

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

底层依赖：hashids/hashids v5。

安装

composer require erikwang2013/hashids

配置结构（Laravel / Webman / ThinkPHP）

与仓库 config/hashids.php 一致：

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

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

无框架用法

可直接实例化管理器：

use Erikwang2013\Hashids\HashidsFactory;
use Erikwang2013\Hashids\HashidsManager;

$manager = new HashidsManager(
    require __DIR__ . '/config/hashids.php',
    new HashidsFactory()
);

$hash = $manager->encode(1, 2, 3);
$ids = $manager->decode($hash);

Laravel

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

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

发布配置（可选）

php artisan vendor:publish --tag=hashids-config

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

Facade（默认连接）

use Erikwang2013\Hashids\Laravel\Facades\Hashids;

$hash = Hashids::encode(1, 2, 3);
$numbers = Hashids::decode($hash);

指定连接

use Erikwang2013\Hashids\Laravel\Facades\Hashids;

$hash = Hashids::connection('alternative')->encode(100);

依赖注入 HashidsManager

use Erikwang2013\Hashids\HashidsManager;

public function __construct(private HashidsManager $hashids) {}

$this->hashids->encode(1);
$this->hashids->connection('alternative')->encode(2);

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

use Hashids\Hashids;

public function __construct(private 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）

<?php
return [
    'enable' => false,
];

容器绑定

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

控制器示例

use support\Request;
use Erikwang2013\Hashids\HashidsManager;
use Hashids\Hashids;

class DemoController
{
    public function index(Request $request, HashidsManager $manager)
    {
        $hash = $manager->encode(1, 2, 3);

        $client = \support\Container::instance()->get(Hashids::class);
        $hash2 = $client->encode(4);

        return json(['hash' => $hash, 'hash2' => $hash2]);
    }
}

指定连接

$manager->connection('alternative')->encode(99);

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

ThinkPHP

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

注册服务

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

<?php

return [
    // ...
    \Erikwang2013\Hashids\ThinkPHP\HashidsService::class,
];

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

配置文件

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

<?php
return [
    'default' => 'main',
    'connections' => [
        'main' => [
            'salt' => env('HASHIDS_SALT', ''),
            'length' => (int) env('HASHIDS_LENGTH', 0),
        ],
    ],
];

使用示例

use Erikwang2013\Hashids\HashidsManager;
use think\facade\App;

$manager = App::make(HashidsManager::class);
$hash = $manager->encode(10, 20);

$manager = app('hashids');

use Hashids\Hashids;

$client = app(Hashids::class);
$hash = $client->encode(1);

app(HashidsManager::class)->connection('alternative')->encode(100);

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') 读取。

<?php

declare(strict_types=1);

return [
    'hashids' => [
        'default' => 'main',
        'connections' => [
            'main' => [
                'salt' => env('HASHIDS_SALT', ''),
                'length' => (int) env('HASHIDS_LENGTH', 0),
            ],
        ],
    ],
];

容器绑定

抽象	实现
`Erikwang2013\Hashids\HashidsFactory`	默认构造
`Erikwang2013\Hashids\HashidsManager`	`HashidsManagerFactory`
`Hashids\Hashids`	`HashidsClientFactory`（默认连接）

Controller / 构造函数注入

<?php

declare(strict_types=1);

namespace App\Controller;

use Erikwang2013\Hashids\HashidsManager;
use Hashids\Hashids;

class DemoController
{
    public function index(HashidsManager $manager, Hashids $hashids)
    {
        $h1 = $manager->encode(1, 2, 3);
        $h2 = $hashids->encode(4);
        $alt = $manager->connection('alternative')->encode(99);

        return compact('h1', 'h2', 'alt');
    }
}

$manager = \Hyperf\Context\ApplicationContext::getContainer()->get(
    \Erikwang2013\Hashids\HashidsManager::class
);

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

License

MIT. See LICENSE.

erikwang2013 / hashids

Maintainers

Package info

Statistics

Security