最可靠方式是用PHP_SAPI常量:'cli'表示命令行,'fpm-fcgi'为PHP-FPM,'apache2handler'为mod_php;需兜底检测常量是否定义,并结合扩展探测Swoole等非标准环境。

PHP 检测当前解释器,最可靠的方式是用 PHP_SAPI 常量或 php_sapi_name() 函数,而不是依赖 $_SERVER 或进程名——后者容易被伪造或不可靠。
判断是否运行在 CLI 环境
多数场景下,你真正想问的是“当前是不是命令行模式”,而非严格区分 PHP-FPM / Apache mod_php / CGI。此时直接检查 PHP_SAPI 最稳妥:
-
PHP_SAPI === 'cli'表示纯 CLI(如php script.php) -
PHP_SAPI === 'phpdbg'表示在 phpdbg 调试器中运行 -
PHP_SAPI === 'embed'表示嵌入式 SAPI(少见)
注意:php -S 内置服务器也返回 'cli',但它实际是 Web SAPI 的变种;若需区分,得额外检查 $_SERVER['SERVER_SOFTWARE'] 是否含 'PHP Built-in server'。
区分 Web SAPI 类型(FPM、Apache、CGI)
PHP_SAPI 在 Web 场景下会返回具体实现名:
立即学习“PHP免费学习笔记(深入)”;
-
'fpm-fcgi':PHP-FPM(最常见) -
'apache2handler':mod_php(Apache 2.x 模块) -
'cgi-fcgi':传统 CGI 或某些 FastCGI 封装(非 FPM) -
'litespeed':LiteSpeed Web Server
不要用 getenv('SERVER_SOFTWARE') 或 $_SERVER['SERVER_SOFTWARE'] 判断——它可能为空、被屏蔽,或在反向代理后不准确。SAPI 名由 PHP 启动时硬编码写入,不可篡改。
避免踩坑:别用 php_sapi_name() 做条件分支的唯一依据
php_sapi_name() 和 PHP_SAPI 内容一致,但函数调用有微小开销;更重要的是,某些容器或嵌入环境(如 HHVM 兼容层、Swoole HTTP Server)可能返回非标准值,比如 'swoole' 或空字符串。
安全做法是先兜底:
if (!defined('PHP_SAPI')) {
// 极端情况:常量未定义,降级用函数
$sapi = php_sapi_name();
} else {
$sapi = PHP_SAPI;
}
// 再做 strcmp 或 in_array 判断,别直接 == null
检测是否运行在特定扩展环境中(如 Swoole、RoadRunner)
这些不属于传统 SAPI,而是通过扩展接管请求生命周期。此时 PHP_SAPI 仍是 'cli',必须额外探测扩展存在性与运行态:
- Swoole:检查
extension_loaded('swoole')且class_exists('Swoole\Http\Server'),再确认\Swoole\Runtime::enableCoroutine()是否已调用 - RoadRunner:检查
extension_loaded('rr')或环境变量$_ENV['RR_MODE']是否为'http' - ReactPHP / Amp:无统一标识,只能看是否已启动事件循环(如
Loop::isRunning())
这类判断必须放在框架/应用初始化早期,晚了可能已错过上下文。
真正难的不是“怎么查”,而是查完之后要不要分流逻辑——比如 CLI 下禁用 session_start(),FPM 下强制设置 opcache.revalidate_freq=0,这些行为边界稍不注意就会引发线上静默失败。











