# Diegimas

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

## Reikalavimai

- PHP 8.2 arba naujesnė versija
- `ext-json`
- vietinė arba prijungta failų sistema, palaikanti atominį pervadinimą kataloge (tinka bet kuris įprastas vietinis diskas)

storh neturi jokių Composer vykdymo aplinkos priklausomybių. Dvi plėtiniai suteikia papildomų funkcijų, jei yra įdiegti: `ext-pdo` arba `ext-mysqli`, skirti [SQL veidrodžiams](https://storh.inline0.dev/lt/docs/sql-mirror), ir `ext-apcu` bendrajai `Cache::apcu()` sąsajai, kuri nieko nesaugo podėlyje, jei APCu nepasiekiamas.

## Pasirinkite saugyklos šakninį katalogą

Naudokite katalogą, kurį jūsų PHP procesas gali sukurti, skaityti, į kurį gali rašyti, jame pervadinti ir iš kurio gali ištrinti:

```php
use Storh\StorageRoot;

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

`StorageRoot` tik normalizuoja pateiktą kelią ir išvalo vardų sritį, kad gautų saugų katalogo pavadinimą. Jis netikrina pagrindinės programos, neskaito visuotinių konstantų ir nereikalauja karkaso adapterio. Pirmą kartą naudojant varikliai šakniniame kataloge sukuria savo kolekcijų katalogus.

## Patikrinkite, ar veikia

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

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

Tęskite skaitydami [Trumpąjį vadovą](https://storh.inline0.dev/lt/docs/quick-start) arba pasirinkite variklį skyriuje [Variklio pasirinkimas](https://storh.inline0.dev/lt/docs/engines#choosing-an-engine).