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

# VOICEVOX Core for PHP

> Package Pure PHP qui encapsule la bibliothèque dynamique C de VOICEVOX CORE via PHP FFI. La synthèse vocale (TTS) peut être utilisée directement depuis PHP.

## Vue d'ensemble

[revolution/voicevox-core](https://github.com/invokable/voicevox-core-php) est un package Pure PHP qui encapsule la bibliothèque dynamique C de [VOICEVOX CORE](https://github.com/VOICEVOX/voicevox_core) via PHP FFI.

VOICEVOX est un moteur de synthèse vocale (TTS) japonaise de haute qualité, et ce package permet de faire la synthèse directement depuis PHP.

<Info>
  Pour poser les prérequis sur le fonctionnement et les contraintes de PHP FFI, consultez [PHP FFI](/fr/advanced/ffi).
</Info>

<Tip>
  Pour l'utilisation depuis une application Laravel, lisez également [VOICEVOX for Laravel](/fr/packages/laravel-voicevox) : cela clarifie les différences entre mode client et mode natif.
</Tip>

<Warning>
  PHP FFI est souvent désactivé dans les environnements de serveur web (FPM, etc.) (`ffi.enable=false`). Ce package est donc **conçu pour un usage en CLI locale**.
</Warning>

## Exigences

* PHP 8.3+
* L'extension `ext-ffi` activée
* VOICEVOX CORE 0.16+

## Installation

```bash theme={null}
composer require revolution/voicevox-core
```

## Mise en place de la bibliothèque

Pour utiliser ce package, la bibliothèque dynamique de VOICEVOX CORE (`.so` / `.dylib`), la bibliothèque ONNX Runtime et le dictionnaire OpenJTalk sont nécessaires.

<Steps>
  <Step title="Télécharger voicevox_core">
    Téléchargez et exécutez le downloader correspondant à votre OS et architecture depuis [voicevox\_core releases](https://github.com/VOICEVOX/voicevox_core/releases). L'exécution crée un dossier `voicevox_core` dans le répertoire courant.

    Structure de dossier créée :

    ```
    voicevox_core/
    ├── dict/open_jtalk_dic_*/     # Dictionnaire OpenJTalk
    ├── c_api/lib/                 # Bibliothèque dynamique (.so, .dylib)
    ├── models/vvms/               # Fichiers de modèle vocal (.vvm)
    └── onnxruntime/               # Bibliothèque ONNX Runtime
    ```
  </Step>

  <Step title="Déplacer vers un emplacement permanent">
    ```bash theme={null}
    mv voicevox_core ~/.local/voicevox_core
    ```
  </Step>

  <Step title="Créer un lien symbolique (recommandé)">
    Créez un lien symbolique afin que la bibliothèque soit trouvée automatiquement.

    <Warning>
      Utilisez impérativement un **chemin absolu** avec `ln -s`.
    </Warning>

    **macOS :**

    ```bash theme={null}
    # Remplacez [VOICEVOX_CORE_DIR] par le chemin absolu de voicevox_core
    ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.dylib /usr/local/lib/libvoicevox_core.dylib
    ```

    Si le chargement depuis `/usr/local/lib/` échoue, définissez `DYLD_FALLBACK_LIBRARY_PATH` dans `.zshrc` par exemple :

    ```bash theme={null}
    export DYLD_FALLBACK_LIBRARY_PATH="$HOME/lib:/usr/local/lib:/usr/lib"
    ```

    **Linux :**

    ```bash theme={null}
    ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.so /usr/local/lib/libvoicevox_core.so
    ```
  </Step>
</Steps>

### Alternative : spécifier via une variable d'environnement

Si vous ne pouvez pas créer de lien symbolique, définissez la variable `VOICEVOX_CORE_LIB_PATH` avec le chemin complet du fichier de la bibliothèque :

```bash theme={null}
export VOICEVOX_CORE_LIB_PATH=/path/to/libvoicevox_core.dylib
```

```bash theme={null}
export VOICEVOX_CORE_LIB_PATH="$HOME/.local/voicevox_core/c_api/lib/libvoicevox_core.dylib"
```

<Info>
  Sur macOS, si le chargement ne fonctionne pas même via `DYLD_FALLBACK_LIBRARY_PATH`, définissez `VOICEVOX_CORE_LIB_PATH`.
</Info>

## Documentation

<Columns cols={2}>
  <Card title="Utilisation" href="/fr/packages/voicevox-core-php/usage" icon="play">
    Utilisation de base de la synthèse vocale et exemples de code.
  </Card>

  <Card title="Référence API" href="/fr/packages/voicevox-core-php/api" icon="code">
    Référence détaillée de toutes les classes, méthodes et enums.
  </Card>
</Columns>

## Liens de référence

* GitHub : [invokable/voicevox-core-php](https://github.com/invokable/voicevox-core-php)
* VOICEVOX CORE : [VOICEVOX/voicevox\_core](https://github.com/VOICEVOX/voicevox_core)


## Related topics

- [VOICEVOX Core for PHP](/fr/packages/voicevox-core-php/index.md)