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

# Installatie en configuratie - VOICEVOX for Laravel

> Uitleg over de installatie van VOICEVOX for Laravel, installatie met of zonder FFI, het configuratiebestand, .env en het voorbereiden van engine-resources.

## Wat installeer je

Welke extra pakketten en lokale setup je nodig hebt voor VOICEVOX for Laravel, hangt af van de modus die je wilt gebruiken.

<Tabs>
  <Tab title="Alleen client">
    Als je alleen via HTTP verbinding maakt met de officiële VOICEVOX-engine, kun je beginnen met enkel `revolution/laravel-voicevox`.

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

  <Tab title="Ook native / Engine API gebruiken">
    Voor modi die FFI gebruiken installeer je ook `revolution/voicevox-core`.

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

## Vereisten

| Onderdeel         | Inhoud                               |
| ----------------- | ------------------------------------ |
| PHP               | 8.3+                                 |
| Laravel           | 12+                                  |
| Vereiste extensie | `ext-zip`                            |
| FFI `ext-ffi`     | Nodig voor native modus / Engine API |

<Warning>
  Op gangbare webservers, waaronder Laravel Cloud, is FFI uitgeschakeld. Probeer de native modus en de Engine API in een **lokale CLI**.
</Warning>

## Installatiestappen

<Steps>
  <Step title="Installeer het pakket">
    Installeer via Composer, afhankelijk van de modus die je wilt gebruiken. Voor de native modus en de Engine API heb je ook [VOICEVOX Core for PHP](/nl/packages/voicevox-core-php) nodig.
  </Step>

  <Step title="Publiceer het configuratiebestand">
    ```shell theme={null}
    php artisan vendor:publish --tag="voicevox-config"
    ```
  </Step>

  <Step title="Stel .env in">
    Gebruik je alleen de clientmodus, stel dan `VOICEVOX_URL` in; gebruik je FFI, stel dan `VOICEVOX_CORE_PATH` in.
  </Step>

  <Step title="Installeer indien nodig engine-resources">
    Als je `/speaker_info` of `/singer_info` gebruikt, zijn extra resources nodig.
  </Step>
</Steps>

## `config/voicevox.php`

Alle configuratieopties vind je in de [configuratiereferentie](/nl/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'),
    ],
];
```

## Minimaal benodigde `.env`

### Alleen clientmodus

Als je de officiële engine start op de standaard `http://127.0.0.1:50021`, is geen extra configuratie nodig.

```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>
  De inhoud van `VOICEVOX_CORE_PATH` bereid je voor volgens de stappen van [VOICEVOX Core for PHP](/nl/packages/voicevox-core-php). Raadpleeg daar ook de plaatsing van de bibliotheek zelf, het OpenJTalk-woordenboek en de modelbestanden.
</Info>

## FFI inschakelen

In de CLI werkt het meestal direct.

Als je de Laravel-versie van de Engine API lokaal start, schakel je FFI in via `php.ini`.

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

Hoe FFI werkt en welke beperkingen er zijn, vind je in [PHP FFI](/nl/advanced/ffi).

## Engine-resources installeren

Als je resource-endpoints zoals `/speaker_info` of `/singer_info` gebruikt, installeer je apart de resourcebestanden.

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

In een Orchestra Testbench-omgeving gebruik je dit commando:

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

## Ingang per modus

<Columns cols={2}>
  <Card title="Client Talk" href="/nl/packages/laravel-voicevox/client-talk" icon="message-circle">
    Start de officiële VOICEVOX-engine met Docker en synthetiseer tekst naar spraak.
  </Card>

  <Card title="Client Song" href="/nl/packages/laravel-voicevox/client-song" icon="music">
    Synthetiseer zang met `Score` en `Note`.
  </Card>

  <Card title="Native Talk" href="/nl/packages/laravel-voicevox/native-talk" icon="cpu">
    Roep VOICEVOX CORE rechtstreeks aan via FFI.
  </Card>

  <Card title="Native Song" href="/nl/packages/laravel-voicevox/native-song" icon="music">
    Bekijk zangmodellen en wanneer je `sync()` gebruikt.
  </Card>
</Columns>

## Referentielinks

* [Overzicht van VOICEVOX for Laravel](/nl/packages/laravel-voicevox)
* [Aan de slag](/nl/packages/laravel-voicevox/getting-started)
* [Configuratiereferentie](/nl/packages/laravel-voicevox/configuration)
* [VOICEVOX Core for PHP](/nl/packages/voicevox-core-php)
* [VOICEVOX Core for PHP gebruiken](/nl/packages/voicevox-core-php/usage)
* [PHP FFI](/nl/advanced/ffi)


## Related topics

- [Laravel Cashier (Stripe)](/nl/cashier.md)
- [Configuratie](/nl/configuration.md)
- [Aan de slag - VOICEVOX for Laravel](/nl/packages/laravel-voicevox/getting-started.md)
- [Engine-API-modus: talk (tekst-naar-spraak) - VOICEVOX for Laravel](/nl/packages/laravel-voicevox/engine-talk.md)
- [Native modus: talk (tekst-naar-spraak) - VOICEVOX for Laravel](/nl/packages/laravel-voicevox/native-talk.md)