22.2. Manager de mémoire

22.2.1. Créer un manager de mémoire

Vous pouvez créer un nouveau manager de mémoire (objet Zend_Memory_Manager) en utilisant la méthode Zend_Memory::factory($backendName [, $backendOprions]).

Le premier argument $backendName est le nom d'un type de backend supporté par Zend_Cache

Le second argument $backendOptions est un tableau optionnel indiquant les options du backend.

<?php

$backendOptions = array(
    'cacheDir' => './tmp/' // Dossier où les blocks de mémoire peuvent être stockés
);

$memoryManager = Zend_Memory::factory('File', $backendOptions);

?>

Zend_Memory utilise les backends Zend_Cache comme fournisseurs de stockage.

Vous pouvez de plus utiliser le nom spécial 'None' en tant que nom de backend supplémentaire de Zend_Cache.

<?php

$memoryManager = Zend_Memory::factory('None');
                
?>

Si vous utilisez 'None', alors le manager de mémoire ne mettra pas en cache les blocks de mémoire. Ceci est intéressant si vous savez que la mémoire n'est pas limitée ou la taille complète des objets n'atteint jamais la limite de mémoire.

Le backend 'None' ne nécessite aucune option.

22.2.2. Manager les objets mémoire

Cette section décrit la création et la destruction d'objet de mémoire, et les réglages du manager de mémoire.

22.2.2.1. Créer des objets mobiles

Créer des objets mobiles (objets qui peuvent être mis en cache) en utilisant la méthode Zend_Memory_Manager::create([$data]) :

<?php
$memObject = $memoryManager->create($data);
?>

L'argument $data est optionel et utilisé pour initialiser la valeur de l'objet. Si l'argument $data est omis, la valeur est une chaîne vide.

22.2.2.2. Créer des objets vérouillés

Créer des objets vérrouillées (objets qui ne doivent pas être mis en cache) en utilisant la méthode Zend_Memory_Manager::createLocked([$data]) :

<?php
$memObject = $memoryManager->createLocked($data);
?>

L'argument $data est optionel et utilisé pour initialiser la valeur de l'objet. Si l'argument $data est omis, la valeur est une chaîne vide.

22.2.2.3. Détruire des objets

Les objets mémoire sont automatiquement détruits et effacés de la mémoire quand ils sont hors de portée :

<?php
function foo()
{
    global $memoryManager, $memList;

    ...

    $memObject1 = $memoryManager->create($data1);
    $memObject2 = $memoryManager->create($data2);
    $memObject3 = $memoryManager->create($data3);

    ...

    $memList[] = $memObject3;

    ...

    unset($memObject2); // $memObject2 est détruit ici

    ...
    // $memObject1 est détruit ici
    // mais $memObject3 est toujours référencé par $memList et n'est pas détruit
}
?>

Ceci s'applique aux objets mobiles et verrouillés.

22.2.3. Régler le manager de mémoire

22.2.3.1. Mémoire limite

La mémoire limite est le nombre d'octets autorisés pour être utilisé par des objets mobiles chargés.

Si le chargement ou la création d'un objet entraîne l'utilisation de mémoire excédant cette limite, alors le manager met en cache un certain nombre d'objet.

Vous pouvez récupérer et régler la mémoire limite en utilisant les méthodes getMemoryLimit() et setMemoryLimit($newLimit) :

<?php
$oldLimit = $memoryManager->getMemoryLimit();  // Récupére la mémoire limite en octets
$memoryManager->setMemoryLimit($newLimit);     //Règle la mémoire limite en octets
?>

Une valeur négative pour limite de mémoire équivaut à "pas de limite".

La valeur par défaut est deux-tiers de la valeur de 'memory_limit' dans le php.ini ou 'no limit' (-1) si 'memory_limit' n'est pas réglé dans le php.ini.

22.2.3.2. MinSize (taille minimum)

MinSize est la taille minimale des objets de mémoire, qui peuvent être mis en cache par le manager de mémoire. Le manager ne met pas en cache des objets plus petits que cette valeur. Ceci réduit le nombre d'opérations de mise de cache/chargement

Vous pouvez récupérer et régler la taille minimale en utilisant les méthodes getMinSize() et setMinSize($newSize) :

<?php
$oldMinSize = $memoryManager->getMinSize();  // Récupère la taille minimale en octets
$memoryManager->setMinSize($newSize);        //Règle la taille minimale en octets
?>

La taille minimum par défaut est 16KB (16384 octets).