خادم مخصص
إذا لم يكن GitHub مناسبًا لاحتياجاتك، فيمكنك استضافة سجل على أي خادم HTTP. والشرط الوحيد هو أن يكون registry.json وملفات الكتل متاحة عبر عناوين URL الخاصة بها.
خادم ملفات ثابتة
الخيار الأبسط. ضع مجلدي registry.json وblocks/ على أي خدمة استضافة ثابتة:
- Nginx/Apache: قدّم الدليل مباشرةً
- Vercel/Netlify: انشر الدليل كموقع ثابت
- S3/R2/GCS: ارفع الملفات إلى حاوية ذات وصول عام
- CDN: ضع الملفات خلف Cloudflare أو Fastly أو أي CDN
لا يحتاج CLI إلا إلى وصول GET للملفات. لا حاجة إلى API أو مسارات ديناميكية أو منطق من جهة الخادم.
خادم ديناميكي
إذا أردت إنشاء registry.json ديناميكيًا (e.g. من قاعدة بيانات، أو لإضافة التحكم في الوصول)، يمكنك بناء API بسيط:
GET /registry.json -> returns the registry manifest
GET /blocks/{name}/{file} -> returns the block file content
يمكن أن يحتوي {file} على خطوط مائلة عندما تسرد الكتلة ملفات في مجلدات فرعية (src/script.js)، لذا يجب أن يتطابق مسار الملف مع المسارات المتداخلة.
لا يهم CLI كيفية تنفيذ نقاط النهاية هذه. فهو يرسل طلبات GET عادية، ويتوقع أن يحتوي متن الاستجابة على محتوى الملف.
مثال: Express
const express = require('express');
const path = require('path');
const app = express();
app.get('/registry.json', (req, res) => {
res.sendFile(path.join(__dirname, 'registry.json'));
});
app.use('/blocks', express.static(path.join(__dirname, 'blocks')));
app.listen(3000);
مثال: PHP
<?php
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
if ($path === '/registry.json') {
header('Content-Type: application/json');
readfile(__DIR__ . '/registry.json');
exit;
}
if (preg_match('#^/blocks/([^/]+)/(.+)$#', $path, $matches)) {
$file = __DIR__ . '/blocks/' . $matches[1] . '/' . $matches[2];
if (file_exists($file)) {
readfile($file);
exit;
}
}
http_response_code(404);
CORS
إذا كان CLI يعمل في بيئة تكون فيها CORS مهمة (وهذا غير مرجح مع Node.js CLI، لكنه ممكن مع أدوات ويب مستقبلية)، فتأكد من أن خادمك يرسل ترويسات Access-Control-Allow-Origin المناسبة.
التخزين المؤقت
يخزّن CLI ملفات registry.json التي جلبها مؤقتًا في الذاكرة أثناء تشغيل الأمر الواحد. ولا يحتفظ بذاكرة التخزين المؤقت بين مرات التشغيل. لتحسين الأداء مع السجلات الكبيرة، أضف ترويسات التخزين المؤقت القياسية HTTP (Cache-Control، ETag) إلى استجابات خادمك.
سجلات داخلية أو مؤسسية
للفِرق التي تريد مشاركة الكتل داخليًا:
- استضف السجل على خادم داخلي أو على URL يمكن الوصول إليه عبر VPN
- يضيف كل مطور سجل URL إلى
blocks.jsonالخاص بمشروعه - يجلب CLI من URL كما يفعل مع أي سجل آخر
لا يلزم إعداد خاص. ما دام URL متاحًا من جهاز المطور، فسيعمل.