letkode/helpers

PHP 8.4 utility helpers for Symfony applications

1.0.0 2026-05-04 05:08 UTC

Requires

• php: ^8.4
• ext-intl: *
• nesbot/carbon: ^3.0
• symfony/uid: ^7.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.95
• phpstan/phpstan: ^2
• phpunit/phpunit: ^11
• symfony/dependency-injection: ^7.0
• symfony/http-kernel: ^7.0
• symfony/translation: ^7.0

MIT

README

Bienvenido a la biblioteca central de Helpers de la aplicación. Esta librería ha sido diseñada bajo los principios de Responsabilidad Única (SRP) y las Reglas de Oro de diseño: Estrategia en el Constructor y Datos en el Handle.

A continuación se describen los conceptos de cada directorio y los enlaces a sus guías detalladas.

📂 Validación

Concepto: Helpers encargados exclusivamente de realizar comprobaciones y asegurar la integridad de los datos.

• Responsabilidad: Deben devolver siempre un valor de tipo bool.
• Ejemplos: Validar RUT, verificar fortaleza de contraseña, comparar fechas.
• Ver detalle de funciones y parámetros →

📂 Conversión

Concepto: Helpers destinados a transformar un dato de un tipo a otro totalmente distinto o generar nuevos valores basados en parámetros.

• Responsabilidad: Cambiar la naturaleza del dato (ej. de un Objeto a un String).
• Ejemplos: Número a palabras, Fecha a texto relativo, Generador de contraseñas aleatorias.
• Ver detalle de funciones y parámetros →

📂 Strings

Concepto: Helpers especializados en la manipulación y limpieza de cadenas de texto.

• Responsabilidad: Recibir un string y devolver un string transformado.
• Ejemplos: Slugify, limpieza de caracteres especiales, ofuscación de datos.
• Ver detalle de funciones y parámetros →

📂 Arrays

Concepto: Helpers diseñados para la gestión de colecciones de datos, listas y estructuras jerárquicas.

• Responsabilidad: Operar sobre estructuras de datos array.
• Ejemplos: Construcción de árboles, aplanamiento de claves, ordenamiento por clave.
• Ver detalle de funciones y parámetros →

📂 Documentos de Identidad

Concepto: Sistema de validación y formateo de documentos de identidad para LATAM + España.

• Responsabilidad: Validar la integridad del número (checksum o regex) y devolver el formato canónico del país.
• Ejemplos: RUT chileno, CPF/CNPJ brasileño, DNI/NIF español, CURP mexicano.
• Ver detalle de países y tipos soportados →

📖 Guías Adicionales

• Cómo crear un nuevo Helper (Estándar de Oro): Sigue este estándar para mantener la calidad y coherencia de la librería.
• Contratos e Interfaces: Definición técnica de las interfaces HelperInterface.

Nota Técnica: Todos los helpers son final readonly y están optimizados para PHP 8.4, garantizando inmutabilidad y alto rendimiento.