# Instalare

```bash
composer require storh/storh
```

## Cerințe

- PHP 8.2 sau o versiune ulterioară
- `ext-json`
- un sistem de fișiere local sau montat, cu semantică de redenumire atomică în interiorul unui director (orice disc local obișnuit este potrivit)

storh nu are dependențe Composer la execuție. Două extensii activează funcții opționale când sunt disponibile: `ext-pdo` sau `ext-mysqli` pentru oglinzi [SQL](https://storh.inline0.dev/ro/docs/sql-mirror), și `ext-apcu` pentru backend-ul partajat `Cache::apcu()`, care nu stochează nimic în cache când APCu nu este disponibil.

## Alegeți o rădăcină de stocare

Folosiți un director în care procesul PHP poate crea, citi, scrie, redenumi și
șterge fișiere:

```php
use Storh\StorageRoot;

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

`StorageRoot` doar normalizează calea furnizată și igienizează spațiul de nume
într-un nume de director sigur. Nu inspectează aplicația gazdă, nu citește
constante globale și nu necesită un adaptor pentru framework. Motoarele creează directoarele colecției sub rădăcină la prima utilizare.

## Verificați funcționarea

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

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

Continuați cu [Pornire rapidă](https://storh.inline0.dev/ro/docs/quick-start) sau alegeți un motor în
[Alegerea unui motor](https://storh.inline0.dev/ro/docs/engines#choosing-an-engine).