# Instalēšana

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

## Prasības

- PHP 8.2 vai jaunāka versija
- `ext-json`
- lokāla vai piemontēta failu sistēma ar atomiskas pārdēvēšanas semantiku direktorijā (der jebkurš parasts lokālais disks)

storh nav izpildlaika atkarību no Composer. Divi paplašinājumi, ja tie ir pieejami, nodrošina papildu funkcijas: `ext-pdo` vai `ext-mysqli` [SQLspoguļiem](https://storh.inline0.dev/lv/docs/sql-mirror) un `ext-apcu` koplietojamai `Cache::apcu()` aizmugursistēmai, kas neko nesaglabā kešatmiņā, ja APCu nav pieejams.

## Izvēlieties krātuves sakni

Izmantojiet direktoriju, kuru jūsu PHP process var izveidot, nolasīt, rakstīt, tajā pārdēvēt un dzēst failus:

```php
use Storh\StorageRoot;

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

`StorageRoot` tikai normalizē norādīto ceļu un attīra nosaukumvietu, lai izveidotu drošu direktorijas nosaukumu. Tas nepārbauda resursdatora lietotni, nelasa globālas konstantes un neprasa ietvara adapteri. Dzinēji pirmajā lietošanas reizē izveido kolekciju direktorijas saknes direktorijā.

## Pārbaudiet, vai viss darbojas

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

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

Turpiniet ar [Ātro sākumu](https://storh.inline0.dev/lv/docs/quick-start) vai izvēlieties dzinēju sadaļā [Dzinēja izvēle](https://storh.inline0.dev/lv/docs/engines#choosing-an-engine).