PHPackages bklab/think-nacos-sdk - 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. bklab/think-nacos-sdk ActiveLibrary[Utility & Helpers](/categories/utility) bklab/think-nacos-sdk ===================== thinkphp nacos 2.x sdk for thinkphp ^8.0.3 0.0.3(2y ago)314Apache-2.0PHPPHP ^8.0 Since Nov 30Pushed 2y ago1 watchersCompare [ Source](https://github.com/CNBroderick/think-nacos-sdk)[ Packagist](https://packagist.org/packages/bklab/think-nacos-sdk)[ Docs](https://github.com/CNBroderick/think-nacos-sdk)[ RSS](/packages/bklab-think-nacos-sdk/feed)WikiDiscussions main Synced today READMEChangelog (3)Dependencies (1)Versions (4)Used By (0) ThinkPHP Nacos 2.x 扩展 ===================== [](#thinkphp-nacos-2x-扩展) ThinkPHP Nacos 2.x 扩展 1. 安装 ----- [](#1-安装) ### 1.1 命令行部署 [](#11-命令行部署) composer require bklab/think-nacos-sdk > 还未发布，暂时无法使用 ### 1.2 手动部署 [](#12-手动部署) composer.json 中添加如下配置 #### 1.2.1. 仓库 [](#121-仓库) ``` { "repositories": [ { "type": "path", "url": "path/to/think-nacos-sdk", "options": { "versions": { "bklab/think-nacos-sdk": "0.0.1" } } } ] } ``` #### 1.2.2. 依赖 [](#122-依赖) ``` { "require": { "bklab/think-nacos-sdk": "0.0.1" } } ``` 2. 配置 ----- [](#2-配置) ### 2.1. 自动注册 [](#21-自动注册) > ThinkPHP框架在应用初始化时 #### 2.1.1. 参考文档 [](#211-参考文档) [ThinkPHP 文档 -> 架构 -> 事件 -> 内置事件 ](https://doc.thinkphp.cn/v8_0/event.html) #### 2.1.2. 正确填写相关配置 [](#212-正确填写相关配置) 在config/nacos.php 中正确填写服务器和Nacos的相关信息 #### 2.1.3. 在app/event.php中填写 [](#213-在appeventphp中填写) ``` // 事件定义文件 return [ // ...... 'listen' => [ 'AppInit' => [ 'think\sdk\alibaba\nacos\v2\Nacos', //推荐放到末尾 ], ], // ...... ]; ``` ### 2.2. 手动注册 [](#22-手动注册) #### 2.2.1. 通过HTTP注册 [](#221-通过http注册) ``` public function register_nacos() { // 设置用户永远执行 set_time_limit(0); // 设置用户永不超时 ini_set('max_execution_time', '0'); // 设置用户中断时继续执行 ignore_user_abort(true); // 获取本机内网IP $ip = gethostbyname(gethostname()); $ip = $this->request->get('ip', $ip); $port = $this->request->get('port', 80); // 具体配置信息见下方 return '已将' . $ip . ':' . $port . '注册到Nacos。'; } ``` #### 2.2.2. 当填写配置文件时 [](#222-当填写配置文件时) ``` $nacos = new \think\sdk\alibaba\nacos\v2\Nacos() ->register() // 注册服务到Nacos ; ``` #### 2.2.3. 动态配置 [](#223-动态配置) ``` // 如需动态配置Nacos，请使用此方法获取 $config = new \think\sdk\alibaba\nacos\v2\config\NacosConfig::getInstance(); // 默认通过此方法获取本机内网IP $config ->setServerIp(gethostbyname(gethostname())); // 如监听端口非80，且配置文件未填写，则需要手动设置 $config ->setServerPort(8080); $nacos = new \think\sdk\alibaba\nacos\v2\Nacos() ->register() // 注册服务到Nacos ; ``` ### 2.3. 监听配置更改 [](#23-监听配置更改) #### 2.3.1 配置监听事件 [](#231-配置监听事件) ``` \think\Event::listen( \think\sdk\alibaba\nacos\v2\event\NacosConfigChangeEvent::class, function ($raw_config){ dump('nacos config change', $raw_config); } ); ``` #### 2.3.2 在单独一个线程中执行 [](#232-在单独一个线程中执行) ``` $nacos = new \think\sdk\alibaba\nacos\v2\Nacos() ->listen() // 开始监听（每秒查询更改） ->cancelListening() // 当需要停止监听时，调用 ; ``` 启动方式： > 可以在启动时，可以通过http调用一个地址来实现配置的加载。 > 此接口需要设置不自动关闭，否则会在自动关闭时停止监听。 > 此接口需要自行实现，不在本扩展内实现。 3. 目录结构 ------- [](#3-目录结构) ``` -sdk: -alibaba: -nacos: -v2: -Nacos.php: 主类，用于注册服务器地址，监听配置更新 -auth: 鉴权相关 -config: 配置相关 -enum: 枚举类 -event: 事件类 -request: # 请求类 https://nacos.io/zh-cn/docs/v2/guide/user/open-api.html -auth: 权限认证 https://nacos.io/zh-cn/docs/v2/guide/user/auth.html -cluster: 集群管理 -config: 配置管理 -discovery: # 服务发现 -client: 客户端相关 -instance: 实例相关 -service: 服务相关 -system: 系统相关 -loader: 连接负载管理 -name_space: 命名空间 -response: 全部响应数据类 -util: 工具类 ``` 4. 其他 ----- [](#4-其他) 任何BUG或者建议，欢迎提交issue或者PR。 ### Health Score 21 — LowBetter than 18% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community7 Small or concentrated contributor base Maturity40 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 3 Last Release 945d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/9ac41304e1cf06be7739179a0fcbb90f0563d8f7fb89ddbf1a3cc3830b2c58c2?d=identicon)[CNBroderick](/maintainers/CNBroderick) --- Top Contributors [![CNBroderick](https://avatars.githubusercontent.com/u/27131135?v=4)](https://github.com/CNBroderick "CNBroderick (21 commits)") --- Tags thinkphpnacosthink-nacos-sdk ### Embed Badge ![Health badge](/badges/bklab-think-nacos-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/bklab-think-nacos-sdk/health.svg)](https://phpackages.com/packages/bklab-think-nacos-sdk) ``` ### Alternatives [liliuwei/thinkphp-jump 适用于thinkphp6.0+的跳转扩展 2876.7k1](/packages/liliuwei-thinkphp-jump)[xiaodi/think-pullword ThinkPHP 分词/抽词 扩展包 5612.5k](/packages/xiaodi-think-pullword)[ichynul/tpextmyadmin thinkphp extension 141.6k](/packages/ichynul-tpextmyadmin)[xiaodi/think-pinyin ThinkPHP 中文转拼音扩展包 344.8k](/packages/xiaodi-think-pinyin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)