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
。