<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.info.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'function.phpversion.php',
    1 => 'phpversion',
    2 => '获取当前的PHP版本',
  ),
  'up' => 
  array (
    0 => 'ref.info.php',
    1 => 'PHP 选项/信息 函数',
  ),
  'prev' => 
  array (
    0 => 'function.phpinfo.php',
    1 => 'phpinfo',
  ),
  'next' => 
  array (
    0 => 'function.putenv.php',
    1 => 'putenv',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/info/functions/phpversion.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.phpversion" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">phpversion</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">phpversion</span> &mdash; <span class="dc-title">获取当前的PHP版本</span></p>

 </div>
 
 <div class="refsect1 description" id="refsect1-function.phpversion-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>phpversion</strong></span>(<span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.string.php" class="type string">string</a></span></span> <code class="parameter">$extension</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>): <span class="type"><span class="type"><a href="language.types.string.php" class="type string">string</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="para rdfs-comment">
   返回了包含当前运行 PHP 解释器或扩展版本信息的 string。
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.phpversion-parameters">
  <h3 class="title">参数</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">extension</code></dt>
     <dd>
      <p class="para">
       可选的扩展名。
      </p>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.phpversion-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   以 <span class="type"><a href="language.types.string.php" class="type string">string</a></span> 形式返回当前 PHP 版本。如果为 <code class="parameter">extension</code>
   提供了 <span class="type"><a href="language.types.string.php" class="type string">string</a></span> 类型的参数，<span class="function"><strong>phpversion()</strong></span> 
   会返回该扩展的版本。如果没有对应的版本信息，或者该扩展未启用，则返回 <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.phpversion-changelog">
  <h3 class="title">更新日志</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>版本</th>
      <th>说明</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.0.0</td>
      <td>
       <code class="parameter">extension</code> 现在可为 null。
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 examples" id="refsect1-function.phpversion-examples">
  <h3 class="title">示例</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>示例 #1 <span class="function"><strong>phpversion()</strong></span> 示例</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">// 打印 'Current PHP version: 8.3.12'<br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">'Current PHP version: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">phpversion</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">// 打印 '2.0'，如果扩展未启用则不输出<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">phpversion</span><span style="color: #007700">(</span><span style="color: #DD0000">'tidy'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   <div class="example" id="example-2">
    <p><strong>示例 #2 <strong><code><a href="reserved.constants.php#constant.php-version-id">PHP_VERSION_ID</a></code></strong> 示例和用法</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: #FF8000">/**<br /> * PHP_VERSION_ID 定义为一个数字，PHP 版本越高，数字越大。<br /> * 使用下列表达式定义<br /> *<br /> * $version_id = $major_version * 10000 + $minor_version * 100 + $release_version;<br /> *<br /> * 现在可以通过 PHP_VERSION_ID 来检查 PHP 版本，<br /> * 而不用每次都必须用 version_compare() 来检查 PHP 是否支持某个功能。<br /> *<br /> * 比如，可以在此定义一系列 PHP_*_VERSION 常量，<br /> * 而在 5.2.7 之前的版本并没有定义。<br /> */<br /><br /></span><span style="color: #007700">if (</span><span style="color: #0000BB">PHP_VERSION_ID </span><span style="color: #007700">&lt; </span><span style="color: #0000BB">50207</span><span style="color: #007700">) {<br />    </span><span style="color: #0000BB">define</span><span style="color: #007700">(</span><span style="color: #DD0000">'PHP_MAJOR_VERSION'</span><span style="color: #007700">,   </span><span style="color: #0000BB">$version</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">]);<br />    </span><span style="color: #0000BB">define</span><span style="color: #007700">(</span><span style="color: #DD0000">'PHP_MINOR_VERSION'</span><span style="color: #007700">,   </span><span style="color: #0000BB">$version</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]);<br />    </span><span style="color: #0000BB">define</span><span style="color: #007700">(</span><span style="color: #DD0000">'PHP_RELEASE_VERSION'</span><span style="color: #007700">, </span><span style="color: #0000BB">$version</span><span style="color: #007700">[</span><span style="color: #0000BB">2</span><span style="color: #007700">]);<br /><br />    </span><span style="color: #FF8000">// 等等， ...<br /></span><span style="color: #007700">}<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

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


 <div class="refsect1 notes" id="refsect1-function.phpversion-notes">
  <h3 class="title">注释</h3>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <p class="para">
    这些信息也存在于预定义常量 <strong><code><a href="reserved.constants.php#constant.php-version">PHP_VERSION</a></code></strong> 里。更多版本的信息可以使用常量
    <strong><code><a href="info.constants.php#constant.php-windows-version-major">PHP_<span class="replaceable">*</span>_VERSION</a></code></strong>。
   </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <p class="para">
    许多扩展可能会定义它们自己的版本号。然而，大多数捆绑版本将会使用 PHP 版本作为他们的版本号。
   </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <p class="para">
    一些扩展可能会定义他们自己的版本号。
    然而，大多数内置的扩展会使用 PHP 版本作为它们的版本号。
   </p>
  </p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.phpversion-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li><a href="reserved.constants.php#reserved.constants.core" class="link">常量 PHP_VERSION</a></li>
    <li><span class="function"><a href="function.version-compare.php" class="function" rel="rdfs-seeAlso">version_compare()</a> - 对比两个「PHP 规范化」的版本数字字符串</span></li>
    <li><span class="function"><a href="function.phpinfo.php" class="function" rel="rdfs-seeAlso">phpinfo()</a> - 输出关于 PHP 配置的信息</span></li>
    <li><span class="function"><a href="function.phpcredits.php" class="function" rel="rdfs-seeAlso">phpcredits()</a> - 打印 PHP 贡献者名单</span></li>
    <li><span class="function"><a href="function.zend-version.php" class="function" rel="rdfs-seeAlso">zend_version()</a> - 获取当前 Zend 引擎的版本</span></li>
   </ul>
  </p>
 </div>


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