(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
version_compare — 對比兩個「PHP 規(guī)范化」的版本數(shù)字字符串
version_compare() 用于對比兩個「PHP 規(guī)范化」的版本數(shù)字字符串。
此函數(shù)首先在版本字符串里用一個點 .
替換 _
、-
和 +
,也會在任意非數(shù)字前后插入一個點 .
,這樣,類似 '4.3.2RC1' 將會變成 '4.3.2.RC.1'。
接下來它會分割結(jié)果,
然后它會從左往右對比各個部分。
如果某部分包含了特定的版本字符串,將會用以下順序處理:
列表中未找到的任意字符串
<
dev
< alpha
=
a
< beta
=
b
< RC
=
rc
< #
<
pl
= p
。
這種方式不僅能夠?qū)Ρ阮愃?'4.1' 和 '4.1.2' 那種不同的版本級別,同時也可以指定對比任何包含 PHP 開發(fā)狀態(tài)的版本。
version1
第一個版本數(shù)。
version2
第二個版本數(shù)。
operator
如果你指定了可選的第三個參數(shù) operator
,你可以測試兩者的特定關(guān)系。
可以的操作符分別是:<
、
lt
、<=
、
le
、>
、
gt
、>=
、
ge
、==
、
=
、eq
、
!=
、<>
和
ne
。
此參數(shù)區(qū)分大小寫,它的值應(yīng)該是小寫的。
默認情況下,在第一個版本低于第二個時,version_compare() 返回 -1
;如果兩者相等,返回 0
;第二個版本更低時則返回 1
。
當使用了可選參數(shù) operator
時,如果關(guān)系是操作符所指定的那個,函數(shù)將返回 true
,否則返回 false
。
下例使用了 PHP_VERSION
常量,因為它執(zhí)行的代碼包含了 PHP 版本的值。
示例 #1 version_compare() examples
<?php
if (version_compare(PHP_VERSION, '7.0.0') >= 0) {
echo 'I am at least PHP version 7.0.0, my version: ' . PHP_VERSION . "\n";
}
if (version_compare(PHP_VERSION, '5.3.0') >= 0) {
echo 'I am at least PHP version 5.3.0, my version: ' . PHP_VERSION . "\n";
}
if (version_compare(PHP_VERSION, '5.0.0', '>=')) {
echo 'I am at least PHP version 5.0.0, my version: ' . PHP_VERSION . "\n";
}
if (version_compare(PHP_VERSION, '5.0.0', '<')) {
echo 'I am still PHP 4, my version: ' . PHP_VERSION . "\n";
}
?>
注意:
PHP_VERSION
常量包含了當前 PHP 的版本。
注意:
注意,類似 5.3.0-dev 的預(yù)發(fā)行版本,被認為是低于它們的最終發(fā)行版本(就像 5.3.0)。
注意:
指定類似
alpha
、beta
的版本字符串是大小寫敏感的。 版本字符串的來源若不遵循 PHP 標準,可能需要在調(diào)用 version_compare() 之前先用 strtolower() 轉(zhuǎn)成小寫。