PHP不支持自动函数别名，需用function_exists()手动判断并定义兼容函数，且须注意签名一致、加载时机、行为差异及生产环境禁用。
PHP 本身不支持函数别名的“自动兼容层”，所谓“兼容函数别名”必须手动定义，且需严格避开已存在函数、注意作用域与加载顺序。
怎么用 function_exists() 判断并定义兼容函数
PHP 没有内置机制自动 fallback 到替代函数，必须显式检查原函数是否存在，再决定是否定义别名。这是最常用也最稳妥的方式。
- 废弃函数如
mysql_connect()在 PHP 7.0+ 已移除，不能直接调用；但若旧代码大量使用，可手动补一个同名函数做兼容 - 必须在所有业务代码执行前加载该兼容层文件（例如放在
bootstrap.php或框架入口最顶部） - 定义时需模仿原函数签名（参数个数、默认值、返回值），否则调用会出错或行为不一致
- 示例：
if (!function_exists('mysql_connect')) { function mysql_connect($server = 'localhost', $username = '', $password = '', $new_link = false, $client_flags = 0) { trigger_error('mysql_connect() is deprecated, use mysqli or PDO instead', E_USER_DEPRECATED); return mysqli_connect($server, $username, $password); } }
为什么不能用 alias() 或 class_alias() 处理函数
class_alias() 只对类生效，PHP 没有 function_alias() 或类似语言特性。试图用反射或 eval() 动态生成函数别名既危险又不可靠。
-
class_alias('OldClass', 'NewClass')有效，但function_alias('old_func', 'new_func')不存在 -
eval("function old_func(){...}")虽能创建函数，但无法保证加载时机，容易被重复定义报错（Cannot redeclare function） - 扩展层面可用
zend_register_function()注册别名，但这属于 C 扩展开发范畴，不适合普通项目维护
替换废弃函数时要注意的三个关键点
别名只是过渡手段，真正替换时必须同步处理行为差异，否则表面兼容、实际出错。
立即学习“PHP免费学习笔记（深入）”；
-
mysql_*()系列函数返回资源（resource），而mysqli_*多数返回mysqli对象或布尔值，错误判断逻辑要重写（不能继续用mysql_error()） - 连接上下文不同：旧函数隐式使用最近一次连接，新函数需显式传入连接句柄（如
mysqli_query($conn, $sql)） - 字符集处理差异大：
mysql_set_charset()是独立函数，mysqli_set_charset($conn, 'utf8mb4')必须在连接后立即调用，否则 SQL 执行时可能乱码
用 Composer 自动加载兼容层的最佳实践
把兼容函数集中到一个命名空间下的文件里，通过 Composer 的 files 自动加载，避免手动 require 遗漏。
- 在
composer.json中添加："autoload": { "files": ["src/Compat/DeprecatedFunctions.php"] } - 确保
DeprecatedFunctions.php文件只含函数定义，不含类、命名空间或执行逻辑 - 运行
composer dump-autoload生效；后续所有脚本只要引入 autoloader 就自动可用这些兼容函数 - 上线前务必禁用该层——别名函数只是开发期兜底，生产环境应彻底清理废弃调用
真正的兼容难点不在“怎么写别名”，而在于函数语义变化带来的副作用：资源生命周期、错误处理方式、全局状态依赖。哪怕加了 function_exists() 包裹，没校验返回值类型和上下文，照样会在某次数据库断连或字符集切换时突然崩掉。
