is_php_version_compatible()
Порівнює передану версію PHP із версією PHP, встановленою на сервері.
Працює з урахуванням функції version_compare() з умовою >=
.
Дивіться також аналогічне порівняння WP: is_wp_version_compatible() .
Основа для:
validate_plugin_requirements()
validate_plugin_requirements()
1 раз – 0.000001 сек
(швидкість світла) | 50000 разів – 0.02 сек
(швидкість світла) |
PHP 7.2.16, WP 5.2
(швидкість світла) | 50000 разів – 0.02 сек
(швидкість світла) |
PHP 7.2.16, WP 5.2
Хуків немає.
Повертає
true|false
. True – вказана версія PHP сумісна або версія для перевірки сумісності не вказана ( ”, false тощо). false – вказана версія не сумісна.
Використання
is_php_version_compatible( $required );
-
$required
(рядок) (обов’язковий) - Мінімальна необхідна версія PHP.
Приклади
#1 Приклади результатів перевірки
phpversion(); // 7.2.10 is_php_version_compatible( '5' ); // true is_php_version_compatible( '5.3.0-dev'); // true is_php_version_compatible( '5.6' ); // true is_php_version_compatible( '5.6.11'); // true is_php_version_compatible( '7' ); // true is_php_version_compatible( '7.2' ); // true is_php_version_compatible( '7.2.09'); // true is_php_version_compatible( '7.2.10' ); // true is_php_version_compatible( '7.2.11' ); // false is_php_version_compatible( '7.2.12' ); // false is_php_version_compatible( '7.3' ); // false is_php_version_compatible( '8'); // false
#2 Виведемо повідомлення про застарілу версію PHP
Нехай ми написали плагін, який буде працювати тільки на PHP v7 та вище. Тоді треба передбачити, щоб основний код плагіна не запускався, якщо версія на сервері користувача нижче за потрібну.
Допустимо на сервері користувача встановлений PHP 5.6.11, тоді:
if ( is_php_version_compatible( '7.0.0' ) ) { require_once __DIR__ . '/main-file-plugin.php'; } else { add_action( 'admin_notices', 'admin_php_version__error' ); } function admin_php_version__error() { ?> <div class="notice notice-error"> <p>Ви використовуєте стару версію PHP. Попросіть адміністратора сервера оновити її!</p> </div> <?php }
Код вище неповний і показує лише принцип того, як має працювати повідомлення.
список змін
З версії 5.2.0 | Введено. |
Код is_php_version_compatible() is php version compatible WP 6.0.2
function is_php_version_compatible( $required ) { return empty( $required ) || version_compare( phpversion(), $required, '>=' ); }