README

Nacos配置中心的PHP客户端，更多关于Nacos配置中心的介绍，可以查看Nacos配置中心Wiki。

特性

1. 容错兜底
2. 容易上手
3. 技术支持，有问题可提交issue

开发计划

• 增强容错机制
• 实现服务发现
• Laravel框架集成
• Dummy模式(本地开发不走配置中心)
• Yii框架集成
• ThinkPHP框架集成
• Symfony框架集成

composer安装

composer require mimic/nacos

使用crontab拉取配置文件

定时1分钟拉取一次

*/1 */1 * * * php path/to/cron.php

# cron.php
Nacos::init(
    "http://127.0.0.1:8848/",
    "dev",
    "LARAVEL",
    "DEFAULT_GROUP",
    ""
)->runOnce();

拉取到的配置文件路径：当前工作目录/nacos/config/dev_nacos/snapshot/LARAVEL

配置文件保存的工作目录可以通过下面命令修改

NacosConfig::setSnapshotPath("指定存放配置文件的目录路径");

长轮询拉取配置文件

Nacos::init(
    "http://127.0.0.1:8848/",
    "dev",
    "LARAVEL",
    "DEFAULT_GROUP",
    ""
)->listener();

事件监听器

GetConfigRequestErrorListener::add(function($config) {
    if (!$config->getConfig()) {
        echo "获取配置异常, 配置为空，下面进行自定义逻辑处理" . PHP_EOL;
        // 设置是否修改配置文件内容，如果修改成true，这里设置的配置文件内容将是最终获取到的配置文件
        $config->setChanged(true);
        $config->setConfig("hello");
    }
});

配置兜底方案

将兜底的配置文件放入下面的路径里

如果有给$tenant设置值，文件路径这样计算

工作目录/nacos/config/{$env}_nacos/config-data-{$tenant}/{$dataId}

否则

工作目录/nacos/config/{$env}_nacos/config-data/{$dataId}

nacos会在无法从配置中心查询配置文件时将读取上面的配置文件

Dummy模式(本地开发不走配置中心)

配置环境变量NACOS_ENV=local再启动项目

export NACOS_ENV=local

贡献者 ✨

Thanks goes to these wonderful people:

fatrbaby 📖

TELstatic 📖

wujunze 📖

Contributions of any kind are welcome!