# Kurulum

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

## Gereksinimler

- PHP 8.2 veya üzeri
- `ext-json`
- Bir dizin içinde atomik yeniden adlandırma anlamlarını destekleyen yerel veya bağlanmış bir dosya sistemi (herhangi bir standart yerel disk uygundur)

storh hiçbir Composer çalışma zamanı bağımlılığı gerektirmez. İki eklenti mevcut olduğunda isteğe bağlı özellikleri etkinleştirir: `ext-pdo` veya `ext-mysqli`, [SQL yansımaları](https://storh.inline0.dev/tr/docs/sql-mirror) için; `ext-apcu` ise ortak `Cache::apcu()` arka ucu içindir. APCu kullanılamadığında bu arka uç hiçbir şeyi önbelleğe almaz.

## Depolama kökü seçin

PHP sürecinizin oluşturabileceği, okuyup yazabileceği, içinde yeniden adlandırma yapabileceği ve silebileceği bir dizin kullanın:

```php
use Storh\StorageRoot;

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

`StorageRoot` yalnızca sağlanan yolu standartlaştırır ve ad alanını güvenli bir dizin adına dönüştürür. Ana uygulamayı incelemez, global sabitleri okumaz ve bir çerçeve adaptörü gerektirmez. Motorlar ilk kullanıldıklarında koleksiyon dizinlerini kök altında oluşturur.

## Çalıştığını doğrulayın

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

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

[Hızlı Başlangıç](https://storh.inline0.dev/tr/docs/quick-start) ile devam edin veya [Bir motor seçin](https://storh.inline0.dev/tr/docs/engines#choosing-an-engine) sayfasından bir motor seçin.