php-sapi-name.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 41060e691dc09b9b190e2181123dbc8286e05843 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.php-sapi-name" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>php_sapi_name</refname>
  <refpurpose>Devuelve el tipo de interfaz que hay entre PHP y el servidor</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>php_sapi_name</methodname>
   <void/>
  </methodsynopsis>
  <simpara>
   Devuelve una cadena en minúsculas que describe el tipo de interfaz
   (la API de Servidor, SAPI) que está utilizando PHP. Por ejemplo, en PHP CLI
   esta cadena será "cli" mientras que en Apache podría tener varios valores
   diferentes dependiendo de la SAPI que se utilice. Más abajo se enumeran
   los posibles valores.
  </simpara>
 </refsect1>
 
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve el tipo de interfaz, como cadena de texto en minúsculas.
  </para>
  <para>
   Pese a no ser una lista completa, los posibles valores incluyen
   <literal>aolserver</literal>, <literal>apache</literal>, 
   <literal>apache2filter</literal>, <literal>apache2handler</literal>, 
   <literal>caudium</literal>, <literal>cgi</literal> (hasta PHP 5.3), 
   <literal>cgi-fcgi</literal>, <literal>cli</literal>, <literal>cli-server</literal>,
   <literal>continuity</literal>, <literal>embed</literal>, <literal>fpm-fcgi</literal>,
   <literal>isapi</literal>, <literal>litespeed</literal>, 
   <literal>milter</literal>, <literal>nsapi</literal>, 
   <literal>phttpd</literal>, <literal>pi3web</literal>, <literal>roxen</literal>,
   <literal>thttpd</literal>, <literal>tux</literal>, y <literal>webjames</literal>.
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>php_sapi_name</function></title>
    <para>
     Este ejemplo comprueba si está la cadena <literal>cgi</literal>,
     ya que podría darse un nombre como <literal>cgi-fcgi</literal>.
    </para>
    <programlisting role="php">
<![CDATA[
<?php
$sapi_type = php_sapi_name();
if (substr($sapi_type, 0, 3) == 'cgi') {
    echo "Está usando PHP CGI\n";
} else {
    echo "No está usando PHP CGI\n";
}
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <title>Una forma alternativa</title>
   <para>
    La constante de PHP <constant>PHP_SAPI</constant> contiene el mismo valor
    que <function>php_sapi_name</function>.
   </para>
  </note>
  <tip>
   <title>Posible malentendido</title>
   <para>
    Podría no ser evidente cuál es la <acronym>SAPI</acronym> en uso, ya que, por ejemplo,
    en lugar de <literal>apache</literal> podría aparecer definida como
    <literal>apache2handler</literal> o como <literal>apache2filter</literal>.
   </para>
  </tip>
 </refsect1>
 
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><link linkend="reserved.constants.core">PHP_SAPI</link></member>
   </simplelist>
  </para>
 </refsect1>
 
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->