mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-18 05:26:57 +08:00
167 lines
9.5 KiB
HTML
167 lines
9.5 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
|
<title>对比两个「PHP 规范化」的版本数字字符串</title>
|
|
</head>
|
|
<body class="docs"><div id="layout">
|
|
<div id="layout-content"><div id="function.version-compare" class="refentry">
|
|
<div class="refnamediv">
|
|
<h1 class="refname">version_compare</h1>
|
|
<p class="verinfo">(PHP 4 >= 4.1.0, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">version_compare</span> — <span class="dc-title">对比两个「PHP 规范化」的版本数字字符串</span></p>
|
|
|
|
</div>
|
|
|
|
<div class="refsect1 description" id="refsect1-function.version-compare-description">
|
|
<h3 class="title">说明</h3>
|
|
<div class="methodsynopsis dc-description">
|
|
<span class="methodname"><strong>version_compare</strong></span>
|
|
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$version1</code></span>
|
|
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$version2</code></span>
|
|
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$operator</code></span>
|
|
] ) : <span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span></div>
|
|
|
|
<p class="para rdfs-comment">
|
|
<span class="function"><strong>version_compare()</strong></span> 用于对比两个「PHP 规范化」的版本数字字符串。
|
|
</p>
|
|
<p class="para">
|
|
此函数首先在版本字符串里用一个点 <em>.</em> 替换 <em>_</em>、<em>-</em> 和 <em>+</em>，也会在任意非数字前后插入一个点 <em>.</em>，这样，类似 '4.3.2RC1' 将会变成 '4.3.2.RC.1'。
|
|
接下来它会分割结果，
|
|
然后它会从左往右对比各个部分。
|
|
如果某部分包含了特定的版本字符串，将会用以下顺序处理：
|
|
<em>列表中未找到的任意字符串</em> <
|
|
<em>dev</em> < <em>alpha</em> =
|
|
<em>a</em> < <em>beta</em> =
|
|
<em>b</em> < <em>RC</em> =
|
|
<em>rc</em> < <em>#</em> <
|
|
<em>pl</em> = <em>p</em>。
|
|
|
|
这种方式不仅能够对比类似 '4.1' 和 '4.1.2' 那种不同的版本级别，同时也可以指定对比任何包含 PHP 开发状态的版本。
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 parameters" id="refsect1-function.version-compare-parameters">
|
|
<h3 class="title">参数</h3>
|
|
<p class="para">
|
|
<dl>
|
|
|
|
|
|
<dt>
|
|
<code class="parameter">version1</code></dt>
|
|
|
|
<dd>
|
|
|
|
<p class="para">
|
|
第一个版本数。
|
|
</p>
|
|
</dd>
|
|
|
|
|
|
|
|
<dt>
|
|
<code class="parameter">version2</code></dt>
|
|
|
|
<dd>
|
|
|
|
<p class="para">
|
|
第二个版本数。
|
|
</p>
|
|
</dd>
|
|
|
|
|
|
|
|
<dt>
|
|
<code class="parameter">operator</code></dt>
|
|
|
|
<dd>
|
|
|
|
<p class="para">
|
|
如果你指定了可选的第三个参数 <code class="parameter">operator</code>，你可以测试两者的特定关系。
|
|
可以的操作符分别是：<em><</em>、
|
|
<em>lt</em>、<em><=</em>、
|
|
<em>le</em>、<em>></em>、
|
|
<em>gt</em>、<em>>=</em>、
|
|
<em>ge</em>、<em>==</em>、
|
|
<em>=</em>、<em>eq</em>、
|
|
<em>!=</em>、<em><></em> 和
|
|
<em>ne</em>。
|
|
</p>
|
|
<p class="para">
|
|
此参数区分大小写，它的值应该是小写的。
|
|
</p>
|
|
</dd>
|
|
|
|
|
|
</dl>
|
|
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 returnvalues" id="refsect1-function.version-compare-returnvalues">
|
|
<h3 class="title">返回值</h3>
|
|
<p class="para">
|
|
|
|
默认情况下，在第一个版本低于第二个时，<span class="function"><strong>version_compare()</strong></span> 返回 <em>-1</em>；如果两者相等，返回 <em>0</em>；第二个版本更低时则返回 <em>1</em>。
|
|
</p>
|
|
<p class="para">
|
|
当使用了可选参数 <code class="parameter">operator</code> 时，如果关系是操作符所指定的那个，函数将返回 <strong><code>TRUE</code></strong>，否则返回 <strong><code>FALSE</code></strong>。
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 examples" id="refsect1-function.version-compare-examples">
|
|
<h3 class="title">范例</h3>
|
|
<p class="para">
|
|
下例使用了 <strong><code>PHP_VERSION</code></strong> 常量，因为它执行的代码包含了 PHP 版本的值。
|
|
</p>
|
|
<p class="para">
|
|
<div class="example" id="example-536">
|
|
<p><strong>Example #1 <span class="function"><strong>version_compare()</strong></span> examples</strong></p>
|
|
<div class="example-contents">
|
|
<div class="phpcode"><pre><span style="color: #000000">
|
|
<span style="color: #0000BB"><?php<br /></span><span style="color: #007700">if (</span><span style="color: #0000BB">version_compare</span><span style="color: #007700">(</span><span style="color: #0000BB">PHP_VERSION</span><span style="color: #007700">, </span><span style="color: #DD0000">'7.0.0'</span><span style="color: #007700">) >= </span><span style="color: #0000BB">0</span><span style="color: #007700">) {<br /> echo </span><span style="color: #DD0000">'I am at least PHP version 7.0.0, my version: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">PHP_VERSION </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /><br />if (</span><span style="color: #0000BB">version_compare</span><span style="color: #007700">(</span><span style="color: #0000BB">PHP_VERSION</span><span style="color: #007700">, </span><span style="color: #DD0000">'5.3.0'</span><span style="color: #007700">) >= </span><span style="color: #0000BB">0</span><span style="color: #007700">) {<br /> echo </span><span style="color: #DD0000">'I am at least PHP version 5.3.0, my version: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">PHP_VERSION </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /><br />if (</span><span style="color: #0000BB">version_compare</span><span style="color: #007700">(</span><span style="color: #0000BB">PHP_VERSION</span><span style="color: #007700">, </span><span style="color: #DD0000">'5.0.0'</span><span style="color: #007700">, </span><span style="color: #DD0000">'>='</span><span style="color: #007700">)) {<br /> echo </span><span style="color: #DD0000">'I am at least PHP version 5.0.0, my version: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">PHP_VERSION </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /><br />if (</span><span style="color: #0000BB">version_compare</span><span style="color: #007700">(</span><span style="color: #0000BB">PHP_VERSION</span><span style="color: #007700">, </span><span style="color: #DD0000">'5.0.0'</span><span style="color: #007700">, </span><span style="color: #DD0000">'<'</span><span style="color: #007700">)) {<br /> echo </span><span style="color: #DD0000">'I am still PHP 4, my version: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">PHP_VERSION </span><span style="color: #007700">. </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
|
|
</span>
|
|
</pre></div>
|
|
</div>
|
|
|
|
</div>
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 notes" id="refsect1-function.version-compare-notes">
|
|
<h3 class="title">注释</h3>
|
|
<blockquote class="note"><p><strong class="note">Note</strong>:
|
|
<p class="para">
|
|
<strong><code>PHP_VERSION</code></strong> 常量包含了当前 PHP 的版本。
|
|
</p>
|
|
</p></blockquote>
|
|
<blockquote class="note"><p><strong class="note">Note</strong>:
|
|
<p class="para">
|
|
注意，类似 5.3.0-dev 的预发行版本，被认为是低于它们的最终发行版本（就像 5.3.0）。
|
|
</p>
|
|
</p></blockquote>
|
|
<blockquote class="note"><p><strong class="note">Note</strong>:
|
|
<p class="para">
|
|
指定类似 <em>alpha</em>、<em>beta</em> 的版本字符串是大小写敏感的。
|
|
版本字符串的来源若不遵循 PHP 标准，可能需要在调用 <span class="function"><strong>version_compare()</strong></span> 之前先用 <span class="function"><a href="strtolower.html" class="function">strtolower()</a></span> 转成小写。
|
|
</p>
|
|
</p></blockquote>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 seealso" id="refsect1-function.version-compare-seealso">
|
|
<h3 class="title">参见</h3>
|
|
<p class="para">
|
|
<ul class="simplelist">
|
|
<li class="member"><span class="function"><a href="phpversion.html" class="function" rel="rdfs-seeAlso">phpversion()</a> - 获取当前的PHP版本</span></li>
|
|
<li class="member"><span class="function"><a href="php_uname.html" class="function" rel="rdfs-seeAlso">php_uname()</a> - 返回运行 PHP 的系统的有关信息</span></li>
|
|
<li class="member"><span class="function"><a href="function_exists.html" class="function" rel="rdfs-seeAlso">function_exists()</a> - 如果给定的函数已经被定义就返回 TRUE</span></li>
|
|
</ul>
|
|
</p>
|
|
</div>
|
|
|
|
|
|
</div></div></div></body></html> |