Как заблокировать обновление моего решения, если например: версия PHP ниже?

Question

[Сергей]

Как правильно заблокировать своё обновление, чтобы пользователь не смог обновиться если битрикс или php версия не соответствует минимальным требованиям?

Answer 1

[Ge1i0N]

Нужно добавить в updater.php модуля код проверки версии того, что нужно.
Например, для проверки версии php:

$isLowPhpVersion = version_compare(phpversion(), '8.0.0', '<');
if ($isLowPhpVersion) {
    $errorMessage = 'Module require php 8.0 or higher.';
    return false;
}

Важно учесть, что updater.php не позволяет работать со строками локализации, текст ошибки нужно спразу писать на том языке, который нужен.

Также, нужно иметь в виду, что модуль может не только быть обновлен до нужной версии, но сразу скачан последней версии - нужно также вставить проверку при установке модуля, например добавив что-то такое в DoInstall в install.php модуля:

global $APPLICATION;
\Bitrix\Main\Localization\Loc::loadMessages(__FILE__);

$isLowPhpVersion = version_compare(phpversion(), '8.0.0', '<');
if ($isLowPhpVersion) {
    $APPLICATION->ThrowException(\Bitrix\Main\Localization\Loc::getMessage('CHECK_PHP_VERSION_ERROR'));
    return false;
}

Comments

[Сергей]

Благодарю.
DoInstall - знаю. Но не смог найти пример по переменной $errorMessage.

[Ge1i0N]

Сергей Зверев, документация по обновлениям несколько запутана и не полная, но в целом по ссылке что привёл - основное написано.
Также имейте в виду - там есть информация про version_control.txt. Этот механизм не работает таким образом как там написано полагаться на него не стоит, и в целом можно не использовать.

[Сергей]

Ge1i0N, Хорошо, учту.