> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# VOICEVOX Core für PHP

> Reines PHP-Paket, das die C-Dynamic-Library von VOICEVOX CORE mittels PHP-FFI wrappt. Text-Sprachsynthese (TTS) direkt aus PHP nutzen.

## Übersicht

[revolution/voicevox-core](https://github.com/invokable/voicevox-core-php) ist ein reines PHP-Paket, das die C-Dynamic-Library von [VOICEVOX CORE](https://github.com/VOICEVOX/voicevox_core) mit PHP-FFI wrappt.

VOICEVOX ist eine hochwertige japanische Text-Sprachsynthese-Engine (TTS). Mit diesem Paket können Sie die Sprachsynthese direkt aus PHP durchführen.

<Info>
  Wenn Sie zunächst die Funktionsweise und Einschränkungen von PHP-FFI selbst kennenlernen möchten, siehe [PHP FFI](/de/advanced/ffi).
</Info>

<Tip>
  Wenn Sie es in einer Laravel-Anwendung verwenden möchten, lesen Sie zusätzlich [VOICEVOX für Laravel](/de/packages/laravel-voicevox), um auch die Unterschiede zwischen Client-Modus und Native-Modus zu klären.
</Tip>

<Warning>
  PHP-FFI ist in Webserver-Umgebungen (wie FPM) häufig deaktiviert (`ffi.enable=false`), daher ist dieses Paket **auf die Nutzung in lokalen CLI-Umgebungen ausgelegt**.
</Warning>

## Anforderungen

* PHP 8.3+
* Aktivierte `ext-ffi`-Extension
* VOICEVOX CORE 0.16+

## Installation

```bash theme={null}
composer require revolution/voicevox-core
```

## Einrichtung der Bibliothek

Um dieses Paket zu verwenden, benötigen Sie die dynamische Bibliothek von VOICEVOX CORE (`.so` / `.dylib`), die ONNX-Runtime-Bibliothek und das OpenJTalk-Wörterbuch.

<Steps>
  <Step title="voicevox_core herunterladen">
    Laden Sie über [voicevox\_core releases](https://github.com/VOICEVOX/voicevox_core/releases) den zu Ihrem OS und Ihrer Architektur passenden Downloader herunter und führen Sie ihn aus. Nach der Ausführung wird im aktuellen Verzeichnis ein Verzeichnis `voicevox_core` erstellt.

    Erzeugte Verzeichnisstruktur:

    ```
    voicevox_core/
    ├── dict/open_jtalk_dic_*/     # OpenJTalk-Wörterbuch
    ├── c_api/lib/                 # Dynamische Bibliotheken (.so, .dylib)
    ├── models/vvms/               # Audiomodell-Dateien (.vvm)
    └── onnxruntime/               # ONNX-Runtime-Bibliothek
    ```
  </Step>

  <Step title="An einen dauerhaften Ort verschieben">
    ```bash theme={null}
    mv voicevox_core ~/.local/voicevox_core
    ```
  </Step>

  <Step title="Symbolischen Link erstellen (empfohlen)">
    Erstellen Sie einen symbolischen Link, damit die Bibliothek automatisch gefunden wird.

    <Warning>
      Verwenden Sie bei `ln -s` unbedingt **absolute Pfade**.
    </Warning>

    **macOS:**

    ```bash theme={null}
    # Ersetzen Sie [VOICEVOX_CORE_DIR] durch den absoluten Pfad zu voicevox_core
    ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.dylib /usr/local/lib/libvoicevox_core.dylib
    ```

    Wenn das Laden aus `/usr/local/lib/` nicht funktioniert, setzen Sie in `.zshrc` o. Ä. `DYLD_FALLBACK_LIBRARY_PATH`:

    ```bash theme={null}
    export DYLD_FALLBACK_LIBRARY_PATH="$HOME/lib:/usr/local/lib:/usr/lib"
    ```

    **Linux:**

    ```bash theme={null}
    ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.so /usr/local/lib/libvoicevox_core.so
    ```
  </Step>
</Steps>

### Alternative: Angabe über Umgebungsvariable

Wenn Sie keinen symbolischen Link erstellen können, setzen Sie den vollständigen Pfad zur Bibliotheksdatei in der Umgebungsvariablen `VOICEVOX_CORE_LIB_PATH`:

```bash theme={null}
export VOICEVOX_CORE_LIB_PATH=/path/to/libvoicevox_core.dylib
```

```bash theme={null}
export VOICEVOX_CORE_LIB_PATH="$HOME/.local/voicevox_core/c_api/lib/libvoicevox_core.dylib"
```

<Info>
  Wenn Sie unter macOS auch mit `DYLD_FALLBACK_LIBRARY_PATH` nicht laden können, konfigurieren Sie es über `VOICEVOX_CORE_LIB_PATH`.
</Info>

## Dokumentation

<Columns cols={2}>
  <Card title="Verwendung" href="/de/packages/voicevox-core-php/usage" icon="play">
    Grundlegende Verwendung und Codebeispiele zu Text-Sprachsynthese und Audio-Erzeugung.
  </Card>

  <Card title="API-Referenz" href="/de/packages/voicevox-core-php/api" icon="code">
    Detaillierte Referenz aller Klassen, Methoden und Enums.
  </Card>
</Columns>

## Referenzlinks

* GitHub: [invokable/voicevox-core-php](https://github.com/invokable/voicevox-core-php)
* VOICEVOX CORE: [VOICEVOX/voicevox\_core](https://github.com/VOICEVOX/voicevox_core)


## Related topics

- [Verwendung - VOICEVOX Core für PHP](/de/packages/voicevox-core-php/usage.md)
- [API-Referenz - VOICEVOX Core für PHP](/de/packages/voicevox-core-php/api.md)
- [VOICEVOX für Laravel](/de/packages/laravel-voicevox/index.md)
- [Installation und Konfiguration - VOICEVOX für Laravel](/de/packages/laravel-voicevox/installation.md)
- [Native-Modus: Song (Gesangs-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/native-song.md)