PHP_VERSION常量最稳定,编译时写死,任何环境均可直接使用;判断版本须用version_compare(),禁用字符串或浮点比较,避免预发布版出错。

直接用 PHP_VERSION 常量最稳
不需要调函数、不依赖扩展,PHP_VERSION 是编译时写死的字符串常量,任何 PHP 脚本里都能立刻用,且不会出错。它比 phpversion() 更轻量,也不受 disable_functions 影响。
常见错误现象:在 CLI 环境下运行 phpversion() 返回空,其实是被禁用了;或者在某些精简容器镜像里,phpinfo() 被彻底移除,但 PHP_VERSION 一定存在。
-
echo PHP_VERSION;—— 输出类似8.2.12 - 做版本判断时建议用
version_compare(PHP_VERSION, '8.1', '>='),别用字符串截取或floatval(),避免8.1.0-rc1这类预发布版本出错 - 如果要区分 ZTS/NTS 或架构(如
php -v显示的with Zend OPcache),PHP_VERSION不包含这些信息,得换方式
phpversion() 在什么情况下会失效
phpversion() 看似标准,但实际运行中容易掉坑:它返回的是主 SAPI 的版本(比如 Apache 模块或 FPM 主进程),不是当前子进程或动态加载模块的实际版本;更关键的是,它可能被禁用。
使用场景:你正在写一个兼容多环境的安装检测脚本,需要确认是否满足最低 PHP 版本 —— 此时不能只信 phpversion(),得兜底。
立即学习“PHP免费学习笔记(深入)”;
- 检查
disable_functions配置里是否含phpversion(ini_get('disable_functions')可查) - CLI 下执行
php -r "echo phpversion();"成功,不代表 Web 环境也行——Apache/FPM 的php.ini可能不同 -
phpversion('openssl')这种带参数的用法,只查扩展版本,和核心 PHP 版本无关,别混用
命令行里快速看真实版本(含构建信息)
Web 界面或日志里看到的版本号可能是伪造的(比如某些 CDN 或反向代理注入了假头),真要确认,必须进服务器跑命令。
注意:php -v 和 php --version 输出一致,但 php -v 更常用;而 php -i | grep "PHP Version" 效率低还可能漏信息。
-
php -v—— 第一行就是核心版本,后面跟着 Zend 引擎和构建时间,比如PHP 8.3.6 (cli) (built: Apr 15 2024 12:34:56) -
php-config --version—— 如果装了开发包,这个更精确,不含括号后缀,适合脚本解析 - 容器环境里,
docker exec -it myapp php -v才是真实结果,别只看Dockerfile写的FROM php:8.2
判断版本时最容易忽略的「点」
很多人写 if (PHP_VERSION >= '8.0'),看着没问题,但 PHP 版本字符串比较不能直接用 >= —— 因为 '8.10' 在字典序里居然是 <code>true,这是硬伤。
性能影响几乎为零,但逻辑错会导致低版本误判成高版本,上线后出奇怪 Notice 或 Fatal。
- 永远用
version_compare(PHP_VERSION, '8.1', '>='),这是唯一靠谱的比较方式 -
PHP_MAJOR_VERSION、PHP_MINOR_VERSION、PHP_RELEASE_VERSION这三个整数常量 PHP 7.0+ 才有,老项目慎用 - 预发布版(如
8.4.0RC1)会被version_compare正确识别,但你自己写的正则或explode('.', ...)极大概率崩



















