Bitrix安装故障求助：PHP版本适配与random.php代码修改需求

一、PHP 7.4及以下版本重装时「无效许可证」问题解决 #

• 清理残留许可证缓存：删除网站根目录/bitrix/.settings.php中所有和license相关的配置节点；手动清空/bitrix/cache/和/bitrix/managed_cache/目录下的所有文件。
• 临时禁用许可证缓存：新建或编辑/bitrix/php_interface/dbconn.php，添加一行define("BX_LICENSE_CACHE_DISABLE", true);，完成安装后再删除这行代码。
• 重置服务器缓存：Linux服务器执行命令rm -rf /bitrix/cache/* /bitrix/managed_cache/*，Windows直接手动删除对应目录文件。

二、PHP 8.0及以上版本内存耗尽错误（random.php第117行）解决 #

这个问题是旧版Bitrix的random.php适配PHP8+时存在逻辑缺陷，导致无限占用内存，调高memory_limit无效，直接修改文件即可：

1. 找到文件/bitrix/modules/main/classes/general/random.php
2. 定位到getBytes方法，替换为以下代码：

public static function getBytes(int $length): string
{
    if ($length <= 0) {
        return '';
    }
    return random_bytes($length);
}

3. 保存后重启PHP服务（比如Linux下执行systemctl restart php-fpm，根据你的服务器环境调整）
4. 额外建议：如果是极旧版Bitrix，优先升级到官方明确支持PHP8+的版本，从根源避免兼容性问题。

通用Bitrix安装问题排查 #

• 严格匹配官方环境要求：确保PHP扩展（mbstring、gd、mysqli、openssl等）全部启用，数据库版本符合对应Bitrix版本的要求（比如MySQL 5.7+）。
• 彻底清理旧安装残留：删除所有Bitrix相关网站文件，清空对应数据库，避免旧数据干扰新安装流程。
• 使用官方原版安装包：不要用第三方修改的安装包，直接从官方渠道下载对应版本的安装文件。

内容的提问来源于stack exchange，提问作者Vlad Dvin