README

Componente de caché Yii2 para Fastly KV Store: solución de almacenamiento en caché perimetral de alto rendimiento.

Características

• ✅ Integración nativa con Fastly Key-Value Store
• ✅ Caché perimetral de alto rendimiento
• ✅ Compatible con la interfaz estándar de caché de Yii2
• ✅ Configuración simple y directa
• ✅ Soporte para PHP 8.2+
• ✅ Manejo de errores robusto

Instalación

Via Composer

composer require neoacevedo/yii2-fastly-cache

Configuración

Configuración Básica

Agrega el componente a la configuración de tu aplicación Yii2:

'components' => [
    'cache' => [
        'class' => 'neoacevedo\yii2\fastly\FastlyKvCache',
        'apiToken' => 'TU_FASTLY_API_TOKEN',
        'storeId' => 'TU_FASTLY_STORE_ID',
    ],
],

Configuración Avanzada

'components' => [
    'cache' => [
        'class' => 'neoacevedo\yii2\fastly\FastlyKvCache',
        'apiToken' => 'TU_FASTLY_API_TOKEN',
        'storeId' => 'TU_FASTLY_STORE_ID',
        'keyPrefix' => 'myapp_',
        'defaultDuration' => 3600, // 1 hora
    ],
],

Obtener Credenciales de Fastly

1. API Token: Obtén tu token desde Fastly Dashboard
2. Store ID: Crea un KV Store desde el dashboard de Fastly y obtén su ID

Uso

Uso Básico

// Guardar datos en caché
Yii::$app->cache->set('mi_clave', 'mi_valor', 3600);

// Obtener datos de caché
$valor = Yii::$app->cache->get('mi_clave');

// Verificar si existe una clave
if (Yii::$app->cache->exists('mi_clave')) {
    // La clave existe
}

// Eliminar una clave
Yii::$app->cache->delete('mi_clave');

Uso con Dependencias

use yii\caching\FileDependency;

$dependency = new FileDependency(['fileName' => 'path/to/file.txt']);
Yii::$app->cache->set('mi_clave', 'mi_valor', 3600, $dependency);

Uso con Tags

use yii\caching\TagDependency;

// Guardar con tags
Yii::$app->cache->set('usuario_1', $userData, 3600, new TagDependency(['tags' => 'usuarios']));

// Invalidar por tag
TagDependency::invalidate(Yii::$app->cache, 'usuarios');

Métodos Disponibles

Requisitos

• PHP >= 8.2
• Yii2 >= 2.0.54
• Cuenta de Fastly con KV Store habilitado
• Extensión cURL de PHP

Limitaciones

• Método flush(): Implementado con limitaciones de rendimiento debido a que requiere listar y eliminar claves individualmente
• Operaciones por lotes: getValues() realiza múltiples llamadas individuales a la API en lugar de una operación batch
• Rate limiting: Las operaciones masivas pueden alcanzar límites de velocidad de la API de Fastly
• Paginación en flush: El vaciado completo requiere múltiples llamadas paginadas para obtener todas las claves
• Rendimiento de flush: La operación de limpieza completa puede ser lenta en stores con muchas claves
• Dependencias de red: Todas las operaciones requieren conectividad a la API de Fastly
• Manejo de errores HTTP: Los códigos de error específicos (429, 404) se registran pero pueden no propagarse adecuadamente

Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/nueva-caracteristica)
3. Commit tus cambios (git commit -am 'Agrega nueva característica')
4. Push a la rama (git push origin feature/nueva-caracteristica)
5. Crea un Pull Request

Soporte

Si encuentras algún problema o tienes sugerencias:

• 🐛 Reportar un bug
• 💡 Solicitar una característica
• 📧 Contacto: contacto@neoacevedo.nom.co

Donaciones

Si este proyecto te es útil, considera hacer una donación:

Ko-fi	Litecoin
☕ Ko-fi	Ł Donaciones Litecoin

Licencia

Este proyecto está licenciado bajo la Licencia GPL-3.0+ - ver el archivo LICENSE.md para más detalles.

Autor

Néstor Acevedo

• Website: neoacevedo.nom.co
• Email: contacto@neoacevedo.nom.co

⭐ Si te gusta este proyecto, ¡dale una estrella en GitHub!