> ## 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

> Pacchetto Pure PHP che avvolge la libreria dinamica C di VOICEVOX CORE tramite PHP FFI. Consente di usare direttamente da PHP la sintesi vocale (TTS).

## Panoramica

[revolution/voicevox-core](https://github.com/invokable/voicevox-core-php) è un pacchetto Pure PHP che avvolge la libreria dinamica C di [VOICEVOX CORE](https://github.com/VOICEVOX/voicevox_core) tramite PHP FFI.

VOICEVOX è un engine di sintesi vocale (TTS) giapponese di alta qualità: con questo pacchetto puoi effettuare la sintesi vocale direttamente da PHP.

<Info>
  Se prima vuoi mettere a fuoco il funzionamento e i vincoli di PHP FFI, consulta [PHP FFI](/it/advanced/ffi).
</Info>

<Tip>
  Se lo usi da un'applicazione Laravel, leggi anche [VOICEVOX for Laravel](/it/packages/laravel-voicevox) per chiarire le differenze tra modalità client e modalità nativa.
</Tip>

<Warning>
  Negli ambienti server Web (come FPM) PHP FFI è spesso disabilitato (`ffi.enable=false`), quindi questo pacchetto **presuppone l'uso da CLI locale**.
</Warning>

## Requisiti

* PHP 8.3+
* Estensione `ext-ffi` abilitata
* VOICEVOX CORE 0.16+

## Installazione

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

## Configurazione della libreria

Per usare questo pacchetto sono necessari la libreria dinamica di VOICEVOX CORE (`.so` / `.dylib`), la libreria ONNX Runtime e il dizionario OpenJTalk.

<Steps>
  <Step title="Scaricare voicevox_core">
    Da [voicevox\_core releases](https://github.com/VOICEVOX/voicevox_core/releases) scarica ed esegui il downloader corrispondente al tuo OS e architettura. Al termine viene creata la directory `voicevox_core` nella directory corrente.

    Struttura di directory creata:

    ```
    voicevox_core/
    ├── dict/open_jtalk_dic_*/     # Dizionario OpenJTalk
    ├── c_api/lib/                 # Librerie dinamiche (.so, .dylib)
    ├── models/vvms/               # File dei modelli vocali (.vvm)
    └── onnxruntime/               # Libreria ONNX Runtime
    ```
  </Step>

  <Step title="Spostare in una posizione permanente">
    ```bash theme={null}
    mv voicevox_core ~/.local/voicevox_core
    ```
  </Step>

  <Step title="Creare un link simbolico (consigliato)">
    Crea un link simbolico affinché la libreria venga trovata automaticamente.

    <Warning>
      In `ln -s` utilizza sempre **percorsi assoluti**.
    </Warning>

    **macOS:**

    ```bash theme={null}
    # Sostituisci [VOICEVOX_CORE_DIR] con il percorso assoluto di voicevox_core
    ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.dylib /usr/local/lib/libvoicevox_core.dylib
    ```

    Se non è possibile caricare da `/usr/local/lib/`, imposta `DYLD_FALLBACK_LIBRARY_PATH` in `.zshrc` o simili:

    ```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>

### Alternativa: specificare via variabile d'ambiente

Se non puoi creare il link simbolico, imposta il percorso completo del file della libreria nella variabile d'ambiente `VOICEVOX_CORE_LIB_PATH`:

```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>
  Su macOS, se anche con `DYLD_FALLBACK_LIBRARY_PATH` non riesci a caricare la libreria, imposta `VOICEVOX_CORE_LIB_PATH`.
</Info>

## Documentazione

<Columns cols={2}>
  <Card title="Utilizzo" href="/it/packages/voicevox-core-php/usage" icon="play">
    Uso di base ed esempi di codice per la sintesi vocale.
  </Card>

  <Card title="Riferimento API" href="/it/packages/voicevox-core-php/api" icon="code">
    Riferimento dettagliato di tutte le classi, i metodi e gli enum.
  </Card>
</Columns>

## Link di riferimento

* 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 for Laravel](/it/packages/laravel-voicevox/index.md)
- [Modalità API Engine: Talk (sintesi vocale da testo) - VOICEVOX for Laravel](/it/packages/laravel-voicevox/engine-talk.md)
- [Utilizzo - VOICEVOX Core for PHP](/it/packages/voicevox-core-php/usage.md)
- [Riferimento API - VOICEVOX Core for PHP](/it/packages/voicevox-core-php/api.md)
- [PHP FFI](/it/advanced/ffi.md)