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

> Paquete Pure PHP que envuelve la biblioteca dinámica C de VOICEVOX CORE mediante PHP FFI. Permite usar la síntesis de voz (TTS) directamente desde PHP.

## Resumen

[revolution/voicevox-core](https://github.com/invokable/voicevox-core-php) es un paquete Pure PHP que envuelve con PHP FFI la biblioteca dinámica C de [VOICEVOX CORE](https://github.com/VOICEVOX/voicevox_core).

VOICEVOX es un motor de síntesis de voz (TTS) en japonés de alta calidad, y con este paquete puedes hacer síntesis de voz directamente desde PHP.

<Info>
  Si quieres repasar antes el mecanismo y las restricciones del propio PHP FFI, consulta [PHP FFI](/es/advanced/ffi).
</Info>

<Tip>
  Si lo vas a usar desde una app Laravel, lee también [VOICEVOX for Laravel](/es/packages/laravel-voicevox), donde se organizan las diferencias entre el modo cliente y el modo nativo.
</Tip>

<Warning>
  Como PHP FFI suele estar deshabilitado en entornos de servidor web (FPM, etc.) (`ffi.enable=false`), este paquete está pensado **para uso en CLI local**.
</Warning>

## Requisitos

* PHP 8.3+
* Que la extensión `ext-ffi` esté habilitada
* VOICEVOX CORE 0.16+

## Instalación

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

## Configuración de la biblioteca

Para usar este paquete se necesitan la biblioteca dinámica de VOICEVOX CORE (`.so` / `.dylib`), la biblioteca ONNX Runtime y el diccionario OpenJTalk.

<Steps>
  <Step title="Descarga voicevox_core">
    Descarga el downloader adecuado a tu SO y arquitectura desde [voicevox\_core releases](https://github.com/VOICEVOX/voicevox_core/releases) y ejecútalo. Al ejecutarlo se crea el directorio `voicevox_core` en el directorio actual.

    Estructura del directorio que se crea:

    ```
    voicevox_core/
    ├── dict/open_jtalk_dic_*/     # Diccionario OpenJTalk
    ├── c_api/lib/                 # Biblioteca dinámica (.so, .dylib)
    ├── models/vvms/               # Archivos de modelo de voz (.vvm)
    └── onnxruntime/               # Biblioteca ONNX Runtime
    ```
  </Step>

  <Step title="Muévelo a una ubicación permanente">
    ```bash theme={null}
    mv voicevox_core ~/.local/voicevox_core
    ```
  </Step>

  <Step title="Crea enlaces simbólicos (recomendado)">
    Crea enlaces simbólicos para que la biblioteca se encuentre automáticamente.

    <Warning>
      En `ln -s` utiliza siempre **rutas absolutas**.
    </Warning>

    **macOS:**

    ```bash theme={null}
    # Sustituye [VOICEVOX_CORE_DIR] por la ruta absoluta de voicevox_core
    ln -s [VOICEVOX_CORE_DIR]/libvoicevox_core.dylib /usr/local/lib/libvoicevox_core.dylib
    ```

    Si no se puede cargar desde `/usr/local/lib/`, configura `DYLD_FALLBACK_LIBRARY_PATH` en `.zshrc`, por ejemplo:

    ```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: indicarlo por variable de entorno

Si no puedes crear enlaces simbólicos, configura la ruta completa al archivo de la biblioteca en la variable de entorno `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>
  Si en macOS no se puede cargar ni siquiera con `DYLD_FALLBACK_LIBRARY_PATH`, configúralo con `VOICEVOX_CORE_LIB_PATH`.
</Info>

## Documentación

<Columns cols={2}>
  <Card title="Uso" href="/es/packages/voicevox-core-php/usage" icon="play">
    Uso básico de síntesis de voz y ejemplos de código.
  </Card>

  <Card title="Referencia de API" href="/es/packages/voicevox-core-php/api" icon="code">
    Referencia detallada de todas las clases, métodos y enums.
  </Card>
</Columns>

## Enlaces de referencia

* 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](/es/packages/laravel-voicevox/index.md)
- [Modo Engine API: Talk (síntesis de voz desde texto) - VOICEVOX for Laravel](/es/packages/laravel-voicevox/engine-talk.md)
- [Uso - VOICEVOX Core for PHP](/es/packages/voicevox-core-php/usage.md)
- [Referencia de API - VOICEVOX Core for PHP](/es/packages/voicevox-core-php/api.md)
- [PHP FFI](/es/advanced/ffi.md)