Zum Hauptinhalt springen

​
Übersicht

revolution/voicevox-core ist ein reines PHP-Paket, das die C-Dynamic-Library von VOICEVOX CORE mit PHP-FFI wrappt. VOICEVOX ist eine hochwertige japanische Text-Sprachsynthese-Engine (TTS). Mit diesem Paket können Sie die Sprachsynthese direkt aus PHP durchführen.
Wenn Sie zunächst die Funktionsweise und Einschränkungen von PHP-FFI selbst kennenlernen möchten, siehe PHP FFI.
Wenn Sie es in einer Laravel-Anwendung verwenden möchten, lesen Sie zusätzlich VOICEVOX für Laravel, um auch die Unterschiede zwischen Client-Modus und Native-Modus zu klären.
PHP-FFI ist in Webserver-Umgebungen (wie FPM) häufig deaktiviert (ffi.enable=false), daher ist dieses Paket auf die Nutzung in lokalen CLI-Umgebungen ausgelegt.

​
Anforderungen

  • PHP 8.3+
  • Aktivierte ext-ffi-Extension
  • VOICEVOX CORE 0.16+

​
Installation

composer require revolution/voicevox-core

​
Einrichtung der Bibliothek

Um dieses Paket zu verwenden, benötigen Sie die dynamische Bibliothek von VOICEVOX CORE (.so / .dylib), die ONNX-Runtime-Bibliothek und das OpenJTalk-Wörterbuch.
1

voicevox_core herunterladen

Laden Sie über voicevox_core releases den zu Ihrem OS und Ihrer Architektur passenden Downloader herunter und führen Sie ihn aus. Nach der Ausführung wird im aktuellen Verzeichnis ein Verzeichnis voicevox_core erstellt.Erzeugte Verzeichnisstruktur:
voicevox_core/
├── dict/open_jtalk_dic_*/     # OpenJTalk-Wörterbuch
├── c_api/lib/                 # Dynamische Bibliotheken (.so, .dylib)
├── models/vvms/               # Audiomodell-Dateien (.vvm)
└── onnxruntime/               # ONNX-Runtime-Bibliothek
2

An einen dauerhaften Ort verschieben

mv voicevox_core ~/.local/voicevox_core
3

Symbolischen Link erstellen (empfohlen)

Erstellen Sie einen symbolischen Link, damit die Bibliothek automatisch gefunden wird.
Verwenden Sie bei ln -s unbedingt absolute Pfade.
macOS:
# Ersetzen Sie [VOICEVOX_CORE_DIR] durch den absoluten Pfad zu voicevox_core
ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.dylib /usr/local/lib/libvoicevox_core.dylib
Wenn das Laden aus /usr/local/lib/ nicht funktioniert, setzen Sie in .zshrc o. Ä. DYLD_FALLBACK_LIBRARY_PATH:
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: Angabe über Umgebungsvariable

Wenn Sie keinen symbolischen Link erstellen können, setzen Sie den vollständigen Pfad zur Bibliotheksdatei in der Umgebungsvariablen 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"
Wenn Sie unter macOS auch mit DYLD_FALLBACK_LIBRARY_PATH nicht laden können, konfigurieren Sie es über VOICEVOX_CORE_LIB_PATH.

​
Dokumentation

Verwendung

Grundlegende Verwendung und Codebeispiele zu Text-Sprachsynthese und Audio-Erzeugung.

API-Referenz

Detaillierte Referenz aller Klassen, Methoden und Enums.
Zuletzt geändert am 13. Juli 2026

Verwandte Themen

VOICEVOX Core für PHPVerwendung - VOICEVOX Core für PHPAPI-Referenz - VOICEVOX Core für PHPVOICEVOX Core for PHP