<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.functions.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'functions.user-defined.php',
    1 => '用户自定义函数',
    2 => '用户自定义函数',
  ),
  'up' => 
  array (
    0 => 'language.functions.php',
    1 => '函数',
  ),
  'prev' => 
  array (
    0 => 'language.functions.php',
    1 => '函数',
  ),
  'next' => 
  array (
    0 => 'functions.arguments.php',
    1 => '函数的参数和参数值',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'language/functions.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="functions.user-defined" class="sect1">
   <h2 class="title">用户自定义函数</h2>

   <p class="para">
    函数的定义是通过使用 <code class="literal">function</code>
    关键字、名称、由逗号（<code class="literal">,</code>）分隔并用圆括号括起来的参数列表（可能为空），后接包含使用大括号括起来的函数主体，例如以下形式：
   </p>
   <div class="example" id="example-1">
    <p><strong>示例 #1 声明名为 <code class="literal">foo</code> 的新函数</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: #007700">function </span><span style="color: #0000BB">foo</span><span style="color: #007700">(</span><span style="color: #0000BB">$arg_1</span><span style="color: #007700">, </span><span style="color: #0000BB">$arg_2</span><span style="color: #007700">, </span><span style="color: #FF8000">/* ..., */ </span><span style="color: #0000BB">$arg_n</span><span style="color: #007700">)<br />{<br />    echo </span><span style="color: #DD0000">"Example function.\n"</span><span style="color: #007700">;<br />    return </span><span style="color: #0000BB">$retval</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <p class="para">
     自 PHP 8.0.0 起，参数列表可以包含尾随逗号：
     <div class="informalexample">
      <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">function </span><span style="color: #0000BB">foo</span><span style="color: #007700">(</span><span style="color: #0000BB">$arg_1</span><span style="color: #007700">, </span><span style="color: #0000BB">$arg_2</span><span style="color: #007700">,) { }<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
      </div>

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

   <p class="simpara">
    任何有效的 PHP 代码都有可能出现在函数主体，甚至包括其它函数和 <a href="language.oop5.basic.php#language.oop5.basic.class" class="link">class</a> 定义。
   </p>
   <p class="para">
    函数名和 PHP 中的其它标识符命名规则相同。有效的函数名以字母或下划线打头，后面跟字母，数字或下划线。可以用正则表达式表示为
    <code class="code">^[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*$</code>。
   </p>
   <div class="tip"><strong class="tip">小技巧</strong><p class="simpara">请参见<a href="userlandnaming.php" class="xref">用户空间命名指南</a>。</p></div>
   <p class="simpara">
    函数无需在调用之前被定义，<em>除非</em>是下面两个例子中函数是有条件被定义时。
   </p>
   <p class="para">
    当一个函数是有条件被定义时，必须在调用函数<em>之前</em>定义。
   </p>
   <p class="para">
    <div class="example" id="example-2">
     <p><strong>示例 #2 有条件的函数</strong></p>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />$makefoo </span><span style="color: #007700">= </span><span style="color: #0000BB">true</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">/* 不能在此处调用foo()函数，<br />   因为它还不存在，但可以调用bar()函数。*/<br /><br /></span><span style="color: #0000BB">bar</span><span style="color: #007700">();<br /><br />if (</span><span style="color: #0000BB">$makefoo</span><span style="color: #007700">) {<br />  function </span><span style="color: #0000BB">foo</span><span style="color: #007700">()<br />  {<br />    echo </span><span style="color: #DD0000">"I don't exist until program execution reaches me.\n"</span><span style="color: #007700">;<br />  }<br />}<br /><br /></span><span style="color: #FF8000">/* 现在可以安全调用函数 foo()<br />   因为 $makefoo 值为真 */<br /><br /></span><span style="color: #007700">if (</span><span style="color: #0000BB">$makefoo</span><span style="color: #007700">) </span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br /><br />function </span><span style="color: #0000BB">bar</span><span style="color: #007700">()<br />{<br />  echo </span><span style="color: #DD0000">"I exist immediately upon program start.\n"</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
   <p class="para">
    <div class="example" id="example-3">
     <p><strong>示例 #3 函数中的函数</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: #007700">function </span><span style="color: #0000BB">foo</span><span style="color: #007700">()<br />{<br />  function </span><span style="color: #0000BB">bar</span><span style="color: #007700">()<br />  {<br />    echo </span><span style="color: #DD0000">"I don't exist until foo() is called.\n"</span><span style="color: #007700">;<br />  }<br />}<br /><br /></span><span style="color: #FF8000">/* 现在还不能调用 bar() 函数，因为它还不存在 */<br /><br /></span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">/* 现在可以调用 bar() 函数了，因为 foo() 函数<br />   的执行使得 bar() 函数变为已定义的函数 */<br /><br /></span><span style="color: #0000BB">bar</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
   <p class="para">
    PHP 中的所有函数和类都具有全局作用域，可以定义在一个函数之内而在之外调用，反之亦然。
   </p>
   <p class="simpara">
    PHP 不支持函数重载，也不可能取消定义或者重定义已声明的函数。
   </p>
   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <span class="simpara">
     从 <code class="literal">A</code> 到 <code class="literal">Z</code>
     的 ASCII 函数名是大小写无关的，不过在调用函数的时候，使用其在定义时相同的形式是个好习惯。
    </span>
   </p></blockquote>
   <p class="simpara">
    函数支持 <a href="functions.arguments.php#functions.variable-arg-list" class="link">可变数量的参数</a> 和
    <a href="functions.arguments.php#functions.arguments.default" class="link">默认参数</a>。参见
    <span class="function"><a href="function.func-num-args.php" class="function">func_num_args()</a></span>、<span class="function"><a href="function.func-get-arg.php" class="function">func_get_arg()</a></span> 和
    <span class="function"><a href="function.func-get-args.php" class="function">func_get_args()</a></span> 的函数参考以获取更多信息。
   </p>

   <p class="para">
    在 PHP 中可以调用递归函数。
    <div class="example" id="example-4">
     <p><strong>示例 #4 递归函数</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: #007700">function </span><span style="color: #0000BB">recursion</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">)<br />{<br />    if (</span><span style="color: #0000BB">$a </span><span style="color: #007700">&lt; </span><span style="color: #0000BB">20</span><span style="color: #007700">) {<br />        echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$a</span><span style="color: #DD0000">\n"</span><span style="color: #007700">;<br />        </span><span style="color: #0000BB">recursion</span><span style="color: #007700">(</span><span style="color: #0000BB">$a </span><span style="color: #007700">+ </span><span style="color: #0000BB">1</span><span style="color: #007700">);<br />    }<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <span class="simpara">
    但是要避免递归函数／方法调用超过 100-200 层，因为可能会使堆栈崩溃从而使当前脚本终止。
    无限递归可视为编程错误。
    </span>
   </p></blockquote>
   </p>

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