如何优雅地管理Laravel应用中的功能开关？j-webb/laravel-unleash助你实现动态发布与A/B测试

<code class="bash">composer require j-webb/laravel-unleash</code>

<code class="bash">php artisan vendor:publish --provider="JWebb\Unleash\Providers\ServiceProvider"</code>

<code class="dotenv">UNLEASH_URL=https://app.unleash-hosted.com/ # 替换为你的Unleash实例地址</code>

<pre class="brush:php;toolbar:false;">UNLEASH_ENABLED=true           # 启用或禁用Unleash客户端，禁用时所有功能检查都返回false
UNLEASH_API_KEY=123456         # 用于Unleash V4或其它认证方式，会自动添加到Authorization头
UNLEASH_INSTANCE_ID=default    # 应用实例ID，通常是主机名或podId
UNLEASH_ENVIRONMENT=production # Unleash环境名称，用于环境特定的功能控制
UNLEASH_AUTOMATIC_REGISTRATION=true # 是否自动向Unleash服务器注册客户端实例
UNLEASH_METRICS=true           # 启用或禁用指标收集
UNLEASH_CACHE_ENABLED=true     # 启用或禁用故障安全缓存
UNLEASH_CACHE_TTL=30           # 缓存TTL（秒）

<pre class="brush:php;toolbar:false;">use JWebb\Unleash\Facades\Unleash;

if (Unleash::isEnabled('your_feature_name')) {
    // 'your_feature_name' 功能已启用，执行相关逻辑
    echo "新功能已上线！";
} else {
    // 功能未启用，显示旧版或替代内容
    echo "旧功能正在运行。";
}

<pre class="brush:php;toolbar:false;">$allFeatures = Unleash::getFeatures(); // 获取所有功能（启用或禁用）
$enabledFeatures = Unleash::getFeatures(true); // 只获取已启用的功能

<pre class="brush:php;toolbar:false;">use Unleash\Client\ContextProvider\UnleashContext;
use JWebb\Unleash\Facades\Unleash;

$context = (new UnleashContext())
    ->setCurrentUserId(auth()->id() ?? 'guest') // 自动添加Laravel Auth的用户ID
    ->setIpAddress(request()->ip())
    ->setSessionId(session()->getId());

if (Unleash::isEnabled('premium_feature', $context)) {
    // 只有高级用户才能访问此功能
    echo "欢迎，尊贵的用户！";
}

<pre class="brush:php;toolbar:false;">@featureEnabled('betaTester')
    <p>恭喜您，是我们的Beta测试用户！</p>
@endfeatureEnabled

@featureDisabled('betaTester')
    <p>立即注册成为Beta测试用户，体验最新功能！</p>
@endfeatureDisabled

<pre class="brush:php;toolbar:false;">// app/Http/Kernel.php
protected $routeMiddleware = [
    // ...
    'feature' => \JWebb\Unleash\Middleware\CheckFeature::class,
];

<pre class="brush:php;toolbar:false;">// routes/web.php
Route::get('/new-dashboard', function () {
    return view('new-dashboard');
})->middleware('feature:new_dashboard_feature');

// app/Http/Controllers/ExampleController.php
class ExampleController extends Controller
{
    public function __construct()
    {
        $this->middleware('feature:your_feature_name');
    }

    // ...
}