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.

Solo client

Se devi solo collegarti via HTTP al VOICEVOX Engine ufficiale, puoi iniziare con il solo revolution/laravel-voicevox.

composer require revolution/laravel-voicevox

Con modalità nativa / API Engine

Per le modalità che usano FFI, installa anche revolution/voicevox-core.

composer require revolution/laravel-voicevox revolution/voicevox-core

​

Requisiti

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

Nei server Web comuni, incluso Laravel Cloud, FFI è disabilitato. Prova la modalità nativa e l’API Engine in ambiente CLI locale.

​

Procedura di installazione

1. 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.

2. Pubblicare il file di configurazione

   php artisan vendor:publish --tag="voicevox-config"
   
3. Configurare .env

   Per la sola modalità client imposta VOICEVOX_URL; se usi FFI imposta VOICEVOX_CORE_PATH.

4. Installare le risorse dell'engine se necessario

   Se usi /speaker_info o /singer_info occorrono risorse aggiuntive.

​

config/voicevox.php

Trovi tutte le voci di configurazione in Riferimento configurazione.

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.

VOICEVOX_URL=http://127.0.0.1:50021

​

Modalità nativa / API Engine

VOICEVOX_CORE_PATH=/path/to/voicevox_core/

Il contenuto di VOICEVOX_CORE_PATH si prepara con la procedura di VOICEVOX Core for PHP. Consulta quella pagina anche per la collocazione della libreria stessa, del dizionario OpenJTalk e dei file dei modelli.

​

Abilitare FFI

In CLI di norma funziona così com’è.

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

ffi.enable=true

Il funzionamento e i vincoli di FFI sono raccolti in PHP FFI.

​

Installare le risorse dell’engine

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

php artisan voicevox:install

Negli ambienti Orchestra Testbench il comando è il seguente.

vendor/bin/testbench voicevox:install

​

Punti di ingresso per ogni modalità

Client Talk

Avvia il VOICEVOX Engine ufficiale con Docker e fai sintesi vocale da testo.

Client Song

Fai sintesi canora usando Score e Note.

Native Talk

Chiama direttamente VOICEVOX CORE tramite FFI.

Native Song

Consulta l’uso dei modelli di canto e di sync().

​

Link di riferimento

• Panoramica VOICEVOX for Laravel
• Introduzione
• Riferimento configurazione
• VOICEVOX Core for PHP
• Utilizzo di VOICEVOX Core for PHP
• PHP FFI