大网数据广告活动
PHP 语言与运行手册

php_sapi_name · 返回 web 服务器和 PHP 之间的接口类型

· 52CE 我爱测

返回描述 PHP 所使用的接口类型(the Server API, SAPI)的小写字符串。 例如,CLI 的 PHP 下这个字符串会是 "cli",Apache 下可能会有几个不同的值,取决于具体使用的 SAPI。 以下列出了可能的值。

php_sapi_name

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

php_sapi_name — 返回 web 服务器和 PHP 之间的接口类型

说明

function php_sapi_name(): string|false

返回描述 PHP 所使用的接口类型(the Server API, SAPI)的小写字符串。 例如,CLI 的 PHP 下这个字符串会是 "cli",Apache 下可能会有几个不同的值,取决于具体使用的 SAPI。 以下列出了可能的值。

参数

此函数没有参数。

返回值

返回接口类型的小写字符串, 或者在失败时返回 false。

尽管不够全面,可能返回的值包括了 apache、apache2handler、cgi(直到 PHP 5.3)、cgi-fcgi、cli、cli-server、embed、fpm-fcgi、litespeed、phpdbg。

示例

示例 #1 php_sapi_name() 示例

以下示例检测了子字符串 cgi,因为它也有可能会是 cgi-fcgi。

<?php
$sapi_type = php_sapi_name();
if (substr($sapi_type, 0, 3) == 'cgi') {
    echo "You are using CGI PHP\n";
} else {
    echo "You are not using CGI PHP\n";
}
?>

注释

注意: 另一种方法

PHP 常量 PHP_SAPI 具有和 php_sapi_name() 相同的值。

小技巧

一个潜在的疑难问题

定义的 SAPI 可能不够明显,比如它可能定义为 apache2handler,而不是 apache。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。