Pular para o conteúdo

Instalação

Shell
composer require storh/storh

Requisitos

  • PHP 8.2 ou posterior
  • ext-json
  • um sistema de arquivos local ou montado com semântica de renomeação atômica dentro de um diretório (qualquer disco local comum serve)

storh não tem dependências de runtime Composer. Duas extensões desbloqueiam recursos opcionais quando disponíveis: ext-pdo ou ext-mysqli para espelhos SQL e ext-apcu para o backend Cache::apcu() compartilhado, que não armazena nada em cache quando o APCu não está disponível.

Escolha uma raiz de armazenamento

Use um diretório que o processo PHP possa criar, ler, gravar, renomear arquivos dentro e excluir arquivos de:

PHP
use Storh\StorageRoot;

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

StorageRoot apenas normaliza o caminho fornecido e higieniza o namespace para convertê-lo em um nome de diretório seguro. Não inspeciona o aplicativo host, não lê constantes globais nem exige um adaptador de framework. Os mecanismos criam seus diretórios de coleção sob a raiz na primeira utilização.

Verifique se funciona

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

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

Continue com o Início rápido ou escolha um mecanismo em Como escolher um mecanismo.