documentation/manual/ja/module_specs/Zend_Memory-Overview.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20827 -->
   4 <sect1 id="zend.memory.overview">
   5     <title>概要</title>
   6
   7     <sect2 id="zend.memory.introduction">
   8         <title>導入</title>
   9
  10         <para>
  11             <classname>Zend_Memory</classname> コンポーネントは、
  12             限られたメモリ環境でデータを管理するためのものです。
  13         </para>
  14
  15         <para>
  16             メモリマネージャが要求に応じて
  17             メモリオブジェクト (メモリコンテナ)
  18             を作成し、必要に応じて透過的にスワップ/読み込みを行います。
  19         </para>
  20
  21         <para>
  22             たとえば、あるオブジェクトを作成あるいは読み込むことによって
  23             メモリの使用量が制限値を超えてしまう場合に、
  24             管理しているオブジェクトのいくつかをメモリの外部の
  25             キャッシュにコピーします。
  26             このようにして、管理しているオブジェクトのメモリ使用量が
  27             制限値を超えないようにします。
  28         </para>
  29
  30         <para>
  31             メモリマネージャの保存機能は、
  32             <link linkend="zend.cache.backends">Zend_Cache バックエンド</link>
  33             を使用しています。
  34         </para>
  35
  36         <example id="zend.memory.introduction.example-1">
  37             <title>Zend_Memory コンポーネントの使用法</title>
  38
  39             <para>
  40                 <methodname>Zend_Memory::factory()</methodname> は、
  41                 指定したバックエンドオプションでメモリマネージャオブジェクトの
  42                 インスタンスを作成します。
  43             </para>
  44                 <programlisting language="php"><![CDATA[
  45 $backendOptions = array(
  46     'cache_dir' => './tmp/' // スワップしたメモリブロックを配置するディレクトリ
  47 );
  48
  49 $memoryManager = Zend_Memory::factory('File', $backendOptions);
  50
  51 $loadedFiles = array();
  52
  53 for ($count = 0; $count < 10000; $count++) {
  54     $f = fopen($fileNames[$count], 'rb');
  55     $data = fread($f, filesize($fileNames[$count]));
  56     $fclose($f);
  57
  58     $loadedFiles[] = $memoryManager->create($data);
  59 }
  60
  61 echo $loadedFiles[$index1]->value;
  62
  63 $loadedFiles[$index2]->value = $newValue;
  64
  65 $loadedFiles[$index3]->value[$charIndex] = '_';
  66 ]]></programlisting>
  67         </example>
  68     </sect2>
  69
  70     <sect2 id="zend.memory.theory-of-operation">
  71
  72         <title>動作原理</title>
  73
  74         <para>
  75             <classname>Zend_Memory</classname> コンポーネントは、以下の概念で構成されています。
  76
  77             <itemizedlist>
  78                 <listitem>
  79                     <para>メモリマネージャ</para>
  80                 </listitem>
  81
  82                 <listitem>
  83                     <para>メモリコンテナ</para>
  84                 </listitem>
  85
  86                 <listitem>
  87                     <para>ロックされたメモリオブジェクト</para>
  88                 </listitem>
  89
  90                 <listitem>
  91                     <para>移動可能なメモリオブジェクト</para>
  92                 </listitem>
  93             </itemizedlist>
  94         </para>
  95
  96         <sect3 id="zend.memory.theory-of-operation.manager">
  97
  98             <title>メモリマネージャ</title>
  99
 100             <para>
 101                 メモリマネージャは、アプリケーションからの要求に応じて
 102                 (ロックされた、あるいは移動可能な) メモリオブジェクトを作成し、
 103                 それをメモリコンテナオブジェクトにラッピングしたものを返します。
 104             </para>
 105
 106         </sect3>
 107
 108         <sect3 id="zend.memory.theory-of-operation.container">
 109
 110             <title>メモリコンテナ</title>
 111
 112             <para>
 113                 メモリコンテナは、文字列型の属性 <code>value</code> を
 114                 (仮想的に、あるいは実際に) 保持します。
 115                 この属性には、メモリオブジェクトの作成時に指定された値が含まれます。
 116             </para>
 117
 118             <para>
 119                 この属性 <code>value</code> は、オブジェクトのプロパティとして扱うことができます。
 120
 121                 <programlisting language="php"><![CDATA[
 122 $memObject = $memoryManager->create($data);
 123
 124 echo $memObject->value;
 125
 126 $memObject->value = $newValue;
 127
 128 $memObject->value[$index] = '_';
 129
 130 echo ord($memObject->value[$index1]);
 131
 132 $memObject->value = substr($memObject->value, $start, $length);
 133 ]]></programlisting>
 134             </para>
 135
 136             <note>
 137                 <para>
 138                     5.2 より前のバージョンの <acronym>PHP</acronym> を使用している場合は、
 139                     value プロパティに直接アクセスするのではなく
 140                     <link linkend="zend.memory.memory-objects.api.getRef">getRef()</link>
 141                     メソッドを使用します。
 142                 </para>
 143             </note>
 144
 145         </sect3>
 146
 147         <sect3 id="zend.memory.theory-of-operation.locked">
 148
 149             <title>ロックされたメモリ</title>
 150
 151             <para>
 152                 ロックされたメモリオブジェクトは、常にメモリ内に保持されます。
 153                 ロックされたメモリに保存されたデータは、
 154                 決してキャッシュにスワップされることはありません。
 155             </para>
 156
 157         </sect3>
 158
 159         <sect3 id="zend.memory.theory-of-operation.movable">
 160
 161             <title>移動可能なメモリ</title>
 162
 163             <para>
 164                 移動可能なメモリオブジェクトは、
 165                 必要に応じて <classname>Zend_Memory</classname> がキャッシュにスワップしたり
 166                 キャッシュから読み戻したりします。この処理は透過的に行われます。
 167             </para>
 168
 169             <para>
 170                 メモリマネージャは、指定した最小値より小さいサイズのオブジェクトはスワップしません。
 171                 これは、パフォーマンスを考慮した判断です。詳細は
 172                 <xref linkend="zend.memory.memory-manager.settings.min-size" />
 173                 を参照ください。
 174             </para>
 175
 176         </sect3>
 177
 178     </sect2>
 179
 180 </sect1>