VOICEVOX Core for PHP

Overzicht

revolution/voicevox-core is een pure PHP-pakket dat de dynamische C-bibliotheek van VOICEVOX CORE wrapt met PHP FFI. VOICEVOX is een hoogwaardige Japanse tekst-naar-spraak-engine (TTS), en met dit pakket kun je rechtstreeks vanuit PHP spraak synthetiseren.

Wil je eerst de werking en beperkingen van PHP FFI zelf op een rij hebben, zie dan PHP FFI.

Werk je vanuit een Laravel-app, lees dan ook VOICEVOX for Laravel — dan begrijp je ook meteen het verschil tussen de clientmodus en de native modus.

Omdat PHP FFI in webserveromgevingen (zoals FPM) vaak is uitgeschakeld (ffi.enable=false), is dit pakket bedoeld voor gebruik in een lokale CLI.

Vereisten

PHP 8.3+
De ext-ffi-extensie is ingeschakeld
VOICEVOX CORE 0.16+

Installatie

composer require revolution/voicevox-core

De bibliotheek opzetten

Om dit pakket te gebruiken heb je de dynamische bibliotheek van VOICEVOX CORE (.so / .dylib), de ONNX Runtime-bibliotheek en het OpenJTalk-woordenboek nodig.

Download voicevox_core

Download de downloader die past bij je OS en architectuur via voicevox_core releases en voer die uit. Na uitvoering wordt in de huidige directory een voicevox_core-directory aangemaakt.De aangemaakte directorystructuur:

voicevox_core/
├── dict/open_jtalk_dic_*/     # OpenJTalk-woordenboek
├── c_api/lib/                 # Dynamische bibliotheken (.so, .dylib)
├── models/vvms/               # Spraakmodelbestanden (.vvm)
└── onnxruntime/               # ONNX Runtime-bibliotheek

Verplaats naar een permanente locatie

mv voicevox_core ~/.local/voicevox_core

Maak een symbolische link (aanbevolen)

Maak een symbolische link zodat de bibliotheek automatisch wordt gevonden.

Gebruik voor ln -s altijd een absoluut pad.

macOS:

# Vervang [VOICEVOX_CORE_DIR] door het absolute pad van voicevox_core
ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.dylib /usr/local/lib/libvoicevox_core.dylib

Als het laden vanuit /usr/local/lib/ niet lukt, stel dan DYLD_FALLBACK_LIBRARY_PATH in via bijvoorbeeld .zshrc:

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

Alternatief: opgeven via een omgevingsvariabele

Als je geen symbolische link kunt maken, stel dan het volledige pad naar het bibliotheekbestand in via de omgevingsvariabele 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"

Als het laden op macOS ook met DYLD_FALLBACK_LIBRARY_PATH niet lukt, stel het dan in via VOICEVOX_CORE_LIB_PATH.

Documentatie

Gebruik

Basisgebruik van tekst-naar-spraak en spraaksynthese, met codevoorbeelden.

API-referentie

Gedetailleerde referentie van alle klassen, methodes en enums.

Referentielinks

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

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Overzicht

Vereisten

Installatie

De bibliotheek opzetten

Alternatief: opgeven via een omgevingsvariabele

Documentatie

Gebruik

API-referentie

Referentielinks

​Overzicht

​Vereisten

​Installatie

​De bibliotheek opzetten

​Alternatief: opgeven via een omgevingsvariabele

​Documentatie

Gebruik

API-referentie

​Referentielinks

Overzicht

Vereisten

Installatie

De bibliotheek opzetten

Alternatief: opgeven via een omgevingsvariabele

Documentatie

Referentielinks