PHPackages                             neoacevedo/yii2-fastly-cache - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Caching](/categories/caching)
4. /
5. neoacevedo/yii2-fastly-cache

ActiveYii2-extension[Caching](/categories/caching)

neoacevedo/yii2-fastly-cache
============================

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

25.12.23(4mo ago)00GPL-3.0+PHPPHP >=8.2

Since Oct 11Pushed 3mo agoCompare

[ Source](https://github.com/neoacevedo/yii2-fastly-cache)[ Packagist](https://packagist.org/packages/neoacevedo/yii2-fastly-cache)[ Docs](https://neoacevedo.nom.co)[ Fund](https://ko-fi.com/neoacevedo)[ RSS](/packages/neoacevedo-yii2-fastly-cache/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (5)Used By (0)

Yii2 Fastly Cache
=================

[](#yii2-fastly-cache)

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

Características
---------------

[](#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
-----------

[](#instalación)

### Via Composer

[](#via-composer)

```
composer require neoacevedo/yii2-fastly-cache
```

Configuración
-------------

[](#configuración)

### Configuración Básica

[](#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

[](#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

[](#obtener-credenciales-de-fastly)

1. **API Token**: Obtén tu token desde [Fastly Dashboard](https://manage.fastly.com/account/personal/tokens)
2. **Store ID**: Crea un KV Store desde el dashboard de Fastly y obtén su ID

Uso
---

[](#uso)

### Uso Básico

[](#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

[](#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

[](#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
-------------------

[](#métodos-disponibles)

MétodoDescripción`get($key)`Obtiene un valor de caché`set($key, $value, $duration)`Establece un valor en caché`add($key, $value, $duration)`Agrega un valor solo si la clave no existe`delete($key)`Elimina una clave de caché`exists($key)`Verifica si una clave existe`flush()`Limpia toda la caché (con limitaciones)Requisitos
----------

[](#requisitos)

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

Limitaciones
------------

[](#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
----------

[](#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
-------

[](#soporte)

Si encuentras algún problema o tienes sugerencias:

- 🐛 [Reportar un bug](https://github.com/neoacevedo/yii2-fastly-cache/issues)
- 💡 [Solicitar una característica](https://github.com/neoacevedo/yii2-fastly-cache/issues)
- 📧 Contacto:

Donaciones
----------

[](#donaciones)

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

Ko-fiLitecoin[![Ko-fi QR](ko-fi.png)](https://ko-fi.com/neoacevedo)[![Litecoin](Litecoin.jpg)](Litecoin.jpg)☕ [Ko-fi](https://ko-fi.com/neoacevedo)Ł Donaciones Litecoin

Licencia
--------

[](#licencia)

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

Autor
-----

[](#autor)

**Néstor Acevedo**

- Website: [neoacevedo.nom.co](https://neoacevedo.nom.co)
- Email:

---

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

###  Health Score

35

—

LowBetter than 79% of packages

Maintenance77

Regular maintenance activity

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~24 days

Total

4

Last Release

140d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b76225f409e42b614d01e1788da075062004de1026d75051db8664e071199cc2?d=identicon)[neoacevedo](/maintainers/neoacevedo)

---

Tags

cachefastlykv-storeyii2-extensionperformancecacheyii2extensioncomponentfastlykey value storeedge-computing

### Embed Badge

![Health badge](/badges/neoacevedo-yii2-fastly-cache/health.svg)

```
[![Health](https://phpackages.com/badges/neoacevedo-yii2-fastly-cache/health.svg)](https://phpackages.com/packages/neoacevedo-yii2-fastly-cache)
```

###  Alternatives

[undefinedor/yii2-cached-active-record

The cached activeRecord for the Yii2 framework

102.6k](/packages/undefinedor-yii2-cached-active-record)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)