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

# Installation und Konfiguration - VOICEVOX für Laravel

> Beschreibt die Einführung von VOICEVOX für Laravel, die Installation je nach FFI-Verfügbarkeit, die Konfigurationsdatei, .env und die Vorbereitung der Engine-Ressourcen.

## Was zu installieren ist

VOICEVOX für Laravel benötigt je nach genutztem Modus zusätzliche Pakete und eine lokale Einrichtung.

<Tabs>
  <Tab title="Nur Client">
    Wenn Sie sich nur per HTTP mit der offiziellen VOICEVOX-Engine verbinden, reicht `revolution/laravel-voicevox` aus.

    ```shell theme={null}
    composer require revolution/laravel-voicevox
    ```
  </Tab>

  <Tab title="Auch Native / Engine-API">
    Bei Modi mit FFI installieren Sie zusätzlich `revolution/voicevox-core`.

    ```shell theme={null}
    composer require revolution/laravel-voicevox revolution/voicevox-core
    ```
  </Tab>
</Tabs>

## Anforderungen

| Punkt                    | Inhalt                                     |
| ------------------------ | ------------------------------------------ |
| PHP                      | 8.3+                                       |
| Laravel                  | 12+                                        |
| Erforderliche Extensions | `ext-zip`                                  |
| FFI `ext-ffi`            | Für Native-Modus / Engine-API erforderlich |

<Warning>
  In üblichen Webservern einschließlich Laravel Cloud ist FFI deaktiviert. Probieren Sie Native-Modus und Engine-API in einer **lokalen CLI-Umgebung** aus.
</Warning>

## Einrichtungsschritte

<Steps>
  <Step title="Paket installieren">
    Führen Sie die Installation je nach genutztem Modus über Composer durch. Für Native-Modus und Engine-API wird auch [VOICEVOX Core für PHP](/de/packages/voicevox-core-php) benötigt.
  </Step>

  <Step title="Konfigurationsdatei veröffentlichen">
    ```shell theme={null}
    php artisan vendor:publish --tag="voicevox-config"
    ```
  </Step>

  <Step title=".env konfigurieren">
    Für den reinen Client-Modus setzen Sie `VOICEVOX_URL`; bei Nutzung von FFI setzen Sie `VOICEVOX_CORE_PATH`.
  </Step>

  <Step title="Bei Bedarf Engine-Ressourcen installieren">
    Wenn Sie `/speaker_info` oder `/singer_info` nutzen, sind zusätzliche Ressourcen erforderlich.
  </Step>
</Steps>

## `config/voicevox.php`

Alle Konfigurationsoptionen finden Sie in der [Konfigurationsreferenz](/de/packages/laravel-voicevox/configuration).

```php theme={null}
return [
    'client' => [
        'url' => env('VOICEVOX_URL', 'http://127.0.0.1:50021'),
        'core_version' => env('VOICEVOX_CLIENT_CORE_VERSION'),
    ],

    'core' => [
        'path' => env('VOICEVOX_CORE_PATH'),
        'dict' => env('VOICEVOX_CORE_DICT_PATH', 'dict/open_jtalk_dic_utf_8-1.11'),
        'models' => env('VOICEVOX_CORE_MODELS_PATH', 'models/vvms'),
        'vvms' => ['0.vvm', '9.vvm', 's0.vvm'],
    ],

    'engine' => [
        'disabled' => env('VOICEVOX_ENGINE_DISABLED', false),
        'fallback_url' => env('VOICEVOX_ENGINE_FALLBACK_URL', 'http://127.0.0.1:50021'),
    ],
];
```

## Mindestanforderungen an `.env`

### Nur Client-Modus

Wenn Sie die offizielle Engine mit dem Standardwert `http://127.0.0.1:50021` starten, sind keine zusätzlichen Einstellungen erforderlich.

```dotenv theme={null}
VOICEVOX_URL=http://127.0.0.1:50021
```

### Native-Modus / Engine-API

```dotenv theme={null}
VOICEVOX_CORE_PATH=/path/to/voicevox_core/
```

<Info>
  Der Inhalt von `VOICEVOX_CORE_PATH` wird gemäß den Schritten in [VOICEVOX Core für PHP](/de/packages/voicevox-core-php) vorbereitet. Prüfen Sie auch dort die Platzierung von Library, OpenJTalk-Wörterbuch und Modelldateien.
</Info>

## FFI aktivieren

In CLI-Umgebungen ist es üblicherweise direkt nutzbar.

Wenn Sie die Laravel-Version der Engine-API lokal starten, aktivieren Sie FFI in `php.ini`.

```ini theme={null}
ffi.enable=true
```

Die Funktionsweise und Einschränkungen von FFI sind unter [PHP FFI](/de/advanced/ffi) zusammengefasst.

## Engine-Ressourcen installieren

Wenn Sie Ressourcen-Endpunkte wie `/speaker_info` oder `/singer_info` verwenden, installieren Sie separat Ressourcen-Dateien.

```shell theme={null}
php artisan voicevox:install
```

In der Orchestra-Testbench-Umgebung lautet der Befehl:

```shell theme={null}
vendor/bin/testbench voicevox:install
```

## Einstiegspunkte je Modus

<Columns cols={2}>
  <Card title="Client Talk" href="/de/packages/laravel-voicevox/client-talk" icon="message-circle">
    Starten Sie die offizielle VOICEVOX-Engine über Docker und führen Sie die Text-Sprachsynthese durch.
  </Card>

  <Card title="Client Song" href="/de/packages/laravel-voicevox/client-song" icon="music">
    Führen Sie mit `Score` und `Note` die Gesangssynthese durch.
  </Card>

  <Card title="Native Talk" href="/de/packages/laravel-voicevox/native-talk" icon="cpu">
    Rufen Sie VOICEVOX CORE direkt über FFI auf.
  </Card>

  <Card title="Native Song" href="/de/packages/laravel-voicevox/native-song" icon="music">
    Sehen Sie sich Einsatzmöglichkeiten des Gesangsmodells und von `sync()` an.
  </Card>
</Columns>

## Referenzlinks

* [VOICEVOX für Laravel – Übersicht](/de/packages/laravel-voicevox)
* [Erste Schritte](/de/packages/laravel-voicevox/getting-started)
* [Konfigurationsreferenz](/de/packages/laravel-voicevox/configuration)
* [VOICEVOX Core für PHP](/de/packages/voicevox-core-php)
* [Verwendung von VOICEVOX Core für PHP](/de/packages/voicevox-core-php/usage)
* [PHP FFI](/de/advanced/ffi)


## Related topics

- [Detailerklärung zu Score und Note - VOICEVOX für Laravel](/de/packages/laravel-voicevox/song-score-note.md)
- [Erste Schritte - VOICEVOX für Laravel](/de/packages/laravel-voicevox/getting-started.md)
- [Engine-API-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/engine-talk.md)
- [Native-Modus: Talk (Text-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/native-talk.md)
- [Native-Modus: Song (Gesangs-Sprachsynthese) - VOICEVOX für Laravel](/de/packages/laravel-voicevox/native-song.md)