# メモリマネージャ

## メモリマネージャの作成

新しいメモリマネージャ (Zend_Memory_Manager オブジェクト) を作成するには、 Zend_Memory::factory($backendName [, $backendOprions]) メソッドを使用します。

最初の引数 `$backendName` は文字列で、 Zend_Cache がサポートするバックエンド実装のいずれかの名前を指定します。

二番目の引数 `$backendOptions` は省略可能で、 バックエンドに渡すオプションの配列を指定します。

    $backendOptions = array(
        'cache_dir' => './tmp/' // スワップしたメモリブロックを配置するディレクトリ
    );

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

Zend_Memory は Zend_Cache のバックエンド を使用してデータを保存します。

標準の Zend_Cache のバックエンドに加え、特別な名前 'None' をバックエンド名として使用することもできます。

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

バックエンド名に 'None' を使用すると、 メモリマネージャは決してメモリブロックをスワップしなくなります。 メモリの制限がない場合、あるいはオブジェクトのサイズが 決してメモリの制限に達しない場合などに有用です。

'None' バックエンドには何もオプションを指定する必要がありません。

## メモリオブジェクトの管理

この節では、管理しているメモリ内でのオブジェクトの作成や破棄の方法、 そしてメモリマネージャの挙動を設定する方法を説明します。

### 移動可能なオブジェクトの作成

移動可能なオブジェクト (スワップされる可能性のあるオブジェクト) を作成するには、Zend_Memory_Manager::create([$data]) メソッドを使用します。

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

引数 `$data` は省略可能で、 オブジェクトの値を初期化するために使用します。 引数 `$data` を省略した場合は、値は空の文字列となります。

### ロックされたオブジェクトの作成

ロックされたオブジェクト (スワップされないオブジェクト) を作成するには、Zend_Memory_Manager::createLocked([$data]) メソッドを使用します。

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

引数 `$data` は省略可能で、 オブジェクトの値を初期化するために使用します。 引数 `$data` を省略した場合は、値は空の文字列となります。

### オブジェクトの破棄

メモリオブジェクトは、それがスコープの外に出た際に 自動的に破棄され、メモリから削除されます。

    function foo()
    {
        global $memoryManager, $memList;

        ...

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

        ...

        $memList[] = $memObject3;

        ...

        unset($memObject2); // $memObject2 はここで破棄されます

        ...
        // $memObject1 はここで破棄されますが、
        // $memObject3 オブジェクトはまだ $memList に参照されており、
        // 破棄されていません
    }

これは、移動可能なオブジェクトとロックされたオブジェクトの どちらにもあてはまります。

## メモリオブジェクトの設定

### メモリの制限

メモリの制限とは、移動可能なオブジェクトを読み込む際に 使用できるバイト数のことです。

オブジェクトを読み込んだり作成したりすることで この制限をこえてしまう場合は、 メモリマネージャは他のオブジェクトのどれかをスワップします。

メモリの制限を取得あるいは設定するには、 getMemoryLimit() メソッドおよび setMemoryLimit($newLimit) メソッドを使用します。

    $oldLimit = $memoryManager->getMemoryLimit();  // メモリの制限バイト数を取得します
    $memoryManager->setMemoryLimit($newLimit);     // メモリの制限バイト数を設定します

メモリの制限に負の値を設定すると、'制限なし' を意味します。

デフォルト値は、php.ini の 'memory_limit' の値の三分の二となります。もし php.ini で 'memory_limit' が設定されていない場合は、デフォルト値は '制限なし' (-1) となります。

### MinSize

MinSize は、メモリマネージャがスワップの対象とするメモリオブジェクトの最小サイズです。 メモリマネージャは、この値より小さなサイズのオブジェクトはスワップしません。 これにより、スワップや読み込みの回数が莫大なものになることを防ぎます。

最小サイズを取得あるいは設定するには、 getMinSize() メソッドおよび setMinSize($newSize) メソッドを使用します。

    $oldMinSize = $memoryManager->getMinSize();  // MinSize をバイト数で取得します
    $memoryManager->setMinSize($newSize);        // MinSize をバイト数で設定します

デフォルト値は 16KB (16384 バイト) です。