Vai al contenuto principale

​
Panoramica

revolution/voicevox-core è un pacchetto Pure PHP che avvolge la libreria dinamica C di VOICEVOX CORE tramite PHP FFI. VOICEVOX è un engine di sintesi vocale (TTS) giapponese di alta qualità: con questo pacchetto puoi effettuare la sintesi vocale direttamente da PHP.
Se prima vuoi mettere a fuoco il funzionamento e i vincoli di PHP FFI, consulta PHP FFI.
Se lo usi da un’applicazione Laravel, leggi anche VOICEVOX for Laravel per chiarire le differenze tra modalità client e modalità nativa.
Negli ambienti server Web (come FPM) PHP FFI è spesso disabilitato (ffi.enable=false), quindi questo pacchetto presuppone l’uso da CLI locale.

​
Requisiti

  • PHP 8.3+
  • Estensione ext-ffi abilitata
  • VOICEVOX CORE 0.16+

​
Installazione

composer require revolution/voicevox-core

​
Configurazione della libreria

Per usare questo pacchetto sono necessari la libreria dinamica di VOICEVOX CORE (.so / .dylib), la libreria ONNX Runtime e il dizionario OpenJTalk.
1

Scaricare voicevox_core

Da voicevox_core releases scarica ed esegui il downloader corrispondente al tuo OS e architettura. Al termine viene creata la directory voicevox_core nella directory corrente.Struttura di directory creata:
voicevox_core/
├── dict/open_jtalk_dic_*/     # Dizionario OpenJTalk
├── c_api/lib/                 # Librerie dinamiche (.so, .dylib)
├── models/vvms/               # File dei modelli vocali (.vvm)
└── onnxruntime/               # Libreria ONNX Runtime
2

Spostare in una posizione permanente

mv voicevox_core ~/.local/voicevox_core
3

Creare un link simbolico (consigliato)

Crea un link simbolico affinché la libreria venga trovata automaticamente.
In ln -s utilizza sempre percorsi assoluti.
macOS:
# Sostituisci [VOICEVOX_CORE_DIR] con il percorso assoluto di voicevox_core
ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.dylib /usr/local/lib/libvoicevox_core.dylib
Se non è possibile caricare da /usr/local/lib/, imposta DYLD_FALLBACK_LIBRARY_PATH in .zshrc o simili:
export DYLD_FALLBACK_LIBRARY_PATH="$HOME/lib:/usr/local/lib:/usr/lib"
Linux:
ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.so /usr/local/lib/libvoicevox_core.so

​
Alternativa: specificare via variabile d’ambiente

Se non puoi creare il link simbolico, imposta il percorso completo del file della libreria nella variabile d’ambiente VOICEVOX_CORE_LIB_PATH: 
export VOICEVOX_CORE_LIB_PATH=/path/to/libvoicevox_core.dylib

export VOICEVOX_CORE_LIB_PATH="$HOME/.local/voicevox_core/c_api/lib/libvoicevox_core.dylib"
Su macOS, se anche con DYLD_FALLBACK_LIBRARY_PATH non riesci a caricare la libreria, imposta VOICEVOX_CORE_LIB_PATH.

​
Documentazione

Utilizzo

Uso di base ed esempi di codice per la sintesi vocale.

Riferimento API

Riferimento dettagliato di tutte le classi, i metodi e gli enum.
Ultima modifica il 13 luglio 2026

Argomenti correlati

VOICEVOX Core for PHP