# Telepítés

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

## Követelmények

- PHP 8.2-es vagy újabb verzió
- `ext-json`
- helyi vagy csatolt fájlrendszer, amely támogatja a könyvtáron belüli atomi átnevezést (bármely szokásos helyi lemez megfelel)

A storh nem igényel futásidejű Composer függőségeket. Két bővítmény opcionális funkciókat tesz elérhetővé: a `ext-pdo` vagy az `ext-mysqli` a [SQL tükrökhöz](https://storh.inline0.dev/hu/docs/sql-mirror), a `ext-apcu` pedig a megosztott `Cache::apcu()` háttérrendszerhez szükséges; APCu hiányában ez semmit sem gyorsítótáraz.

## Tárolási gyökér kiválasztása

Olyan könyvtárat használjon, amelyet a PHP folyamat létrehozhat, olvashat, írhat, amelyen belül átnevezhet, és amelyből törölhet:

```php
use Storh\StorageRoot;

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

A `StorageRoot` csak normalizálja a megadott útvonalat, és biztonságos könyvtárnévvé alakítja a névteret. Nem vizsgálja a gazdaalkalmazást, nem olvas globális konstansokat, és nem igényel keretrendszeradaptert. A motorok első használatkor a gyökér alatt hozzák létre a gyűjteménykönyvtáraikat.

## Ellenőrizze a működést

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

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

Folytassa a [Gyors kezdés](https://storh.inline0.dev/hu/docs/quick-start) résszel, vagy válasszon motort a [Motor kiválasztása](https://storh.inline0.dev/hu/docs/engines#choosing-an-engine) oldalon.