如何在项目中使用Composer加载 PHP-Feature-Flag 库实现功能开关与灰度发布-composer-PHP中文网

“php-feature-flag”非packagist官方包，composer require会失败；应通过composer search feature flag查找可用方案（如launchdarkly/ld-php-server-sdk），或为私有库配置vcs仓库、autoload映射并指定分支。

如何在项目中使用composer加载 php-feature-flag 库实现功能开关与灰度发布

PHP-Feature-Flag 不是 Composer 官方包，也未发布在 Packagist 上——直接 composer require php-feature-flag 会失败。你得自己处理源码引入或换用真正可安装的替代方案。

确认你用的是哪个“PHP-Feature-Flag”

GitHub 上有多个同名/近名项目，比如：
• thecodingmachine/php-feature-flags（已归档，不维护）
• launchdarkly/ld-php-server-sdk（商业 SDK，支持 flag、targeting、灰度）
• 自研轻量库（常见于内部 Git 仓库）

执行 composer search feature flag 查看可用包，或直接访问 Packagist 搜索关键词。别凭印象写包名，拼错就报 Could not find package。

若使用 LaunchDarkly SDK（推荐用于生产灰度）

它支持用户分群、百分比放量、环境隔离，且有 PHP 官方维护：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

运行 composer require launchdarkly/ld-php-server-sdk
初始化时必须传入 SDK key（不是 client-side ID），否则 LDClient::__construct() 抛 InvalidArgumentException
flag 计算默认同步调用，高并发下建议搭配 LaunchDarklyImplIntegrationsRedis 做缓存，否则每次请求都打 LD 服务
灰度逻辑靠 variation('my-flag-key', $user, false) 的 $user 参数驱动：需含 key（必填）、custom（如 ['region' => 'cn', 'version' => '2.1']）

若坚持用私有 Git 仓库的 feature-flag 库

Composer 默认不拉取非 Packagist 包，必须显式声明源：

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://your-git-server.com/team/php-feature-flag.git"
        }
    ],
    "require": {
        "your-vendor/php-feature-flag": "dev-main"
    }
}

注意三点：

url 必须能被 Composer 机器 git clone（SSH 或 HTTPS + 凭据）
分支名写 dev-main 还是 dev-master 取决于远程默认分支，写错会报 Could not find a matching version
私有库没 autoload 配置？得手动加 "autoload": {"psr-4": {"FeatureFlag\": "src/"}} 并运行 composer dump-autoload

本地开发时 flag 总是 false？检查这三处

灰度开关不生效，90% 是配置或上下文问题：

SDK 初始化后是否调用了 $client->flush() 或等待了 start() 的异步加载完成？未就绪时 variation() 默认返回 fallback 值（常为 false）
$user 的 key 是空字符串、null 或重复值？LD 后台按 key 哈希分流，无效 key 导致永远进 baseline 分支
当前环境（environment）和 flag 的 targeting 规则不匹配——比如 flag 只对 production 环境开启，但你的 LD_ENVIRONMENT 设成了 staging