PHPackages                             liuchang103/hyperf-facade - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. liuchang103/hyperf-facade

ActiveLibrary[Utility & Helpers](/categories/utility)

liuchang103/hyperf-facade
=========================

hyperf container facade

1.0.1(5y ago)53.9k↓43.8%2MITPHPPHP >=7.2

Since Aug 2Pushed 5y ago1 watchersCompare

[ Source](https://github.com/liuchang103/hyperf-facade)[ Packagist](https://packagist.org/packages/liuchang103/hyperf-facade)[ RSS](/packages/liuchang103-hyperf-facade/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (6)Versions (3)Used By (0)

hyperf-facade
-------------

[](#hyperf-facade)

Hyperf 门面组件，借鉴 Laravel Facade，不仅能节省依赖注入，还能在各种条件下拿到单例和容器

安装
--

[](#安装)

#### 引入包

[](#引入包)

```
composer require liuchang103/hyperf-facade

```

使用
--

[](#使用)

#### 创建门面

[](#创建门面)

直接返回类名，将会在 Hyperf 的容器中直接获取

下面将创建一个 Redis 门面

```
class Redis extends \HyperfFacade\Facade
{
    protected static function getFacadeAccessor()
    {
        // 实例
        return \Hyperf\Redis\Redis::class;
    }
}

```

#### 门面返回实例

[](#门面返回实例)

```
$redis = Redis::instance();

// 同等效果
$container = \Hyperf\Utils\ApplicationContext::getContainer();
$redis = $container->get(Hyperf\Redis\Redis::class);

```

#### 门面静态使用

[](#门面静态使用)

可使用在 Facade 静态调用对应方法

```
Redis::get('key');

// 同等效果
$container = \Hyperf\Utils\ApplicationContext::getContainer();
$redis = $container->get(Hyperf\Redis\Redis::class);
$redis->get('key');

```

#### 获取DI容器

[](#获取di容器)

在条件苛刻的流程中，想要拿到容器得再引入 Hyperf 工具类，在已引入的 Facade 中，即可获取

```
$container = Redis::container();

// 同等效果
$container = \Hyperf\Utils\ApplicationContext::getContainer();

```

#### 门面别名

[](#门面别名)

当 Facade 需要起别名时，可用注解方式

```
use HyperfFacade\Annotation\Alias;

/**
 * @Alias("Redis")
 */
class Redis extends \HyperfFacade\Facade
{
    protected static function getFacadeAccessor()
    {
        return \Hyperf\Redis\Redis::class;
    }
}

```

使用别名

```
\Redis::set('key', 'value');

```

注：Alias 注解可作用其它类

#### 短生命周期

[](#短生命周期)

以上门面代理的都会是长生命周期对象，如果想用门面使用短生命周期并且自动依赖注入，请看示例

```
class Test extends \HyperfFacade\Facade
{
    protected static function getFacadeAccessor()
    {
        // 实例
        return \App\Server\Test::class;
    }

    // 不使用单例模式
    protected static function singleton()
    {
        return false;
    }
}

```

使用门面时

```
$test = Test::instance();

// 同等
$test = make(\App\Server\Test::class);

```

同样使用静态调用

```
Test::foo();

// 同等
$test = make(\App\Server\Test::class);
$test->foo();

```

当类需要传入参数

```
class Test extends \HyperfFacade\Facade
{
    protected static function getFacadeAccessor()
    {
        // 实例
        return \App\Server\Test::class;
    }

    // 传入参数，当 singleton 为 true 时，不生效
    protected static function getResolveAccessor()
    {
        return [
            'config' => config('test')
        ];
    }

    // 不使用单例模式
    protected static function singleton()
    {
        return false;
    }
}

// 调用
Test::foo();

// 同等
$test = make(\App\Server\Test::class, ['config' => config('test')];
$test->foo();

```

长短生命周期测试
--------

[](#长短生命周期测试)

更好的区分应该在何时用单例模式

#### 服务类

[](#服务类)

```
class Test
{
    public $foo = 0;

    public function foo($foo = 0)
    {
        $this->foo += $foo;

        print_r($this->foo);
    }
}

```

#### 长生命周期

[](#长生命周期)

单例模式

```
// 门面
class Test extends \HyperfFacade\Facade
{
    protected static function getFacadeAccessor()
    {
        // 实例
        return \App\Server\Test::class;
    }
}

// 测试
Test::foo(1);  // 1
Test::foo(1);  // 2
Test::foo(1);  // 3
Test::foo(1);  // 4

```

#### 短生命周期

[](#短生命周期-1)

使用门面时，同等 new 了一次

```
// 门面
class Test extends \HyperfFacade\Facade
{
    protected static function getFacadeAccessor()
    {
        // 实例
        return \App\Server\Test::class;
    }

    protected static function singleton()
    {
        return false;
    }
}

// 测试
Test::foo(1);  // 1
Test::foo(1);  // 1
Test::foo(1);  // 1
Test::foo(1);  // 1

```

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~200 days

Total

2

Last Release

1915d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7370a135b7bbe96c933f049e6d8fc24ab3fd886216dd856f4dacc3bfd578858f?d=identicon)[liuchang103](/maintainers/liuchang103)

---

Top Contributors

[![liuchang103](https://avatars.githubusercontent.com/u/55739415?v=4)](https://github.com/liuchang103 "liuchang103 (5 commits)")

---

Tags

phphyperf

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/liuchang103-hyperf-facade/health.svg)

```
[![Health](https://phpackages.com/badges/liuchang103-hyperf-facade/health.svg)](https://phpackages.com/packages/liuchang103-hyperf-facade)
```

###  Alternatives

[hyperf/watcher

Hot reload watcher for Hyperf

17846.7k27](/packages/hyperf-watcher)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)