VOICEVOX Core für PHP

Reines PHP-Paket, das die C-Dynamic-Library von VOICEVOX CORE mittels PHP-FFI wrappt. Text-Sprachsynthese (TTS) direkt aus PHP nutzen.

​

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

​

Referenzlinks

• GitHub: invokable/voicevox-core-php
• VOICEVOX CORE: VOICEVOX/voicevox_core