Installation und Konfiguration - VOICEVOX für Laravel

Beschreibt die Einführung von VOICEVOX für Laravel, die Installation je nach FFI-Verfügbarkeit, die Konfigurationsdatei, .env und die Vorbereitung der Engine-Ressourcen.

​

Was zu installieren ist

VOICEVOX für Laravel benötigt je nach genutztem Modus zusätzliche Pakete und eine lokale Einrichtung.

Nur Client

Wenn Sie sich nur per HTTP mit der offiziellen VOICEVOX-Engine verbinden, reicht revolution/laravel-voicevox aus.

composer require revolution/laravel-voicevox

Auch Native / Engine-API

Bei Modi mit FFI installieren Sie zusätzlich revolution/voicevox-core.

composer require revolution/laravel-voicevox revolution/voicevox-core

​

Anforderungen

Punkt	Inhalt
PHP	8.3+
Laravel	12+
Erforderliche Extensions	ext-zip
FFI ext-ffi	Für Native-Modus / Engine-API erforderlich

In üblichen Webservern einschließlich Laravel Cloud ist FFI deaktiviert. Probieren Sie Native-Modus und Engine-API in einer lokalen CLI-Umgebung aus.

​

Einrichtungsschritte

1. Paket installieren

   Führen Sie die Installation je nach genutztem Modus über Composer durch. Für Native-Modus und Engine-API wird auch VOICEVOX Core für PHP benötigt.

2. Konfigurationsdatei veröffentlichen

   php artisan vendor:publish --tag="voicevox-config"
   
3. .env konfigurieren

   Für den reinen Client-Modus setzen Sie VOICEVOX_URL; bei Nutzung von FFI setzen Sie VOICEVOX_CORE_PATH.

4. Bei Bedarf Engine-Ressourcen installieren

   Wenn Sie /speaker_info oder /singer_info nutzen, sind zusätzliche Ressourcen erforderlich.

​

config/voicevox.php

Alle Konfigurationsoptionen finden Sie in der Konfigurationsreferenz.

return [
    'client' => [
        'url' => env('VOICEVOX_URL', 'http://127.0.0.1:50021'),
        'core_version' => env('VOICEVOX_CLIENT_CORE_VERSION'),
    ],

    'core' => [
        'path' => env('VOICEVOX_CORE_PATH'),
        'dict' => env('VOICEVOX_CORE_DICT_PATH', 'dict/open_jtalk_dic_utf_8-1.11'),
        'models' => env('VOICEVOX_CORE_MODELS_PATH', 'models/vvms'),
        'vvms' => ['0.vvm', '9.vvm', 's0.vvm'],
    ],

    'engine' => [
        'disabled' => env('VOICEVOX_ENGINE_DISABLED', false),
        'fallback_url' => env('VOICEVOX_ENGINE_FALLBACK_URL', 'http://127.0.0.1:50021'),
    ],
];

​

Mindestanforderungen an .env

​

Nur Client-Modus

Wenn Sie die offizielle Engine mit dem Standardwert http://127.0.0.1:50021 starten, sind keine zusätzlichen Einstellungen erforderlich.

VOICEVOX_URL=http://127.0.0.1:50021

​

Native-Modus / Engine-API

VOICEVOX_CORE_PATH=/path/to/voicevox_core/

Der Inhalt von VOICEVOX_CORE_PATH wird gemäß den Schritten in VOICEVOX Core für PHP vorbereitet. Prüfen Sie auch dort die Platzierung von Library, OpenJTalk-Wörterbuch und Modelldateien.

​

FFI aktivieren

In CLI-Umgebungen ist es üblicherweise direkt nutzbar.

Wenn Sie die Laravel-Version der Engine-API lokal starten, aktivieren Sie FFI in php.ini.

ffi.enable=true

Die Funktionsweise und Einschränkungen von FFI sind unter PHP FFI zusammengefasst.

​

Engine-Ressourcen installieren

Wenn Sie Ressourcen-Endpunkte wie /speaker_info oder /singer_info verwenden, installieren Sie separat Ressourcen-Dateien.

php artisan voicevox:install

In der Orchestra-Testbench-Umgebung lautet der Befehl:

vendor/bin/testbench voicevox:install

​

Einstiegspunkte je Modus

Client Talk

Starten Sie die offizielle VOICEVOX-Engine über Docker und führen Sie die Text-Sprachsynthese durch.

Client Song

Führen Sie mit Score und Note die Gesangssynthese durch.

Native Talk

Rufen Sie VOICEVOX CORE direkt über FFI auf.

Native Song

Sehen Sie sich Einsatzmöglichkeiten des Gesangsmodells und von sync() an.

​

Referenzlinks

• VOICEVOX für Laravel – Übersicht
• Erste Schritte
• Konfigurationsreferenz
• VOICEVOX Core für PHP
• Verwendung von VOICEVOX Core für PHP
• PHP FFI