Aller au contenu

Installation

Afficher au format Markdown Modifier sur GitHub Documentation de e7056ba
Shell
composer require storh/storh

Prérequis

  • PHP 8.2 ou version ultérieure
  • ext-json
  • un système de fichiers local ou monté prenant en charge le renommage atomique au sein d’un répertoire (tout disque local standard convient)

storh n’a aucune dépendance d’exécution Composer. Deux extensions activent des fonctionnalités facultatives lorsqu’elles sont présentes : ext-pdo ou ext-mysqli pour les miroirs SQL, et ext-apcu pour le moteur Cache::apcu() partagé, qui ne met rien en cache si APCu n’est pas disponible.

Choisir une racine de stockage

Utilisez un répertoire dans lequel votre processus PHP peut créer, lire, écrire, renommer et supprimer des fichiers :

PHP
use Storh\StorageRoot;

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

StorageRoot normalise uniquement le chemin fourni et sécurise l’espace de noms en le convertissant en nom de répertoire sûr. Il n’inspecte pas l’application hôte, ne lit pas les constantes globales et n’exige aucun adaptateur de framework. À la première utilisation, les moteurs créent leurs répertoires de collection sous la racine.

Vérifier que tout fonctionne

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

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

Continuez avec le Démarrage rapide ou choisissez un moteur dans Choisir un moteur.