Passer au contenu principal

​
Vue d’ensemble

revolution/voicevox-core est un package Pure PHP qui encapsule la bibliothèque dynamique C de VOICEVOX CORE via PHP FFI. VOICEVOX est un moteur de synthèse vocale (TTS) japonaise de haute qualité, et ce package permet de faire la synthèse directement depuis PHP.
Pour poser les prérequis sur le fonctionnement et les contraintes de PHP FFI, consultez PHP FFI.
Pour l’utilisation depuis une application Laravel, lisez également VOICEVOX for Laravel : cela clarifie les différences entre mode client et mode natif.
PHP FFI est souvent désactivé dans les environnements de serveur web (FPM, etc.) (ffi.enable=false). Ce package est donc conçu pour un usage en CLI locale.

​
Exigences

  • PHP 8.3+
  • L’extension ext-ffi activée
  • VOICEVOX CORE 0.16+

​
Installation

composer require revolution/voicevox-core

​
Mise en place de la bibliothèque

Pour utiliser ce package, la bibliothèque dynamique de VOICEVOX CORE (.so / .dylib), la bibliothèque ONNX Runtime et le dictionnaire OpenJTalk sont nécessaires.
1

Télécharger voicevox_core

Téléchargez et exécutez le downloader correspondant à votre OS et architecture depuis voicevox_core releases. L’exécution crée un dossier voicevox_core dans le répertoire courant.Structure de dossier créée :
voicevox_core/
├── dict/open_jtalk_dic_*/     # Dictionnaire OpenJTalk
├── c_api/lib/                 # Bibliothèque dynamique (.so, .dylib)
├── models/vvms/               # Fichiers de modèle vocal (.vvm)
└── onnxruntime/               # Bibliothèque ONNX Runtime
2

Déplacer vers un emplacement permanent

mv voicevox_core ~/.local/voicevox_core
3

Créer un lien symbolique (recommandé)

Créez un lien symbolique afin que la bibliothèque soit trouvée automatiquement.
Utilisez impérativement un chemin absolu avec ln -s.
macOS :
# Remplacez [VOICEVOX_CORE_DIR] par le chemin absolu de voicevox_core
ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.dylib /usr/local/lib/libvoicevox_core.dylib
Si le chargement depuis /usr/local/lib/ échoue, définissez DYLD_FALLBACK_LIBRARY_PATH dans .zshrc par exemple :
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

​
Alternative : spécifier via une variable d’environnement

Si vous ne pouvez pas créer de lien symbolique, définissez la variable VOICEVOX_CORE_LIB_PATH avec le chemin complet du fichier de la bibliothèque : 
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"
Sur macOS, si le chargement ne fonctionne pas même via DYLD_FALLBACK_LIBRARY_PATH, définissez VOICEVOX_CORE_LIB_PATH.

​
Documentation

Utilisation

Utilisation de base de la synthèse vocale et exemples de code.

Référence API

Référence détaillée de toutes les classes, méthodes et enums.

​
Liens de référence

Dernière modification le 13 juillet 2026

Sujets connexes

VOICEVOX Core for PHP