# Manager de mémoire

## 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.

    $backendOptions = array(
        'cache_dir' => './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.

    $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.

## 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.

### 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]) :

    $memObject = $memoryManager->create($data);

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

### Créer des objets verrouillés

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

    $memObject = $memoryManager->createLocked($data);

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

### 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 :

    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.

## Régler le manager de mémoire

### Mémoire limite

La mémoire limite est le nombre d'octets autorisés à être utilisés 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) :

    $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.

### 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) :

    $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).