انتقل إلى المحتوى
NanoFlags
ابدأ مجانًا

حِزم SDK

SDK ‏PHP

صُمّمت الحزمة nanoflags/nanoflags لطريقة عمل PHP: طلب واحد في كل مرة، ولا شيء يبقى بين الطلبات. تُقيَّم الأعلام محليًا على إعداد موقّع تتشاركه الطلبات عبر ذاكرة مؤقتة، ويُعاد التحقق منه بطلب شرطي زهيد الكلفة. ولا يرمي استدعاء القراءة استثناءً أبدًا.

التثبيت

sh
composer require nanoflags/nanoflags
composer require nanoflags/openfeature-provider   # optional: OpenFeature provider
  • منشورة على Packagist باسم nanoflags/nanoflags 0.2.0 وnanoflags/openfeature-provider 0.2.0. تتطلب PHP 8.1 أو أحدث، ولا ترتبط بإطار عمل بعينه (Laravel وSymfony وSlim وWordPress وPHP المجرّدة).
  • الامتدادات المستحسنة: sodium (للتحقق من التوقيع؛ مضمّن في معظم إصدارات PHP، أو paragonie/sodium_compat)، وcurl، وapcu (الذاكرة المؤقتة المشتركة الافتراضية مع PHP-FPM)، وintl (تطبيع Unicode أسرع؛ وإلا يُستخدم بديل برمجي).
  • تتصل بها ذاكرات PSR-16 المؤقتة وعملاء HTTP المتوافقون مع PSR-18؛ ووسيلة النقل المدمجة تستخدم ext-curl، أو تدفقات PHP عند غيابه. والمحرك نقلٌ أصلي لمحرك NanoFlags، مختبَر على الحالات المشتركة المولَّدة من المحرك المرجعي (21,998 حالة تقييم)، فيعطي النتائج نفسها التي تعطيها كل حزم SDK الأخرى.
  • برخصة Apache-2.0. والشيفرة المصدرية في nanoflags-sdk/php.

البدء السريع

انسخ مفتاح خادم (nf_srv_…) من الإعدادات ← مفاتيح SDK (Settings → SDK keys) في لوحة التحكم واحفظه في متغير بيئة. ومرّر onError (أو مسجّل logger متوافقًا مع PSR-3) إلى المُنشئ، ليُبلَّغ عن أخطاء التحميل الأول أيضًا.

index.php
use NanoFlags\Client;
use NanoFlags\NanoFlagsException;

$flags = new Client(
    getenv('NANOFLAGS_SDK_KEY'),   // nf_srv_… (server view) or nf_pub_… (client-exposed flags only)
    service: 'checkout-api',       // shown in "which revision is each service running"
    onError: fn (NanoFlagsException $e) => error_log("nanoflags {$e->errorCode}: {$e->getMessage()}"),
);

$user = ['key' => $userId, 'plan' => 'beta', 'country' => 'DE'];

if ($flags->boolVariation('new-checkout', false, $user)) {
    // …
}
  • لا يُجري إنشاء العميل أي عملية إدخال/إخراج. يحمّل أول تقييم (أو status()) الإعداد من الذاكرة المؤقتة المشتركة، ولا يلجأ إلى الحافة إلا حين يحين موعد إعادة التحقق من النسخة المخزّنة.
  • لا جاهزية تنتظرها: لا يتغيّر الإعداد خلال الطلب الواحد. وتعيد status() القيمة ready أو stale أو not-ready، ويحمل lastError() آخر خطأ.
  • من دون مستمع أو مسجّل لا تظهر الأخطاء إلا عبر lastError(). والعنوان الأساسي افتراضيًا هو الحافة المستضافة https://edge.nanoflags.io.

القراءات المُنمَّطة والتفاصيل

كل دالة قراءة تأخذ مفتاح العلم، والقيمة التي تُقدَّم حين يتعذّر تقييم العلم، والسياق: مصفوفة ترابطية من خصائص شبيهة بـ JSON. وkey هو الهوية الثابتة المستخدمة في الطرح بالنسب المئوية.

php
$enabled = $flags->boolVariation('new-checkout', false, $user);
$accent  = $flags->stringVariation('accent', 'blue', $user);
$limit   = $flags->numberVariation('rate-limit', 100, $user);       // int for whole numbers, else float
$layout  = $flags->jsonVariation('layout', ['cols' => 3], $user);   // JSON objects as associative arrays

$every   = $flags->allFlags($user);                                 // no telemetry

$d = $flags->boolVariationDetail('new-checkout', false, $user);
printf("%s %s %s r%d\n", var_export($d->value, true), $d->reason, $d->ruleId, $d->revision);   // true rule_match beta r57
foreach ($d->trace as $step) { /* the same steps the dashboard shows */ }
الخاصيةالمعنى
valueالقيمة المقدَّمة (قيمتك الافتراضية في حالات الاحتياط).
reasonrule_match، default (لم تطابق قاعدة)، off (العلم معطّل)، flag_not_found، error (نوع خاطئ أو إعداد مشوّه)
ruleIndex · ruleIdالقاعدة المطابقة (فهرس يبدأ من الصفر)، أو null.
inRollout · bucketللطرح بالنسب المئوية: هل المفتاح داخل التوزيع، وشريحته (من 0 إلى 99.99).
revisionنسخة الإعداد التي جاءت منها النتيجة.
traceقائمة من TraceStep تشرح القرار خطوة بخطوة.
error · json() · typeName()لماذا كان reason هو error؛ والقيمة الخام كنص JSON واسم نوعها.

تحصل على قيمتك الافتراضية حين لا يكون شيء محمَّلًا، أو حين يكون العلم مجهولًا، أو حين يقدّم قيمة من نوع آخر. والعلم المعطّل ليس حالة احتياط: فهو يعيد قيمة off المضبوطة له. وتعيد evaluate($key, $default, $context) نتيجة المحرك دون فحص للنوع.

كيف تعمل في PHP

الحالةما يحدث
أول تقييم في الطلب، والحزمة المخزّنة أُعيد التحقق منها قبل أقل من cacheTtl ‏(30 ثانية)بلا شبكة: تُستخدم الحزمة المخزّنة (الحالة ready).
الحزمة المخزّنة أقدم من cacheTtlطلب شرطي واحد GET /v1/bundle مع ETag المخزّن (المهلة timeout، ‏3 ثوانٍ). والجواب عادةً 304 Not Modified؛ والنسخة الجديدة يُتحقَّق منها وتُخزَّن وتُستخدم.
الحافة غير متاحة أو بطيئة أو تفشلتواصل الحزمة المخزّنة الخدمة (الحالة stale)؛ ويُعاد سؤال الحافة بعد retryInterval ‏(5 ثوانٍ)، لا في كل طلب.
لا شيء مخزّن والحافة غير متاحةbootstrap إن مُرّر، وإلا قيمك الافتراضية (الحالة not-ready).
PHP طويلة التشغيل (Octane وRoadRunner وSwoole وعمّال الطوابير)أعد استخدام عميل واحد: يعيد التحقق من تلقاء نفسه بعد مرور cacheTtl. واستدعِ flush() بعد كل مهمة أو طلب لإرسال القياس.

يحمل مُدخل الذاكرة المؤقتة البايتات الموقّعة كما هي، ويُتحقَّق من التوقيع مجددًا عند كل قراءة (فالذاكرة المؤقتة خارج حدود الثقة)، مع حفظ النتيجة المحلَّلة لكل عملية. ولا يعود العميل أبدًا إلى نسخة أقدم من التي لديه، حتى حين تقدّم الحافة نفسها آخر نسخة سليمة تعرفها.

اختيار الذاكرة المؤقتة

php
use NanoFlags\Client;
use NanoFlags\Store\{ApcuStore, FileStore, Psr16Store};

new Client($key);                                                // default: APCu when enabled, else a private dir in sys_get_temp_dir()
new Client($key, cache: new FileStore('/var/cache/nanoflags'));  // shared by every process of the machine
new Client($key, cache: Cache::store('redis'));                  // Laravel: any PSR-16 cache, shared by all servers
new Client($key, cache: new Symfony\Component\Cache\Psr16Cache($pool));
new Client($key, cache: false);                                  // no cache: every client fetches (CLI scripts)
  • ذاكرة APCu خاصة بكل مجموعة PHP-FPM وكل جهاز. أما ذاكرة PSR-16 على Redis أو Memcached فتتشارك حزمة واحدة، وإعادة تحقق واحدة، بين كل الخوادم.
  • تُنشأ المجلدات بالصلاحية 0700 وتُكتب الملفات ذرّيًا بالصلاحية 0600. وتحمل الذاكرة المؤقتة قواعد الأعلام، ولا تحمل مفتاح الـ SDK أبدًا.
  • مع offline: true لا تُمسّ الشبكة أبدًا (التهيئة المسبقة والذاكرة المؤقتة فقط، بلا قياس)، للاختبارات والبيئات المعزولة. وتأخذ bootstrap: حزمة (نص JSON أو مصفوفة محلَّلة) تُستخدم حين لا يتوفر ما هو أفضل.

عملية المزامنة

مع عملية المزامنة الاختيارية لا تنتظر طلبات الويب الحافة أبدًا: تُبقي vendor/bin/nanoflags-sync الذاكرة المؤقتة المشتركة محدّثة عبر تدفق أحداث الحافة (/v1/stream) مع استطلاع احتياطي، ولا يفعل عمّال الويب سوى القراءة من الذاكرة المؤقتة.

config/nanoflags.php
// the same key, base URL and cache as the web workers
return new NanoFlags\Client(getenv('NANOFLAGS_SDK_KEY'), service: 'web', cache: new NanoFlags\Store\FileStore('/var/cache/nanoflags'));
sh
vendor/bin/nanoflags-sync config/nanoflags.php                  # runs until stopped (systemd, supervisord, a sidecar)
vendor/bin/nanoflags-sync config/nanoflags.php --interval=15    # safety poll every 15 s (default 30)
vendor/bin/nanoflags-sync config/nanoflags.php --once           # one revalidation (cron); exit code 1 when not current
worker.php
// never fetch: read what the daemon cached
$flags = new Client(getenv('NANOFLAGS_SDK_KEY'), service: 'web', cache: new FileStore('/var/cache/nanoflags'), refresh: false);
  • يعيد ملف الإعداد كائن NanoFlags\Client (أو دالة تعيده) مضبوطًا بمفتاح الـ SDK والعنوان الأساسي والذاكرة المؤقتة نفسها التي يستخدمها عمّال الويب. وتطبع العملية كل حالة ونسخة جديدتين على stdout، والأخطاء على stderr.
  • ذاكرة APCu لا تُشارَك مع عملية سطر الأوامر: استخدم مجلدًا أو ذاكرة PSR-16 شبكية مع عملية المزامنة.
  • من دون refresh: false يظل العمّال يعيدون التحقق بأنفسهم كلما تأخرت عملية المزامنة. والخيار --no-stream يكتفي بالاستطلاع. وتشغّل العملية $client->run($pollInterval, $stream, $duration, $onSync)، ويمكنك استدعاؤها أيضًا من أمر طويل التشغيل خاص بك.

Laravel وSymfony

app/Providers/AppServiceProvider.php
$this->app->scoped(NanoFlags\Client::class, fn () => new NanoFlags\Client(
    config('services.nanoflags.key'),
    service: config('app.name'),
    cache: Cache::store(),          // any configured store
    logger: Log::channel(),
));
// usage: app(NanoFlags\Client::class)->boolVariation('new-checkout', false, ['key' => (string) auth()->id()])

مع Octane استخدم scoped كما أعلاه (عميل جديد لكل طلب، وذاكرة مؤقتة واحدة)، أو عميلًا واحدًا (singleton) مع استدعاء flush() في دالة تعمل عند انتهاء الطلب.

config/services.yaml
services:
    nanoflags.cache:
        class: Symfony\Component\Cache\Psr16Cache
        arguments: ['@cache.app']
    NanoFlags\Client:
        arguments:
            $sdkKey: '%env(NANOFLAGS_SDK_KEY)%'
            $service: 'checkout-api'
            $cache: '@nanoflags.cache'
            $logger: '@logger'

يتصل عميل PSR-18 هكذا: new Client($key, http: $psr18Client, requestFactory: $psr17Factory, streamFactory: $psr17Factory). امنحه مهلة قصيرة (فطلب الحزمة قد يجري أثناء معالجة الطلب) وعطّل إعادة التوجيه. وتحترم وسيلة النقل المدمجة عبر curl المتغيرات HTTPS_PROXY / NO_PROXY وCURL_CA_BUNDLE / SSL_CERT_FILE.

جلسات الاختبار

تثبّت جلسة الاختبار المشتركة (بالإنجليزية)، التي تُنشأ في لوحة التحكم (السيناريوهات ← جلسة اختبار مشتركة، Scenarios → Shared test session)، لقطةً من الإعداد وسياقًا اصطناعيًا على رمز (nf_ts_…). والخدمة التي تتلقى الرمز في ترويسة x-nanoflags-session تقيّم على تلك اللقطة، بسياق الجلسة مضافًا إليه سياقك (والغلبة لسياقك)، لذلك الطلب وحده. وتحمل الأحداث المأخوذة كعيّنة من جلسة معرّفَها. وجلسات الاختبار المشتركة جزء من خطة Scale.

php
// Plain PHP / Laravel / Symfony: the header of the current request
$f = $flags->sessionFromGlobals();              // or $flags->session($request->headers->get('x-nanoflags-session'))
$f->boolVariation('checkout-v2', false, ['key' => $userId]); // session-scoped while the session is active
$f->isActive(); $f->id(); $f->expiresAt(); $f->revision();
$http->request('GET', $pricingUrl, ['headers' => $f->headers()]); // the next service joins the session ([] outside one)

// PSR-15 (Slim, Mezzio, …): the evaluator becomes the request attribute "nanoflags.flags"
$app->add(new NanoFlags\SessionMiddleware($flags));
$f = $request->getAttribute(NanoFlags\SessionMiddleware::ATTRIBUTE);
  • تسأل session($token, $service = null) الحافة مرة واحدة لكل رمز وخدمة (GET /v1/session، والرمز في X-NanoFlags-Session، و$service (افتراضيًا: service الخاصة بالعميل) في X-NanoFlags-Service). وتقرأ sessionFromGlobals() ترويسة الطلب الحالي من $_SERVER.
  • لا ترمي استثناءً أبدًا: الرمز المجهول أو المنتهي أو الملغى أو غير المسموح به (أو البحث الفاشل، المبلَّغ عنه كخطأ session) يعود إلى الإعداد العادي، ويتصرّف المقيّم تمامًا كالعميل، فيخدم مسار شيفرة واحد الحركة العادية والاختبارات. وإن انتهت الجلسة أثناء الطلب تعيد isActive() القيمة false وتستمر التقييمات على الإعداد المنشور.
  • تعيد headers() القيمة ['x-nanoflags-session' => token] للرمز السليم الصيغة، حتى إن لم تستطع هذه الخدمة حلّه، و[] فيما عدا ذلك: دمجها في طلب لاحق آمن دائمًا.
  • التخزين المؤقت. تُحفظ الجلسة النشطة حتى تنتهي، في العميل وفي الذاكرة المؤقتة المشتركة، تحت مفتاح خاص بها (تجزئة للخدمة والرمز: لا يُخزَّن الرمز نفسه أبدًا، ولا يُمسّ مُدخل الحزمة الذي تستخدمه بقية الطلبات أبدًا)، ومدة صلاحيتها هي وقت انتهاء الجلسة (ساعة واحدة على الأكثر، ثم يُسأل عنها من جديد). وتُتذكَّر الرموز المجهولة 15 ثانية وعمليات البحث الفاشلة 3 ثوانٍ في العميل وحده، فلا تستطيع قيم ترويسات عشوائية ملء الذاكرة المؤقتة المشتركة. ولا يحلّ offline: true شيئًا؛ ومع refresh: false تظل الجلسات تُجلب عند الطلب (فعملية المزامنة لا تعرف الرموز).
  • ينفّذ NanoFlags\SessionMiddleware الواجهة MiddlewareInterface من PSR-15، التي يثبّتها كل إطار PSR-15 أصلًا (psr/http-server-middleware). وهي ليست اعتمادية لهذه الحزمة، فلا تحمّل الصنف من دونها.
  • تغيّر الجلسة اللقطة والسياق اللذين يستخدمهما التقييم فقط. فهي لا تمنح أي وصول إلى البيانات ولا يجوز استخدامها للتفويض. ولا تتلقى مفاتيح العميل إلا الأعلام المكشوفة للعميل، في الجلسات أيضًا. وحزم الجلسات غير موقّعة، فلا ينطبق عليها التحقق. والجلسة الملغاة تظل تعمل حيث خُزّنت مؤقتًا حتى تنتهي.

التحقق من التوقيع

تُفحص كل حزمة، من الحافة ومن الذاكرة المؤقتة، (‏Ed25519 على السلسلة المعيارية، حسب معرّف المفتاح) قبل استخدامها. ومع الحافة المستضافة يكون ذلك مفعّلًا افتراضيًا بمفاتيح الإنتاج المضمّنة في الحزمة (Keys::OFFICIAL_SIGNING_KEYS)، وتُرفض الحزم غير الموقّعة. وتُجزَّأ البايتات الموقّعة الخام كما قُدّمت تمامًا.

php
// Self-hosted or proxied edge: pin your keys and require signatures
$flags = new Client($key,
    baseUrl: 'https://flags.internal.example',
    verify: ['publicKeys' => [['kty' => 'OKP', 'crv' => 'Ed25519', 'x' => '…', 'kid' => 'k1']], 'require' => true],
);
  • الحزمة التي لا تجتاز التحقق لا تُستخدم: تبقى المخزّنة، ويتلقى onError الرمز signature.
  • الحزمة التي تذكر معرّف مفتاح مجهولًا (تدوير المفاتيح) تحمّل GET /v1/keys مرة واحدة، وعلى الأكثر مرة في الدقيقة، وتُشارَك النتيجة عبر الذاكرة المؤقتة. ومع حافة مستضافة ذاتيًا يستخدم verify: true (أو 'fetchKeys' => true) المسار /v1/keys لتلك الحافة؛ ويعطّل verify: false التحقق.
  • بعد قبول حزمة لبيئة ما، تُرفض الحزم الموقّعة لبيئة أخرى. ومن دون ext-sodium أو paragonie/sodium_compat يرفض وضع التحقق كل الحزم، ويوضّح ذلك خطأ بالرمز config.
  • تُرفض الحزم المكتوبة لمحرك تقييم أحدث من Client::SUPPORTED_ENGINE_VERSION (بالرمز engine) ويبقى الإعداد المخزّن قيد الاستخدام: حدّث الحزمة. والسلسلة المعيارية موصوفة في التواقيع.

القياس والإخفاء

تُسجَّل عيّنة 10 % من التقييمات. وافتراضيًا لا تغادر قيم السياق العملية أبدًا: لا يُرسل إلا أسماء الخصائص التي تستخدمها قواعد العلم (وأنواع قيمها)، مثل {"plan": "string"}. وتُخزَّن الأحداث مؤقتًا في الذاكرة المؤقتة وتُرسل على الأكثر مرة كل flushInterval ‏(10 ثوانٍ) عند نهاية الطلب، مع بلاغ الخدمة مرة كل reportInterval ‏(60 ثانية) على الأقل.

php
$flags = new Client($key,
    events: [
        'sampleRate' => 0.05,
        'redact' => fn (array $ctx) => ['plan' => $ctx['plan'] ?? null],   // what leaves the process
    ],
);

$quiet = new Client($key, events: false);   // no telemetry at all

القياس بأفضل جهد: لا يُعاد إرساله أبدًا، وقد تُسقط الطلبات المتزامنة بعض الأحداث المخزّنة. ويرسل flush() الأحداث المنتظرة فورًا؛ وينبغي للعمّال طويلي التشغيل استدعاؤه بعد كل مهمة.

مزوّد OpenFeature

sh
composer require nanoflags/openfeature-provider
php
use NanoFlags\Client;
use NanoFlags\OpenFeature\NanoFlagsProvider;
use OpenFeature\OpenFeatureAPI;
use OpenFeature\implementation\flags\Attributes;
use OpenFeature\implementation\flags\EvaluationContext;

$api = OpenFeatureAPI::getInstance();
$api->setProvider(new NanoFlagsProvider(new Client(getenv('NANOFLAGS_SDK_KEY'), service: 'checkout-api')));

$client  = $api->getClient();
$enabled = $client->getBooleanValue('new-checkout', false, new EvaluationContext($userId, new Attributes(['plan' => 'beta'])));
$details = $client->getStringDetails('accent', 'blue', new EvaluationContext($userId));
  • لـ open-feature/sdk 2.x. اضبط Client تمامًا كما تفعل من دون OpenFeature (الذاكرة المؤقتة والتحقق والقياس وrefresh: false مع عملية المزامنة).
  • يصبح مفتاح الاستهداف هو key في NanoFlags (ويتقدّم على خاصية اسمها key). الأسباب: DISABLED وDEFAULT وTARGETING_MATCH وSPLIT (والمتغيّر هو معرّف القاعدة). والأخطاء: FLAG_NOT_FOUND (أو PROVIDER_NOT_READY ما دام لم يُحمَّل شيء) وTYPE_MISMATCH وGENERAL. وتحمل بيانات العلم الوصفية revision.
  • تتطلب دالة الأعداد الصحيحة عددًا صحيحًا؛ وتقبل دالة الأعداد العشرية أي رقم. وتعيد دالة الكائنات كائنات JSON ومصفوفاتها كمصفوفات PHP.
  • جلسات الاختبار: مرّر مقيّم الطلب وسيطًا ثانيًا، new NanoFlagsProvider($flags, fn () => $flags->sessionFromGlobals()) (أو المقيّم الذي وضعه NanoFlags\SessionMiddleware على الطلب). وخارج الجلسة يتصرّف تمامًا كالعميل.
  • لا أحداث للمزوّد في SDK ‏OpenFeature لـ PHP: الحالة والأخطاء متاحة على Client (status() وlastError() وonError()).

الواجهة البرمجية والخيارات

الوسيطالافتراضيالوصف
baseUrlhttps://edge.nanoflags.ioعنوان الحافة.
service'unknown'الاسم الذي تُبلّغ به هذه العملية.
cacheAPCu أو مجلد مؤقتكائن Store أو أي ذاكرة PSR-16 أو false. انظر اختيار الذاكرة المؤقتة.
cacheTtl · retryInterval30.0 · 5.0الثواني قبل إعادة التحقق من الحزمة المخزّنة، وبين المحاولات ما دامت الحافة تفشل.
refreshtruefalse: لا جلب أبدًا، قراءة الذاكرة المؤقتة فقط (مع عملية المزامنة).
offlinefalseبلا شبكة إطلاقًا: التهيئة المسبقة والذاكرة المؤقتة فقط، بلا قياس.
timeout3.0مهلة طلب الحزمة بالثواني.
bootstrapلا شيءحزمة (نص JSON أو مصفوفة محلَّلة) تُستخدم حين لا يتوفر ما هو أفضل.
verifyمفعّل للحافة المستضافةtrue أو false أو ['publicKeys' => …, 'require' => …, 'fetchKeys' => …].
eventsعيّنة 10 %false أو ['sampleRate', 'flushInterval', 'reportInterval', 'timeout', 'redact'].
http · requestFactory · streamFactorycurl أو التدفقاتعميل PSR-18 مع مصانع PSR-17.
logger · onErrorلا شيءمسجّل PSR-3، ومستمع أخطاء يُسجَّل قبل التحميل الأول.
الدالةالوصف
boolVariation · stringVariation · numberVariation · jsonVariationقيمة مُنمَّطة: ($key, $default, $context = null).
*VariationDetail · evaluateكائن EvaluationDetail.
allFlags · allFlagsDetailكل أعلام الإعداد (دون قياس).
session($token, $service = null) · sessionFromGlobals($service = null)SessionEvaluator لجلسة اختبار: القراءات المُنمَّطة وتفاصيلها، وevaluate وisActive() وid() وexpiresAt() وrevision() وheaders().
status() · revision() · source() · isReady() · bundleJson()الحالة: not-ready / ready / stale؛ والمصدر network أو cache أو bootstrap.
onError(callable) · lastError()إضافة مستمع أخطاء (تعيد دالة تزيله)؛ وآخر خطأ.
refresh() · flush() · run(…)إعادة التحقق فورًا (وتعيد هل الإعداد المستخدم محدّث)، وإرسال القياس فورًا، وحلقة المزامنة.

رموز الأخطاء

تصل الأخطاء إلى onError كـ NanoFlagsException له errorCode (وhttpStatus لـ unauthorized وhttp): network وunauthorized وhttp وinvalid_bundle وstore وconfig وsignature وengine وsession. ولا يغيّر تحديثٌ فاشل الإعدادَ المستخدم أبدًا، ولا يُرمى أي شيء من استدعاء قراءة.

حل المشكلات

  1. كل قراءة تعيد القيمة الافتراضية. افحص status() وlastError(). يعني unauthorized أن المفتاح رُفض؛ ومع مفتاح متصفح (nf_pub_…) لا تُسلَّم إلا الأعلام المكشوفة للعميل.
  2. كل طلب يجلب من الحافة. هذا ما يفعله cache: false. وإلا فالذاكرة المؤقتة لا تُقرأ أو لا تُكتب: ابحث عن أخطاء بالرمز store، وتأكد من أن المجلد (أو خادم PSR-16) قابل للكتابة من مستخدم PHP.
  3. عملية المزامنة تعمل لكن العمّال باقون على نسخة قديمة. يجب أن تستخدم عملية المزامنة والعمّال المفتاح والعنوان الأساسي والذاكرة المؤقتة نفسها. وذاكرة APCu لا تُشارَك بين عملية سطر أوامر وPHP-FPM.
  4. أخطاء بالرمز config تخص sodium. ثبّت ext-sodium أو paragonie/sodium_compat؛ فمن دون أحدهما تُرفض كل حزمة موقّعة.
  5. لا WebSocket حي. لا تستخدم حزمة PHP النقطة /v1/live: تعيد PHP على مستوى الطلب التحقق من الذاكرة المؤقتة المشتركة بدلًا من ذلك، وتستخدم عملية المزامنة تدفق الأحداث.
لغات أخرى
تتوفر حزم SDK أصلية للخوادم أيضًا لـ Python وGo وJava و.NET وRuby. ويمكن للغات الأخرى قراءة أعلام NanoFlags عبر مزوّد OpenFeature OFREP.