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

# Installazione e configurazione - VOICEVOX for Laravel

> Come installare VOICEVOX for Laravel, procedura in presenza o assenza di FFI, file di configurazione, .env e preparazione delle risorse dell'engine.

## Cosa installare

Con VOICEVOX for Laravel, i pacchetti aggiuntivi e la configurazione locale cambiano a seconda della modalità che vuoi usare.

<Tabs>
  <Tab title="Solo client">
    Se devi solo collegarti via HTTP al VOICEVOX Engine ufficiale, puoi iniziare con il solo `revolution/laravel-voicevox`.

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

  <Tab title="Con modalità nativa / API Engine">
    Per le modalità che usano FFI, installa anche `revolution/voicevox-core`.

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

## Requisiti

| Voce                    | Contenuto                                   |
| ----------------------- | ------------------------------------------- |
| PHP                     | 8.3+                                        |
| Laravel                 | 12+                                         |
| Estensione obbligatoria | `ext-zip`                                   |
| FFI `ext-ffi`           | Necessario per modalità nativa / API Engine |

<Warning>
  Nei server Web comuni, incluso Laravel Cloud, FFI è disabilitato. Prova la modalità nativa e l'API Engine in **ambiente CLI locale**.
</Warning>

## Procedura di installazione

<Steps>
  <Step title="Installare il pacchetto">
    Installa tramite Composer in base alla modalità che vuoi usare. Per la modalità nativa e l'API Engine è necessario anche [VOICEVOX Core for PHP](/it/packages/voicevox-core-php).
  </Step>

  <Step title="Pubblicare il file di configurazione">
    ```shell theme={null}
    php artisan vendor:publish --tag="voicevox-config"
    ```
  </Step>

  <Step title="Configurare .env">
    Per la sola modalità client imposta `VOICEVOX_URL`; se usi FFI imposta `VOICEVOX_CORE_PATH`.
  </Step>

  <Step title="Installare le risorse dell'engine se necessario">
    Se usi `/speaker_info` o `/singer_info` occorrono risorse aggiuntive.
  </Step>
</Steps>

## `config/voicevox.php`

Trovi tutte le voci di configurazione in [Riferimento configurazione](/it/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'),
    ],
];
```

## `.env` minimo necessario

### Solo modalità client

Se avvii l'engine ufficiale al valore predefinito `http://127.0.0.1:50021`, non serve alcuna configurazione aggiuntiva.

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

### Modalità nativa / API Engine

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

<Info>
  Il contenuto di `VOICEVOX_CORE_PATH` si prepara con la procedura di [VOICEVOX Core for PHP](/it/packages/voicevox-core-php). Consulta quella pagina anche per la collocazione della libreria stessa, del dizionario OpenJTalk e dei file dei modelli.
</Info>

## Abilitare FFI

In CLI di norma funziona così com'è.

Se avvii localmente l'API Engine in versione Laravel, abilita FFI nel `php.ini`.

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

Il funzionamento e i vincoli di FFI sono raccolti in [PHP FFI](/it/advanced/ffi).

## Installare le risorse dell'engine

Se usi endpoint delle risorse come `/speaker_info` o `/singer_info`, installa a parte i file delle risorse.

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

Negli ambienti Orchestra Testbench il comando è il seguente.

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

## Punti di ingresso per ogni modalità

<Columns cols={2}>
  <Card title="Client Talk" href="/it/packages/laravel-voicevox/client-talk" icon="message-circle">
    Avvia il VOICEVOX Engine ufficiale con Docker e fai sintesi vocale da testo.
  </Card>

  <Card title="Client Song" href="/it/packages/laravel-voicevox/client-song" icon="music">
    Fai sintesi canora usando `Score` e `Note`.
  </Card>

  <Card title="Native Talk" href="/it/packages/laravel-voicevox/native-talk" icon="cpu">
    Chiama direttamente VOICEVOX CORE tramite FFI.
  </Card>

  <Card title="Native Song" href="/it/packages/laravel-voicevox/native-song" icon="music">
    Consulta l'uso dei modelli di canto e di `sync()`.
  </Card>
</Columns>

## Link di riferimento

* [Panoramica VOICEVOX for Laravel](/it/packages/laravel-voicevox)
* [Introduzione](/it/packages/laravel-voicevox/getting-started)
* [Riferimento configurazione](/it/packages/laravel-voicevox/configuration)
* [VOICEVOX Core for PHP](/it/packages/voicevox-core-php)
* [Utilizzo di VOICEVOX Core for PHP](/it/packages/voicevox-core-php/usage)
* [PHP FFI](/it/advanced/ffi)


## Related topics

- [Riferimento della configurazione - VOICEVOX for Laravel](/it/packages/laravel-voicevox/configuration.md)
- [Installazione](/it/installation.md)
- [Configurazione](/it/configuration.md)
- [Introduzione - VOICEVOX for Laravel](/it/packages/laravel-voicevox/getting-started.md)
- [VOICEVOX for Laravel](/it/packages/laravel-voicevox/index.md)