如何避免PHP多版本兼容代码中的废弃函数警告？

一、使用PHPDoc注解抑制警告 #

大部分IDE和代码检查工具支持通过PHPDoc注解忽略特定的废弃函数警告，常用的注解包括：

• 针对JetBrains系列IDE（如PHPStorm）：在废弃函数代码块上方添加/** @noinspection PhpDeprecationInspection */
• 针对PHPStan：使用/** @phpstan-ignore-next-line deprecation */跳过下一行的废弃警告
• 针对PHPMD：用/** @SuppressWarnings(PHPMD.DeprecatedCode) */屏蔽废弃代码检测

示例修改后的代码：

if (version_compare(PHP_VERSION, '7.0.0') >= 0) {
    $salt = random_bytes(22);
} else {
    /** @noinspection PhpDeprecationInspection */
    // 兼容PHP 7.0以下版本
    $salt = mcrypt_create_iv(22, MCRYPT_DEV_URANDOM);
}

二、在代码检查工具中全局配置排除 #

如果不想在代码中嵌入注解，可以通过工具配置文件全局忽略特定函数的废弃警告：

• PHP_CodeSniffer：在项目的phpcs.xml中添加规则，指定排除mcrypt_create_iv的废弃提示
• PHPStan：在phpstan.neon的ignoreErrors节点中，添加针对该函数的忽略规则
• PHPMD：在规则集配置里禁用DeprecatedCode规则，或单独针对mcrypt_create_iv函数排除检测

三、代码逻辑优化（彻底规避警告） #

可以通过封装兼容函数的方式，让代码在不同PHP版本下调用统一的接口，彻底解决废弃函数警告问题：

if (!function_exists('random_bytes')) {
    function random_bytes($length) {
        return mcrypt_create_iv($length, MCRYPT_DEV_URANDOM);
    }
}
$salt = random_bytes(22);

这种方式通过函数存在性判断，自动适配不同PHP版本的实现，代码更简洁且无警告。

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