Cada elemento de datos almacenado en caché se identifica por una clave. Cuando se almacena un elemento de datos en la
memoria caché, se debe especificar una clave. Más tarde, cuando se recupera el elemento de datos de la memoria caché,
se debe proporcionar la tecla correspondiente.
Puedes utilizar una cadena o un valor arbitrario como una clave de caché. Cuando una clave no es una cadena de texto,
ésta será automáticamente serializada en una cadena.
Una estrategia común para definir una clave de caché es incluir en ella todos los factores determinantes en términos de
una matriz. Por ejemplo, [[yii\db\Schema]] utiliza la siguiente clave para almacenar en caché la información del esquema
de una tabla de base de datos:
```php
[
__CLASS__,// nombre de la clase del esquema
$this->db->dsn,// nombre del origen de datos de la conexión BD
$this->db->username,// usuario para la conexión BD
$name,// nombre de la tabla
];
```
Como puedes ver, la clave incluye toda la información necesaria para especificar de una forma exclusiva una tabla de
base de datos.
Cuando el un mismo almacenamiento en caché es utilizado por diferentes aplicaciones, se debería especificar un prefijo
único para las claves de de caché por cada una de las aplicaciones para así evitar conflictos. Esto puede hacerse
mediante la configuración de la propiedad [[yii\caching\Cache::keyPrefix]]. Por ejemplo, en la configuración de la
aplicación podrías escribir el siguiente código:
```php
'components'=>[
'cache'=>[
'class'=>'yii\caching\ApcCache',
'keyPrefix'=>'myapp',// un prefixo de clave de caché único
],
],
```
Para garantizar la interoperabilidad, deberían utilizarse sólo caracteres alfanuméricos.
### Caducidad de Caché <a name="cache-expiration"></a>
Un elemento de datos almacenado en la memoria caché permanecerá en ella para siempre, a menos que sea removida de alguna
manera debido a alguna directiva de caché (por ejemplo, el espacio de almacenamiento en caché está lleno y los datos
más antiguos se eliminan). Para cambiar este comportamiento, podrías proporcionar un parámetro de caducidad al llamar
[[yii\caching\Cache::set()|set()]] para guardar el elemento de datos. El parámetro nos indica por cuántos segundos el
elemento se mantendrá válido en memoria caché. Cuando llames [[yii\caching\Cache::get()|get()]] para recuperar el
elemento, si el tiempo de caducidad ha pasado, el método devolverá `false`, indicando que el elemento de datos no ha
sido encontrado en la memoria caché. Por ejemplo,
```php
// guardar los datos en memoria caché al menos 45 segundos
$cache->set($key,$data,45);
sleep(50);
$data=$cache->get($key);
if($data===false){
// $data ha caducado o no ha sido encontrado en la memoria caché
}
```
### Dependecias de Caché <a name="cache-dependencies"></a>
Además de configurar el tiempo de expiración, los datos almacenados en caché pueden también ser invalidados conforme
a algunos cambios en las dependencias (cache dependencies). Por ejemplo, [[yii\caching\FileDependency]] representa
la dependencia del tiempo de modificación del archivo. Cuando esta dependencia cambia, significa que el archivo
correspondiente ha cambiado. Como resultado, cualquier contenido anticuado que sea encontrado en el caché debería
ser invalidado y la llamada a [[yii\caching\Cache::get()|get()]] debería devolver `null`.
Una dependencia es representada como una instancia de [[yii\caching\Dependency]] o su clase hija. Cuando llamas
[[yii\caching\Cache::set()|set()]] para almacenar un elemento de datos en el caché, puedes pasar el objeto de dependencia
asociado. Por ejemplo,
```php
// Crear una dependencia sobre el tiempo de modificación del archivo example.txt.
$dependency = new \yii\caching\FileDependency(['fileName' => 'example.txt']);
// Los datos expirarán en 30 segundos.
// También podría ser invalidada antes si example.txt es modificado.
$cache->set($key, $data, 30, $dependency);
// El caché chequeará si los datos han expirado.
// También chequeará si la dependencia ha cambiado.
// Devolerá false si se encuentran algunas de esas condiciones.
$data = $cache->get($key);
```
Aquí abajo se muestra un sumario de las dependencias disponibles:
-[[yii\caching\ChainedDependency]]: la dependencia cambia si cualquiera de las dependencias en la cadena cambia.
-[[yii\caching\DbDependency]]: la dependencia cambia si el resultado de la consulta de la sentencia SQL especificada cambia.
-[[yii\caching\ExpressionDependency]]: la dependencia cambia si el resultado de la expresión de PHP especificada cambia.
-[[yii\caching\FileDependency]]: la dependencia cambia si se modifica la última fecha de modificación del archivo.
-[[yii\caching\GroupDependency]]: marca un elemento de datos en caché con un nombre de grupo. Puedes invalidar los elementos de datos almacenados en caché
con el mismo nombre del grupo a la vez llamando a [[yii\caching\GroupDependency::invalidate()]].
## Consultas en Caché <a name="query-caching"></a>
Las consultas en caché es una característica especial de caché construido sobre el almacenamiento de caché de datos. Se
proporciona para almacenar en caché el resultado de consultas a la base de datos.
Las consultas en caché requieren una [[yii\db\Connection|conexión a BD]] y un componente de aplicación
caché válido. El uso básico de las consultas en memoria caché es el siguiente, asumiendo `db` es una instancia [[yii\db\Connection]]:
```php
$duration=60;// guardar en caché el resultado de la consulta por 60 segundos.
$dependency=...;// dependencia opcional
$db->beginCache($duration,$dependency);
// ...realiza consultas a la BD aquí...
$db->endCache();
```
Como puedes ver, cualquier consulta SQL entre las llamadas `beginCache()` y `endCache()` serán guardadas en la memoria caché.
Si el resultado de la misma consulta se encuentra vigente en la memoria caché, la consulta se omitirá y el resultado
se servirá de la memoria caché en su lugar.
El almacenamiento en caché de consultas se puede usar para [DAO](db-dao.md), así como para [ActiveRecord](db-active-record.md).
> Nota: Algunos DBMS (por ejemplo, [MySQL](http://dev.mysql.com/doc/refman/5.1/en/query-cache.html)) también soporta
el almacenamiento en caché desde el mismo servidor de la BD. Puedes optar por utilizar cualquiera de los mecanismos
de memoria caché. El almacenamiento en caché de consultas previamente descrito tiene la ventaja que de que se puede
especificar dependencias de caché de una forma flexible y son potencialmente mucho más eficientes.
