# 설치

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

## 요구 사항

- PHP 8.2 이상
- `ext-json`
- 디렉터리 안에서 원자적 이름 변경을 지원하는 로컬 또는 마운트된 파일 시스템(일반적인 로컬 디스크면 충분합니다)

storh에는 Composer 런타임 종속성이 없습니다. 두 확장 기능이 있으면 선택 기능을 사용할 수 있습니다. `ext-pdo` 또는 `ext-mysqli`는 [SQL 미러](https://storh.inline0.dev/ko/docs/sql-mirror)를 지원하며, `ext-apcu`은 공유 `Cache::apcu()` 백엔드에 사용됩니다. APCu를 사용할 수 없으면 캐시를 저장하지 않습니다.

## 저장소 루트 선택

PHP 프로세스가 생성하고 읽고 쓸 수 있으며, 내부에서 이름을 변경하고 파일을 삭제할 수 있는 디렉터리를 사용하세요:

```php
use Storh\StorageRoot;

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

`StorageRoot`은 제공된 경로를 정규화하고 네임스페이스를 안전한 디렉터리 이름으로 정리할 뿐입니다. 호스트 애플리케이션을 검사하거나 전역 상수를 읽지 않으며 프레임워크 어댑터도 필요하지 않습니다. 엔진은 처음 사용할 때 루트 아래에 컬렉션 디렉터리를 만듭니다.

## 작동 확인

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

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

[빠른 시작](https://storh.inline0.dev/ko/docs/quick-start)을 계속 진행하거나 [엔진 선택하기](https://storh.inline0.dev/ko/docs/engines#choosing-an-engine)에서 엔진을 선택하세요.