<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/reserved.variables.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'reserved.variables.globals.php',
    1 => '$GLOBALS',
    2 => '引用全局作用域中可用的全部变量',
  ),
  'up' => 
  array (
    0 => 'reserved.variables.php',
    1 => '预定义变量',
  ),
  'prev' => 
  array (
    0 => 'language.variables.superglobals.php',
    1 => '超全局变量',
  ),
  'next' => 
  array (
    0 => 'reserved.variables.server.php',
    1 => '$_SERVER',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'language/predefined/variables/globals.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="reserved.variables.globals" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">$GLOBALS</h1>
  <p class="refpurpose"><span class="refname">$GLOBALS</span> &mdash; <span class="dc-title">引用全局作用域中可用的全部变量</span></p>

 </div>
 
 <div class="refsect1 description" id="refsect1-reserved.variables.globals-description">
  <h3 class="title">说明</h3>
  <p class="para">
   关联数组 <span class="type"><a href="language.types.array.php" class="type array">array</a></span>，包含当前脚本内定义成全局范围的所有变量的引用。
   数组的键就是变量的名字。
  </p>
 </div>

 
 <div class="refsect1 examples" id="refsect1-reserved.variables.globals-examples">
  <h3 class="title">示例</h3>
  <p class="para">
   <div class="example" id="variable.globals.basic">
    <p><strong>示例 #1 <var class="varname">$GLOBALS</var> 范例</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">function </span><span style="color: #0000BB">test</span><span style="color: #007700">()<br />{<br />    </span><span style="color: #0000BB">$foo </span><span style="color: #007700">= </span><span style="color: #DD0000">"local variable"</span><span style="color: #007700">;<br /><br />    echo </span><span style="color: #DD0000">'$foo in global scope: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">$GLOBALS</span><span style="color: #007700">[</span><span style="color: #DD0000">"foo"</span><span style="color: #007700">] . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    echo </span><span style="color: #DD0000">'$foo in current scope: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">$foo </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">$foo </span><span style="color: #007700">= </span><span style="color: #DD0000">"Example content"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">test</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>以上示例的输出类似于：</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">$foo in global scope: Example content
$foo in current scope: local variable</pre>
</div>
    </div>
   </div>
  </p>
  <div class="warning"><strong class="warning">警告</strong>
   <p class="para">
    从 PHP 8.1.0 起，不再支持对整个 <var class="varname">$GLOBALS</var> 数组的写访问：
    <div class="example" id="variable.globals.entire_write_error">
     <p><strong>示例 #2 写入整个 <var class="varname">$GLOBALS</var> 将会导致错误。</strong></p>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">// 生成编译时错误：<br /></span><span style="color: #0000BB">$GLOBALS </span><span style="color: #007700">= [];<br /></span><span style="color: #0000BB">$GLOBALS </span><span style="color: #007700">+= [];<br /></span><span style="color: #0000BB">$GLOBALS </span><span style="color: #007700">=&amp; </span><span style="color: #0000BB">$x</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$x </span><span style="color: #007700">=&amp; </span><span style="color: #0000BB">$GLOBALS</span><span style="color: #007700">;<br />unset(</span><span style="color: #0000BB">$GLOBALS</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">array_pop</span><span style="color: #007700">(</span><span style="color: #0000BB">$GLOBALS</span><span style="color: #007700">);<br /></span><span style="color: #FF8000">// ...以及对 $GLOBALS 的任何其他写入/读写操作<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
  </div>
 </div>

 
 <div class="refsect1 notes" id="refsect1-reserved.variables.globals-notes">
  <h3 class="title">注释</h3>
  <blockquote class="note"><p><strong class="note">注意</strong>: <p class="para">“Superglobal”也称为自动化的全局变量。这就表示其在脚本的所有作用域中都是可用的。不需要在函数或方法中用
<strong class="command">global $variable;</strong> 来访问它。</p></p></blockquote>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <strong>变量可用性</strong><br />
   <p class="para">
    与所有其他<a href="language.variables.superglobals.php" class="link">超全局变量</a>不同，<var class="varname">$GLOBALS</var>在PHP中总是可用的。
    </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <p class="para">
     从 PHP 8.1.0 起，<var class="varname">$GLOBALS</var> 现在是全局<a href="features.gc.refcounting-basics.php" class="link">符号表</a>的只读副本。
     也就是说，全局变量不能通过副本进行修改。
     在之前的版本中，<var class="varname">$GLOBALS</var> 数组和 PHP 数组通常传值的行为不一样，全局变量可通过副本修改。
     <div class="informalexample">
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">// PHP 8.1.0 之前<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$globals </span><span style="color: #007700">= </span><span style="color: #0000BB">$GLOBALS</span><span style="color: #007700">; </span><span style="color: #FF8000">// 表面意义的按值复制<br /></span><span style="color: #0000BB">$globals</span><span style="color: #007700">[</span><span style="color: #DD0000">'a'</span><span style="color: #007700">] = </span><span style="color: #0000BB">2</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">); </span><span style="color: #FF8000">// int(2)<br /><br />// 从 PHP 8.1.0 起<br />// 这不再修改 $a。先前的行为违反了按值语义。<br /></span><span style="color: #0000BB">$globals </span><span style="color: #007700">= </span><span style="color: #0000BB">$GLOBALS</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$globals</span><span style="color: #007700">[</span><span style="color: #DD0000">'a'</span><span style="color: #007700">] = </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// 要恢复以前的行为，请迭代其副本并将每个属性分配回 $GLOBALS。<br /></span><span style="color: #007700">foreach (</span><span style="color: #0000BB">$globals </span><span style="color: #007700">as </span><span style="color: #0000BB">$key </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">$value</span><span style="color: #007700">) {<br />    </span><span style="color: #0000BB">$GLOBALS</span><span style="color: #007700">[</span><span style="color: #0000BB">$key</span><span style="color: #007700">] = </span><span style="color: #0000BB">$value</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
  </p></blockquote>
 </div>

 
</div><?php manual_footer($setup); ?>