?????? Conjugador Andaluz PHP

Un script PHP que conjuga verbos del español y los translitera a una propuesta de Estándar Andaluz (EPA) utilizando la librería andaluh/andaluh-epa y un servicio externo para la conjugación base en español.

? Características Principales

• Conjugación Verbal: Toma un verbo en infinitivo (en español estándar o con terminaciones andaluzas como `-âh`, `-êh`, `-îh`) y obtiene sus conjugaciones en español.
• Transliteración a EPA: Convierte las conjugaciones obtenidas al estándar EPA propuesto.
• Mapeo y Normalización: Incluye un extenso mapeo (`$verboMappings`) y funciones (`replaceEnding`, etc.) para manejar variantes y normalizar verbos de entrada antes de la conjugación.
• API Simple: Expone la funcionalidad a través de una petición HTTP GET.
• Filtrado: Permite opcionalmente solicitar solo un tiempo (`t`) y modo (`m`) verbal específico.
• Correcciones Específicas: Aplica ajustes post-conjugación para ciertos verbos o casos particulares.

?? Requisitos Previos

• PHP: Versión 7.4 o superior recomendada.
• Extensiones PHP: * `curl`: Para realizar peticiones HTTP al servicio de conjugación. * `json`: Para manejar las respuestas JSON (generalmente habilitada por defecto).
• Composer: Para gestionar las dependencias PHP.
• Docker: Para ejecutar el servicio de conjugación `verbecc-svc`.
• Servicio verbecc-svc en ejecución: Una instancia del servicio bretttolbert/verbecc-svc debe estar accesible.

? Instalación y Configuración

1. Clonar el Repositorio:
   git clone https://github.com/kuasarx/conjugador
   cd <NOMBRE_DEL_DIRECTORIO>
   

2. Instalar Dependencias PHP:
   composer install
   

   Esto descargará la librería `andaluh/andaluh-epa` y configurará el autoload.

3. ? Ejecutar el Servicio verbecc-svc con Docker: Este script depende de un servicio externo (`verbecc-svc`) para obtener las conjugaciones base en español. Puedes ejecutarlo fácilmente usando Docker:

   docker run -d --name conjugador-servicio -p 32771:8080 bretttolbert/verbecc-svc:latest
   

   * `-d`: Ejecuta el contenedor en segundo plano (detached). * `--name conjugador-servicio`: Asigna un nombre al contenedor para fácil referencia. * `-p 32771:8080`: Mapea el puerto `8080` del contenedor (donde escucha `verbecc-svc`) al puerto `32771` de tu máquina host.

4. ? ¡Importante! Actualizar la URL del Servicio en el Código: El código PHP tiene hardcodeada la URL `http://192.168.0.84:32771`. Debes cambiarla para que apunte a donde está corriendo tu contenedor Docker.

   Si Docker corre en la misma máquina donde ejecutas PHP:* Probablemente puedas usar `localhost` o `127.0.0.1`. Si Docker corre en otra máquina:* Usa la IP de esa máquina.

   Modifica la siguiente línea dentro de la clase `Conjugador`, método `get_conjugaciones`:

   // Dentro del método get_conjugaciones()
   // CAMBIA ESTA LÍNEA:
   // $url = "http://192.168.0.84:32771/conjugate/es/".urlencode($this->verbo);
   // POR ESTA (si Docker está en la misma máquina):
   $url = "http://localhost:32771/conjugate/es/".urlencode($this->verbo);
   // O usa la IP correcta si Docker está en otra máquina.
   

? Uso

Para usar el conjugador, necesitas ejecutar el script PHP a través de un servidor web (como Apache o Nginx con PHP-FPM) o usando el servidor web incorporado de PHP para pruebas:

php -S localhost:8000

Luego, realiza una petición GET al script, pasando el verbo a conjugar en el parámetro q.

Ejemplos:

• Conjugar "hablâh":
  http://localhost:8000/conhugaôh.php?q=hablâh
  

  (Asumiendo que tu archivo se llama `conhugaôh.php`)

• Conjugar "comêh":
  http://localhost:8000/conhugaôh.php?q=comêh
  

• Conjugar "bîbbîh":
  http://localhost:8000/conhugaôh.php?q=bîbbîh
  

• Conjugar "çêh" (verbo 'ser'):
  http://localhost:8000/conhugaôh.php?q=çêh
  

• Obtener solo el presente de indicativo de "açêh" (verbo 'hacer'):
  (Nota: Los parámetros m (modo) y t (tiempo) deben usar las claves transliteradas devueltas por la API)
  http://localhost:8000/conhugaôh.php?q=açêh&m=indicatibo&t=preçente
  

• Obtener solo el infinitivo de "paçâh" (verbo 'pasar'):
  http://localhost:8000/conhugaôh.php?q=paçâh&m=infinitibo
  

Respuesta: El script devolverá una estructura JSON con las conjugaciones transliteradas al estándar EPA. Si se especifican m y t, la respuesta se filtrará a ese modo y tiempo específicos.

? Estructura del Código

• Conjugador (Clase Principal): * `__construct($verbo)`: Inicializa el objeto, normaliza el verbo de entrada y obtiene las conjugaciones base. * `partialTranscribtion($verbo)`: Convierte terminaciones como `-âh` a `-ar`. * `get_conjugaciones()`: Realiza la llamada cURL al servicio `verbecc-svc` para obtener las conjugaciones en español. * `translate_array($arr)`: Helper para transliterar los elementos de un array usando `AndaluhEpa`. * `conjugate()`: Orquesta la transliteración de las conjugaciones españolas al formato EPA, manejando pronombres y estructuras específicas.
• $verboMappings (Array): Un diccionario para mapear formas verbales de entrada específicas a su infinitivo estándar o forma base antes de la conjugación.
• Funciones de Reemplazo (replaceEnding, replaceFirst_H_Letter, etc.): Aplican reglas de sustitución de cadenas para normalizar o corregir la forma del verbo antes o después de la conjugación.
• Lógica Principal (Fuera de la clase): * Procesa el parámetro `$_REQUEST['q']`. * Aplica mapeos y reemplazos iniciales. * Instancia `Conjugador`. * Obtiene las conjugaciones (`conjugate()`). * Aplica correcciones post-conjugación. * Devuelve el resultado en formato JSON, aplicando filtros si `$_REQUEST['t']` y `$_REQUEST['m']` están presentes.

? Dependencias

• andaluh/andaluh-epa: Librería PHP para la transliteración al estándar EPA.
• bretttolbert/verbecc-svc: Servicio web (ejecutable con Docker) que proporciona las conjugaciones verbales base en español.

Licencia

Este proyecto se distribuye bajo la Licencia MIT. Ver el archivo LICENSE para más detalles (si existe) o consultar MIT License.