حِزم SDK
SDK PHP
nanoflags/nanoflags لطريقة عمل PHP: طلب واحد في كل مرة، ولا شيء يبقى بين الطلبات. تُقيَّم الأعلام محليًا على إعداد موقّع تتشاركه الطلبات عبر ذاكرة مؤقتة، ويُعاد التحقق منه بطلب شرطي زهيد الكلفة. ولا يرمي استدعاء القراءة استثناءً أبدًا.في هذه الصفحة
التثبيت
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) إلى المُنشئ، ليُبلَّغ عن أخطاء التحميل الأول أيضًا.
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 هو الهوية الثابتة المستخدمة في الطرح بالنسب المئوية.
$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 | القيمة المقدَّمة (قيمتك الافتراضية في حالات الاحتياط). |
reason | rule_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() بعد كل مهمة أو طلب لإرسال القياس. |
يحمل مُدخل الذاكرة المؤقتة البايتات الموقّعة كما هي، ويُتحقَّق من التوقيع مجددًا عند كل قراءة (فالذاكرة المؤقتة خارج حدود الثقة)، مع حفظ النتيجة المحلَّلة لكل عملية. ولا يعود العميل أبدًا إلى نسخة أقدم من التي لديه، حتى حين تقدّم الحافة نفسها آخر نسخة سليمة تعرفها.
اختيار الذاكرة المؤقتة
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) مع استطلاع احتياطي، ولا يفعل عمّال الويب سوى القراءة من الذاكرة المؤقتة.
// 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'));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// 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
$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() في دالة تعمل عند انتهاء الطلب.
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.
// 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)، وتُرفض الحزم غير الموقّعة. وتُجزَّأ البايتات الموقّعة الخام كما قُدّمت تمامًا.
// 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 ثانية) على الأقل.
$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
composer require nanoflags/openfeature-provideruse 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/sdk2.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()).
الواجهة البرمجية والخيارات
| الوسيط | الافتراضي | الوصف |
|---|---|---|
baseUrl | https://edge.nanoflags.io | عنوان الحافة. |
service | 'unknown' | الاسم الذي تُبلّغ به هذه العملية. |
cache | APCu أو مجلد مؤقت | كائن Store أو أي ذاكرة PSR-16 أو false. انظر اختيار الذاكرة المؤقتة. |
cacheTtl · retryInterval | 30.0 · 5.0 | الثواني قبل إعادة التحقق من الحزمة المخزّنة، وبين المحاولات ما دامت الحافة تفشل. |
refresh | true | false: لا جلب أبدًا، قراءة الذاكرة المؤقتة فقط (مع عملية المزامنة). |
offline | false | بلا شبكة إطلاقًا: التهيئة المسبقة والذاكرة المؤقتة فقط، بلا قياس. |
timeout | 3.0 | مهلة طلب الحزمة بالثواني. |
bootstrap | لا شيء | حزمة (نص JSON أو مصفوفة محلَّلة) تُستخدم حين لا يتوفر ما هو أفضل. |
verify | مفعّل للحافة المستضافة | true أو false أو ['publicKeys' => …, 'require' => …, 'fetchKeys' => …]. |
events | عيّنة 10 % | false أو ['sampleRate', 'flushInterval', 'reportInterval', 'timeout', 'redact']. |
http · requestFactory · streamFactory | curl أو التدفقات | عميل 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. ولا يغيّر تحديثٌ فاشل الإعدادَ المستخدم أبدًا، ولا يُرمى أي شيء من استدعاء قراءة.
حل المشكلات
- كل قراءة تعيد القيمة الافتراضية. افحص
status()وlastError(). يعنيunauthorizedأن المفتاح رُفض؛ ومع مفتاح متصفح (nf_pub_…) لا تُسلَّم إلا الأعلام المكشوفة للعميل. - كل طلب يجلب من الحافة. هذا ما يفعله
cache: false. وإلا فالذاكرة المؤقتة لا تُقرأ أو لا تُكتب: ابحث عن أخطاء بالرمزstore، وتأكد من أن المجلد (أو خادم PSR-16) قابل للكتابة من مستخدم PHP. - عملية المزامنة تعمل لكن العمّال باقون على نسخة قديمة. يجب أن تستخدم عملية المزامنة والعمّال المفتاح والعنوان الأساسي والذاكرة المؤقتة نفسها. وذاكرة APCu لا تُشارَك بين عملية سطر أوامر وPHP-FPM.
- أخطاء بالرمز
configتخص sodium. ثبّت ext-sodium أوparagonie/sodium_compat؛ فمن دون أحدهما تُرفض كل حزمة موقّعة. - لا WebSocket حي. لا تستخدم حزمة PHP النقطة
/v1/live: تعيد PHP على مستوى الطلب التحقق من الذاكرة المؤقتة المشتركة بدلًا من ذلك، وتستخدم عملية المزامنة تدفق الأحداث.