php_sapi_name

(PHP 4 >= 4.0.1, PHP 5)

php_sapi_name — HTTP sunucusu ile PHP arasındaki arayüzün türünü döndürür

Açıklama

string php_sapi_name ( void )

PHP'nin kullandığı arayüz (Sunucu API'si, SAPI) türünü belirten küçük harfli bir dizge döndürür. Örneğin CLI PHP için bu dizge "cli" olurken Apache ile kullanılan API'ye bağlı olarak değişiklik gösteribilir. Olası değerler aşağıda listelenmiştir.

Dönen Değerler

Arayüz türünü küçük harfli bir dizge olarak döndürür.

Tamamı olmasa da olası değerler şunlardır: aolserver, apache, apache2filter, apache2handler, caudium, cgi (PHP 5.3'ten beri), cgi-fcgi, cli, continuity, embed, isapi, litespeed, milter, nsapi, phttpd, pi3web, roxen, thttpd, tux ve webjames.

Örnekler

Örnek 1 - php_sapi_name() örneği

Bu örnektecgi-fcgi değerini de kapsayan cgi alt dizgesinin varlığı aranmaktadır.


<?php
$sapi_type = php_sapi_name();
if (substr($sapi_type, 0, 3) == 'cgi') {
    echo "CGI PHP kullanıyorsunuz\n";
} else {
    echo "CGI PHP kullanmıyorsunuz\n";
}
?>

Notlar

Bilginize: Başka bir yaklaşım

PHP sabiti PHP_SAPI, php_sapi_name() işlevinden dönen değerin aynını içerir.

İpucu

Olası bir yanlış anlama

Tanımlı SAPI her zaman apaçık belli değildir. Apache örneğindeki gibi apache2handler veya apache2filter olarak tanımlanmış olabilir.

Ayrıca Bakınız

PHP_SAPI

php_uname

php_logo_guid

[edit] Last updated: Fri, 23 Mar 2012

add a note User Contributed Notes php_sapi_name

tobias(at)tobias(-)net(dot)nl 04-Jan-2012 12:31


You can check whether the user is using CLI or browser by running this script:



<?php

if (isset ($_SERVER['SESSIONNAME'])) echo 'CLI';

else echo 'Browser';

?>

michal at roszka dot pl 25-Mar-2009 07:13


The php_sapi_name() function is extremely useful when you want to determine the type of interface. There is, however, one more gotcha you need to be aware of while designing your application or deploying it to an unknown server.



Whenever something depends on the type of interface, make sure your check is conclusive. Especially when you want to distinguish the command line interface (CLI) from the common gateway interface (CGI).



Note, that the php-cgi binary can be called from the command line, from a shell script or as a cron job as well! If so, the php_sapi_name() will always return the same value (i.e. "cgi-fcgi") instead of "cli" which you could expect.



Bad things happen to good people. Do not always expect /usr/bin/php to be a link to php-cli binary.



Luckily the contents of the $_SERVER and the $_ENV superglobal arrays depends on whether the php-cgi binary is called from the command line interface (by a shell script, by the cron, etc.) or by some HTTP server (i.e. lighttpd).



<?php

var_dump($_SERVER);

?>



Try to call php-cgi binary from the command line interface and then via HTTP request and compare the output of the script above. There will be plenty options to satisfy almost everyone.



For the sake of security remember, that contents of the $_SERVER and the $_ENV superglobal arrays (as well as $_GET, $_POST, $_COOKIE, $_FILES and $_REQUEST) should be considered tainted.

Ysangkok 27-Aug-2008 08:34


This function can also return "cli" if PHP was launched from CLI. Useful if one wants to behave differently when running in console.

add a note