PHPackages                             tinywan/nacos - 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 &amp; Helpers](/categories/utility)
4. /
5. tinywan/nacos

AbandonedArchivedLibrary[Utility &amp; Helpers](/categories/utility)

tinywan/nacos
=============

webman nacos plugin

v0.1.0(4y ago)672MITPHPPHP &gt;=7.4

Since Mar 16Pushed 4y ago1 watchersCompare

[ Source](https://github.com/Tinywan/nacos)[ Packagist](https://packagist.org/packages/tinywan/nacos)[ RSS](/packages/tinywan-nacos/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (6)Dependencies (6)Versions (7)Used By (0)

webman nacos plugin
===================

[](#webman-nacos-plugin)

[![Latest Stable Version](https://camo.githubusercontent.com/c9c239fbae82ec37e38aa8afb5991c720c396d2acd9af20fc9a7314b73bf769f/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f6e61636f732f76)](https://packagist.org/packages/tinywan/nacos)[![Total Downloads](https://camo.githubusercontent.com/50648cecbcafbc3ad6fc7cd1722c8fc02912307db7efe44459c3760ce741b690/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f6e61636f732f646f776e6c6f616473)](https://packagist.org/packages/tinywan/nacos)[![Latest Unstable Version](https://camo.githubusercontent.com/2dd2cc03adaf8113e7fcb2ac48767e5a1065be5204c6d2a122a26df130dff3ce/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f6e61636f732f762f756e737461626c65)](https://packagist.org/packages/tinywan/nacos)[![License](https://camo.githubusercontent.com/d50e29d8d0b0ece3865e4d3b25c461407888c7d266edf7011130be8d2bc8ca58/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f6e61636f732f6c6963656e7365)](https://packagist.org/packages/tinywan/nacos)[![PHP Version Require](https://camo.githubusercontent.com/d1db66192298a1e288e6c2689c5d59cc72454d0afe75c82b687855825f08fcfd/687474703a2f2f706f7365722e707567782e6f72672f74696e7977616e2f6e61636f732f726571756972652f706870)](https://packagist.org/packages/tinywan/nacos)

安装
--

[](#安装)

```
composer require tinywan/nacos
```

基本用法
----

[](#基本用法)

### 认证

[](#认证)

```
use Tinywan\Nacos\Nacos;

$nacos = new Nacos();
$login = $nacos->auth->login('nacos', 'nacos');
var_dump($login->getBody()->getContents());
```

> Docker环境，添加环境变量 `NACOS_AUTH_ENABLE=true`（默认该值为false）

#### 认证成功

[](#认证成功)

若用户名和密码正确,返回信息如下

```
{
  "accessToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJuYWNvcyIsImV4cCI6MTY0NzUwMzcxMX0.m1p2WKSz1TNj3ftUgKSJuj7Yu4SdoQiV-k0rm6IbvFg",
  "tokenTtl": 18000,
  "globalAdmin": true,
  "username": "nacos"
}
```

#### 认证失败

[](#认证失败)

抛出 `NacosAuthException` 异常

### 配置

[](#配置)

#### 获取配置

[](#获取配置)

```
use Tinywan\Nacos\Nacos;

$nacos = new Nacos();
$response = $nacos->config->get('database', 'DEFAULT_GROUP');
if (false === $response) {
    var_dump($nacos->config->getMessage());
}
```

#### 发布配置

[](#发布配置)

```
use Tinywan\Nacos\Nacos;

$nacos = new Nacos();
$content = [
    'listen' => 'http://0.0.0.0:8888',
    'transport' => 'tcp',
    'context' => [],
    'name' => 'webman-admin',
];
$response = $nacos->config->publish('aliyun', 'DEFAULT_GROUP',json_encode($content));
if (false === $response) {
    var_dump($nacos->config->getMessage());
}
```

### 实例

[](#实例)

#### 注册实例

[](#注册实例)

```
use Tinywan\Nacos\Nacos;

$nacos = new Nacos();
$optional = [
    'groupName' => 'webman-group',
    'clusterName' => 'webman',
    'namespaceId' => 'webman',
    'weight' => 99.0,
    'metadata' => '',
    'enabled' => true,
    'ephemeral' => false
];
$response = $nacos->instance->register('127.0.0.1', 8888,'webman-admin',$optional);
```

鉴权
--

[](#鉴权)

OpenAPI
-------

[](#openapi)

- 配置管理
    - [获取配置](https://nacos.io/zh-cn/docs/open-api.html#1.1)
    - [监听配置](https://nacos.io/zh-cn/docs/open-api.html#1.2)
    - [发布配置](https://nacos.io/zh-cn/docs/open-api.html#1.3)
    - [删除配置](https://nacos.io/zh-cn/docs/open-api.html#1.4)
    - [查询历史版本](https://nacos.io/zh-cn/docs/open-api.html#1.5)
    - [查询历史版本详情](https://nacos.io/zh-cn/docs/open-api.html#1.6)
    - [查询配置上一版本信息](https://nacos.io/zh-cn/docs/open-api.html#1.7)
- 服务发现
    - [注册实例](https://nacos.io/zh-cn/docs/open-api.html#2.1)
    - [注销实例](https://nacos.io/zh-cn/docs/open-api.html#2.2)
    - [修改实例](https://nacos.io/zh-cn/docs/open-api.html#2.3)
    - [查询实例列表](https://nacos.io/zh-cn/docs/open-api.html#2.4)
    - [查询实例详情](https://nacos.io/zh-cn/docs/open-api.html#2.5)
    - [发送实例心跳](https://nacos.io/zh-cn/docs/open-api.html#2.6)
    - [创建服务](https://nacos.io/zh-cn/docs/open-api.html#2.7)
    - [删除服务](https://nacos.io/zh-cn/docs/open-api.html#2.8)
    - [修改服务](https://nacos.io/zh-cn/docs/open-api.html#2.9)
    - [查询服务](https://nacos.io/zh-cn/docs/open-api.html#2.10)
    - [查询服务列表](https://nacos.io/zh-cn/docs/open-api.html#2.11)
    - [查询系统开关](https://nacos.io/zh-cn/docs/open-api.html#2.12)
    - [修改系统开关](https://nacos.io/zh-cn/docs/open-api.html#2.13)
    - [查看系统当前数据指标](https://nacos.io/zh-cn/docs/open-api.html#2.14)
    - [查看当前集群Server列表](https://nacos.io/zh-cn/docs/open-api.html#2.15)
    - [查看当前集群leader](https://nacos.io/zh-cn/docs/open-api.html#2.16)
    - [更新实例的健康状态](https://nacos.io/zh-cn/docs/open-api.html#2.17)
    - [批量更新实例元数据(Beta)](https://nacos.io/zh-cn/docs/open-api.html#2.18)
    - [批量删除实例元数据(Beta)](https://nacos.io/zh-cn/docs/open-api.html#2.19)
- 命名空间
    - [查询命名空间列表](https://nacos.io/zh-cn/docs/open-api.html#3.1)
    - [创建命名空间](https://nacos.io/zh-cn/docs/open-api.html#3.2)
    - [修改命名空间](https://nacos.io/zh-cn/docs/open-api.html#3.3)
    - [删除命名空间](https://nacos.io/zh-cn/docs/open-api.html#3.4)

Other
-----

[](#other)

composer

```
composer dumpautoload

```

phpstan

```
vendor/bin/phpstan analyse src
```

php-cs-fixer

```
vendor/bin/php-cs-fixer fix src
```

Basic
-----

[](#basic)

- `__toString()` 方法用于一个类被当成字符串时应怎样回应。例如 echo $obj; 应该显示些什么。 > 警告：在 PHP 7.4.0 之前不能在 \_\_toString() 方法中抛出异常。这么做会导致致命错误。
- `__invoke()` 当尝试以调用函数的方式调用一个对象时，\_\_invoke() 方法会被自动调用。
- `__callStatic()` 在静态上下文中调用一个不可访问方法时，\_\_callStatic() 会被调用。

### 观察者模式

[](#观察者模式)

- 主题
- 观察者（订阅、取消主题）

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

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 ~0 days

Total

6

Last Release

1557d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b0042e0b68ff6a731ef382a03eecd211736c2d619acc55b2b326988085f72bfb?d=identicon)[Tinywan](/maintainers/Tinywan)

---

Top Contributors

[![Tinywan](https://avatars.githubusercontent.com/u/14959876?v=4)](https://github.com/Tinywan "Tinywan (26 commits)")

---

Tags

nacosphp-librarypluginwebmanwebman-frameworkworkermanpluginnacoswebman

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/tinywan-nacos/health.svg)

```
[![Health](https://phpackages.com/badges/tinywan-nacos/health.svg)](https://phpackages.com/packages/tinywan-nacos)
```

###  Alternatives

[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k496.1k33](/packages/neuron-core-neuron-ai)[roundcube/roundcubemail

The Roundcube Webmail suite

7.0k1.4k3](/packages/roundcube-roundcubemail)[spatie/laravel-export

Create a static site bundle from a Laravel app

672139.5k6](/packages/spatie-laravel-export)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

232.5k](/packages/eslazarev-wildberries-sdk)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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