array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.php-sapi-name.php', 1 => 'php_sapi_name', 2 => 'Retorna o tipo de interface entre o servidor web e o PHP', ), 'up' => array ( 0 => 'ref.info.php', 1 => 'Funções para Opções/Info do PHP', ), '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' => 'pt_BR', '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 — Retorna o tipo de interface entre o servidor web e o PHP

Descrição

php_sapi_name(): string|false

Retorna uma string em minúsculas que descreve o tipo de interface (API do Servidor, SAPI) que o PHP está usando. Por exemplo, no PHP CLI esta string será "cli" e no Apache poderá ter vários valores diferentes dependendo da SAPI exata sendo usada. Os valores possíveis estão listados abaixo.

Parâmetros

Esta função não possui parâmetros.

Valor Retornado

Retorna o tipo de interface como uma string em minúsculasing ou false em caso de falha.

Embora não seja uma lista exaustiva, os valores possíveis incluem apache, apache2handler, cgi (até o PHP 5.3), cgi-fcgi, cli, cli-server, embed, fpm-fcgi, litespeed, phpdbg.

Exemplos

Exemplo #1 Exemplo de php_sapi_name()

Este exemplo procura pela sub-string cgi porque a interface também pode ser cgi-fcgi.

<?php
$sapi_type = php_sapi_name();
if (substr($sapi_type, 0, 3) == 'cgi') {
echo "Você está usando o PHP CGI.\n";
} else {
echo "Você não está usando o PHP CGI.\n";
}
?>

Notas

Nota: Uma abordagem alternativa

A constante PHP_SAPI do PHP tem o mesmo valor retornado pela função php_sapi_name().

Dica

Uma potencial armadilha

A SAPI definida pode não ser óbvia porque, por exemplo, ao invés de apache ela pode estar definida como apache2handler.

Veja Também