(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
version_compare — Сравнивает две "стандартизованные" строки с номером версии PHP
$version1
, string $version2
, ?string $operator
= null
): int|boolversion_compare() сравнивает две "PHP-стандартизованные" строки с номерами версий.
Функция сначала заменяет _
, -
и
+
на точку .
в строках версий, а
также добавляет точки .
перед и после каждого символа, не
являющегося числом. Например, '4.3.2RC1' преобразуется в '4.3.2.RC.1'. После этого
сравнивает части строк слева направо. Если часть строки содержит специальные
символы версий, они обрабатываются следующим образом:
любая строка, не найденная в этом списке
<
dev
< alpha
=
a
< beta
=
b
< RC
=
rc
< #
<
pl
= p
. Таким образом можно сравнивать
не только версии разных уровней, вроде '4.1' и '4.1.2', но и специфичные
версии, включающие статус разработки.
version1
Номер первой версии.
version2
Номер второй версии.
operator
Необязательный параметр operator
.
Возможные значения:
<
,
lt
, <=
,
le
, >
,
gt
, >=
,
ge
, ==
,
=
, eq
,
!=
, <>
,
ne
.
Аргумент чувствителен к регистру, поэтому значения должны быть в нижнем регистре.
По умолчанию функция version_compare() возвращает
-1
, если первая версия меньше второй;
0
, когда они равны;
1
, если вторая меньше первой.
При использовании аргумента operator
функция
вернёт true
, если выражение в соответствии с оператором верно, и
false
в противном случае.
В примере ниже используется константа PHP_VERSION
,
она содержит номер версии PHP, который выполняет код.
Пример #1 Пример использования version_compare()
<?php
if (version_compare(PHP_VERSION, '7.0.0') >= 0) {
echo 'Я использую PHP версии не ниже 7.0.0, моя версия: ' . PHP_VERSION . "\n";
}
if (version_compare(PHP_VERSION, '5.3.0') >= 0) {
echo 'Я использую PHP версии не ниже 5.3.0, моя версия: ' . PHP_VERSION . "\n";
}
if (version_compare(PHP_VERSION, '5.0.0', '>=')) {
echo 'Я использую PHP 5.0.0 или выше, моя версия: ' . PHP_VERSION . "\n";
}
if (version_compare(PHP_VERSION, '5.0.0', '<')) {
echo 'Я до сих пор использую PHP 4, моя версия: ' . PHP_VERSION . "\n";
}
?>
Замечание:
Константа
PHP_VERSION
хранит номер текущей версии PHP.
Замечание:
Заметьте, что дорелизные версии, такие как 5.3.0-dev, считаются меньше, чем финальные (вида 5.3.0).
Замечание:
Специальные слова вроде
alpha
иbeta
чувствительны к регистру. Строки версий, не придерживающиеся PHP-стандарта, нужно приводить к нижнему регистру функцией strtolower() до вызова version_compare().