التثبيت

composer require storh/storh

المتطلبات

• PHP 8.2 أو أحدث
• ext-json
• نظام ملفات محلي أو مركّب يدعم دلالات إعادة التسمية الذرية داخل دليل (أي قرص محلي عادي مناسب)

لا يتطلب storh أي اعتماديات وقت التشغيل من Composer. وتتيح امتدادان ميزات اختيارية عند توفرهما: ext-pdo أو ext-mysqli لنسخ SQL المتطابقة، وext-apcu للواجهة الخلفية المشتركة Cache::apcu()، التي لا تخزّن شيئًا مؤقتًا عند عدم توفر APCu.

اختيار جذر التخزين

استخدم دليلًا يمكن لعملية PHP إنشاؤه وقراءته والكتابة فيه وإعادة التسمية ضمنه والحذف منه:

use Storh\StorageRoot;

$root = StorageRoot::resolve(__DIR__ . '/var/storage', 'app');

لا يفعل StorageRoot سوى توحيد المسار المقدم وتنقية مساحة الأسماء إلى اسم دليل آمن. ولا يفحص التطبيق المضيف أو يقرأ الثوابت العامة أو يتطلب محولًا لإطار عمل. تنشئ المحركات أدلة المجموعات ضمن الجذر عند أول استخدام.

التحقق من عمله

$docs = new Storh\DocStore($root, 'smoke');
$record = $docs->put(['ok' => true]);

var_dump($docs->get($record->id())?->data()); // ['ok' => true]

تابع إلى البدء السريع أو اختر محركًا من اختيار محرك.