php_sapi_name
(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
php_sapi_name — 返回 Web 服务器和 PHP 之间的接口类型
描述
返回一个描述 PHP 使用的接口类型(服务器 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 "您正在使用 CGI PHP\n";
} else {
echo "您没有使用 CGI PHP\n";
}
?>
注释
注意:另一种方法
PHP 常量PHP_SAPI
与 php_sapi_name() 的值相同。
提示
一个潜在的陷阱
定义的 SAPI 可能并不明显,因为例如它可能定义为 apache2handler
,而不是 apache
。