<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/features.gc.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'features.gc.collecting-cycles.php',
    1 => '循環の収集',
    2 => '循環の収集',
  ),
  'up' => 
  array (
    0 => 'features.gc.php',
    1 => 'ガベージコレクション',
  ),
  'prev' => 
  array (
    0 => 'features.gc.refcounting-basics.php',
    1 => 'リファレンスカウントの原理',
  ),
  'next' => 
  array (
    0 => 'features.gc.performance-considerations.php',
    1 => 'パフォーマンスの考慮点',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'features/gc.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="features.gc.collecting-cycles" class="sect1">
   <h2 class="title">循環の収集</h2>
   <p class="para">
    伝統的に、PHP で以前使われていたようなリファレンスカウント記憶機構では、
    循環参照メモリ・リークに対処できません。
    しかしながら、5.3.0 現在、PHP ではその問題に焦点を当てた
    <a href="https://pages.cs.wisc.edu/~cymen/misc/interests/Bacon01Concurrent.pdf" class="link external">&raquo;&nbsp;Concurrent Cycle Collection in Reference Counted Systems</a>
    レポートに由来する同期アルゴリズムを実装しています。
   </p>
   <p class="para">
    アルゴリズムの動作方法の詳しい説明についてはこのセクションで扱う範囲を超えるので、
    ここではその基本を説明します。
    まず第一に、いくつかの基本原則を確立しなければなりません。
    refcount が増やされたら、それはまだ使用中で、従ってゴミではありません。
    refcount が減少して、ゼロに達したら、zvalは解放可能です。
    refcount 引数がゼロ以外の値に減少する場合、これは、ガベージサイクルを作成できる
    だけであることを意味します。
    第２に、ガベージサイクルで、それらの refcount を減少させられるかどうかチェックし、
    それからzval のうちいずれがゼロの refcount を持つか調べることによって、どの部分がゴミか発見できます。
   </p>
   <p class="para">
     <div class="mediaobject">
      
      <div class="imageobject">
       <img src="images/12f37b1c6963c1c5c18f30495416a197-gc-algorithm.png" alt="ガベージコレクションのアルゴリズム" width="614" height="814" />
      </div>
     </div>
   </p>
   <p class="para">
    refcount の減少が起こりうるたびにガベージ・サイクルのチェックを呼び出さなくても良いように、
    代わりに、可能性があるルート (zvals) 全てをアルゴリズムはルート・バッファにたくわえます。
    （それらは「紫」とマークされます)
    それは、可能性のあるガベージのルートそれぞれがバッファ内で一度だけで終わることも確認します。
    ルート・バッファが満杯の場合だけ、内部のそれぞれの zval 全てに対して収集機構が動き出します。
    上図のステップ A をご覧ください。
   </p>
   <p class="para">
    ステップ B では、見つけた各 zval の refcount を一つ減じるために、
    可能性があるルート全てに対してアルゴリズムが深さ優先探索を実行します。
    それは、同一の zval に対して refcount を２回減じていないことを確保します。
    (それらを「灰色」とマークすることにより)
    工程 C では、それぞれのルート・ノードからアルゴリズムが再び深さ優先探索を実行します。
    それは各 zval の refcount を再度チェックするためです。
    refcount がゼロと分かった場合、zval は「白」（図では青色です）とマークされます。
    もしそれが正の数なら、それは、指し示すところからの深さ優先探索により refcount の減少を一つ戻します。
    そしてそれらは再び「黒」とマークされます。
    最後の工程 (D) では、アルゴリズムはルート・バッファを走査してそこから zval ルートを除去します。
    そしてその一方で zval が前の工程で「白」とマークされていたかどうかをチェックします。
    「白」としてマークされた zval が全て解放されます。
   </p>
   <p class="para">
    アルゴリズムが動作する方法の基礎を理解したので、
    これと PHP を統合する方法を振り返りましょう。
    デフォルトで、PHP のガベージコレクタは有効です。
    しかしながら、これを変更できる <var class="filename">php.ini</var> の設定があります。
    それが <a href="info.configuration.php#ini.zend.enable-gc" class="link">zend.enable_gc</a> です。
   </p>
   <p class="para">
    ガベージコレクタがオンの場合、
    ルート・バッファが満杯になるといつでも、先に述べたように循環検出法が実行されます。
    ルート・バッファでは、可能性があるルートのサイズが10000件に固定されています。
    （PHP のソースコードの <code class="literal">Zend/zend_gc.c</code> で
    <strong><code>GC_THRESHOLD_DEFAULT</code></strong> 定数を変更して、PHP を再コンパイルすると変更できます）
    ガベージコレクタをオフにすると、循環検出法は実行されなくなります。
    しかしながら、可能性があるルートはルート・バッファに常に記録されます。
    ガベージコレクション機構がこの構成設定値で起動したかどうかは問題ではありません。
   </p>
   <p class="para">
    ガベージコレクション機構がオフの時に、可能性があるルートでルート・バッファが満杯になると、
    可能性があるルートは単にそれ以上記録されません。
    記録されないそれらの可能性があるルートは、アルゴリズムによって決して分析されません。
    もしそれらが循環参照サイクルの要素ならば、
    それらは決してクリーンアップされないで、メモリリークを生み出します。
   </p>
   <p class="para">
    たとえ機構が無効だとしても、可能性があるルートが記録される理由は、
    可能性があるルートが見つかるたびに機構がオンかどうかチェックしなければいけないよりも、
    可能性があるルートを記録するほうが速いからです。
    しかしながら、ガベージコレクションと分析機構そのものにかなりの時間がかかることがあります。
   </p>
   <p class="para">
    <a href="info.configuration.php#ini.zend.enable-gc" class="link">zend.enable_gc</a> 構成設定値を変える他に、
    <span class="function"><a href="function.gc-enable.php" class="function">gc_enable()</a></span> や <span class="function"><a href="function.gc-disable.php" class="function">gc_disable()</a></span> をそれぞれ呼ぶことでも、
    ガベージコレクション機構をオン／オフできます。
    それらの機能を呼ぶことと、構成設定値で機構をオン／オフすることには同じ影響があります。
    たとえ可能性があるルートのバッファがまだ満杯でなくても、
    循環の収集を強制することもできます。
    このために、<span class="function"><a href="function.gc-collect-cycles.php" class="function">gc_collect_cycles()</a></span> 関数を使用できます。
    この関数は、アルゴリズムによって収集された循環の数を返します。
   </p>
   <p class="para">
    機構をオン／オフしたり、循環の収集を開始する機能の後ろ盾になる根拠は、
    アプリケーションの一部分は非常に時間に敏感な可能性があることです。
    それらの場合、ガベージコレクション機構が有効にならないほうが良いかもしれません。
    もちろん、アプリケーションのある種の部分では、ガベージコレクションをオフにすることにより、
    メモリリークを引き起こす危険があります。
    なぜなら可能性があるルートの一部は有限のルート・バッファに収まらないかもしれないからです。
    従って、ルート･バッファにすでに記録された、可能性があるルートを通じて失われる可能性のあるメモリを解放するために、
    <span class="function"><a href="function.gc-disable.php" class="function">gc_disable()</a></span> を呼ぶ直前に <span class="function"><a href="function.gc-collect-cycles.php" class="function">gc_collect_cycles()</a></span>
    を呼ぶことは多分賢いでしょう。
    そうすると、循環収集機構がオフの間、
    可能性があるルートを保管するためのより多くの空間のための空のバッファが残ります。
   </p>
  </div><?php manual_footer($setup); ?>