> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation et configuration - VOICEVOX for Laravel

> Méthode d'installation de VOICEVOX for Laravel, installation selon la présence de FFI, fichier de configuration, .env et préparation des ressources du moteur.

## Ce qu'il faut installer

Selon le mode que vous souhaitez utiliser, les packages additionnels et la mise en place locale diffèrent.

<Tabs>
  <Tab title="Client uniquement">
    Pour une simple connexion HTTP au moteur officiel VOICEVOX, seul `revolution/laravel-voicevox` suffit.

    ```shell theme={null}
    composer require revolution/laravel-voicevox
    ```
  </Tab>

  <Tab title="Natif / API du moteur également">
    Pour les modes utilisant FFI, installez aussi `revolution/voicevox-core`.

    ```shell theme={null}
    composer require revolution/laravel-voicevox revolution/voicevox-core
    ```
  </Tab>
</Tabs>

## Exigences

| Élément           | Contenu                              |
| ----------------- | ------------------------------------ |
| PHP               | 8.3+                                 |
| Laravel           | 12+                                  |
| Extension requise | `ext-zip`                            |
| FFI `ext-ffi`     | Requis en mode natif / API du moteur |

<Warning>
  Sur la plupart des serveurs web, y compris Laravel Cloud, FFI est désactivé. Essayez le mode natif et l'API du moteur **en CLI locale**.
</Warning>

## Procédure d'installation

<Steps>
  <Step title="Installer le package">
    Installez avec Composer selon le mode souhaité. Le mode natif et l'API du moteur nécessitent également [VOICEVOX Core for PHP](/fr/packages/voicevox-core-php).
  </Step>

  <Step title="Publier le fichier de configuration">
    ```shell theme={null}
    php artisan vendor:publish --tag="voicevox-config"
    ```
  </Step>

  <Step title="Configurer le .env">
    Configurez `VOICEVOX_URL` en mode client uniquement, ou `VOICEVOX_CORE_PATH` pour utiliser FFI.
  </Step>

  <Step title="Installer les ressources du moteur si nécessaire">
    Pour utiliser `/speaker_info` ou `/singer_info`, des ressources supplémentaires sont requises.
  </Step>
</Steps>

## `config/voicevox.php`

Toutes les options sont détaillées dans la [Référence de configuration](/fr/packages/laravel-voicevox/configuration).

```php theme={null}
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'),
    ],
];
```

## `.env` minimal

### Mode client uniquement

Si vous démarrez le moteur officiel à l'adresse par défaut `http://127.0.0.1:50021`, aucune configuration supplémentaire n'est nécessaire.

```dotenv theme={null}
VOICEVOX_URL=http://127.0.0.1:50021
```

### Mode natif / API du moteur

```dotenv theme={null}
VOICEVOX_CORE_PATH=/path/to/voicevox_core/
```

<Info>
  Le contenu de `VOICEVOX_CORE_PATH` se prépare selon la procédure de [VOICEVOX Core for PHP](/fr/packages/voicevox-core-php). Vérifiez également là-bas l'emplacement de la bibliothèque, du dictionnaire OpenJTalk et des fichiers modèles.
</Info>

## Activer FFI

En CLI, cela fonctionne normalement sans intervention.

Pour démarrer localement l'API version Laravel, activez FFI dans `php.ini`.

```ini theme={null}
ffi.enable=true
```

Le fonctionnement et les contraintes de FFI sont résumés dans [PHP FFI](/fr/advanced/ffi).

## Installation des ressources du moteur

Pour utiliser les endpoints de type ressource comme `/speaker_info` ou `/singer_info`, installez les fichiers de ressources séparément.

```shell theme={null}
php artisan voicevox:install
```

Sous Orchestra Testbench, utilisez la commande suivante.

```shell theme={null}
vendor/bin/testbench voicevox:install
```

## Points d'entrée par mode

<Columns cols={2}>
  <Card title="Client Talk" href="/fr/packages/laravel-voicevox/client-talk" icon="message-circle">
    Démarrez le moteur officiel VOICEVOX avec Docker et effectuez la synthèse vocale de texte.
  </Card>

  <Card title="Client Song" href="/fr/packages/laravel-voicevox/client-song" icon="music">
    Effectuez la synthèse chantée avec `Score` et `Note`.
  </Card>

  <Card title="Native Talk" href="/fr/packages/laravel-voicevox/native-talk" icon="cpu">
    Appelez directement VOICEVOX CORE via FFI.
  </Card>

  <Card title="Native Song" href="/fr/packages/laravel-voicevox/native-song" icon="music">
    Découvrez l'usage du modèle de chant et de `sync()`.
  </Card>
</Columns>

## Liens de référence

* [Vue d'ensemble de VOICEVOX for Laravel](/fr/packages/laravel-voicevox)
* [Prise en main](/fr/packages/laravel-voicevox/getting-started)
* [Référence de configuration](/fr/packages/laravel-voicevox/configuration)
* [VOICEVOX Core for PHP](/fr/packages/voicevox-core-php)
* [Utilisation de VOICEVOX Core for PHP](/fr/packages/voicevox-core-php/usage)
* [PHP FFI](/fr/advanced/ffi)


## Related topics

- [Référence de configuration - VOICEVOX for Laravel](/fr/packages/laravel-voicevox/configuration.md)
- [Première analyse de Laravel Passkeys (passkeys-server + @laravel/passkeys)](/fr/blog/passkeys-introduction.md)
- [Laravel Cashier (Stripe)](/fr/cashier.md)
- [Créer un serveur MCP avec Laravel](/fr/advanced/mcp-server.md)
- [Configuration](/fr/configuration.md)