array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.php-sapi-name.php', 1 => 'php_sapi_name', 2 => 'Liefert das zwischen PHP und Webserver verwendete Interface', ), 'up' => array ( 0 => 'ref.info.php', 1 => 'PHP-Optionen-/-Informationen-Funktionen', ), 'prev' => array ( 0 => 'function.php-ini-scanned-files.php', 1 => 'php_ini_scanned_files', ), 'next' => array ( 0 => 'function.php-uname.php', 1 => 'php_uname', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/info/functions/php-sapi-name.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

php_sapi_name

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

php_sapi_name — Liefert das zwischen PHP und Webserver verwendete Interface

Beschreibung

php_sapi_name(): string|false

Gibt eine Zeichenkette in Kleinbuchstaben zurück, die die von PHP verwendete Schnittstelle (das Server-API, SAPI) beschreibt. Diese Zeichenkette ist z. B. "cli" für den PHP-Kommandozeileninterpreter CLI, während beim Einsatz mit Apache unterschiedliche Werte zurückgegeben werden können, je nachdem welches SAPI verwendet wird. Die möglichen Rückgabewerte sind weiter unten aufgelistet.

Parameter-Liste

Diese Funktion besitzt keine Parameter.

Rückgabewerte

Gibt den Schnittstellentyp als Zeichenkette in Kleinbuchstaben zurück. Bei einem Fehler wird false zurückgegeben.

Mögliche Werte sind unter anderem apache, apache2handler, cgi (bis PHP 5.3), cgi-fcgi, cli, cli-server, embed, fpm-fcgi, litespeed und phpdbg.

Beispiele

Beispiel #1 php_sapi_name()-Beispiel

Dieses Beispiel prüft auf die Teilzeichenkette cgi, da es auch cgi-fcgi sein könnte.

<?php
$sapi_type = php_sapi_name();
if (substr($sapi_type, 0, 3) == 'cgi') {
echo "Sie benutzen CGI-PHP\n";
} else {
echo "Sie benutzen nicht CGI-PHP\n";
}
?>

Anmerkungen

Hinweis: Ein alternativer Ansatz

Die PHP-Konstante PHP_SAPI hat den gleichen Wert wie php_sapi_name().

Tipp

Eine mögliche Überraschung

Die definierte SAPI muss nicht naheliegend sein, denn zum Beispiel anstatt als apache kann sie als apache2handler definiert sein.

Siehe auch