servers.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
 <sect3 xml:id="configure.options.servers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>SAPI options</title>
  <para>
   The following list contains the available SAPI&amp;s (<literal>Server
   Application Programming Interface</literal>) for PHP.
  </para>
  <variablelist>
   <varlistentry xml:id="configure.with-apxs">
    <term>
     <option role="configure">--with-apxs[=FILE]</option>
    </term>
    <listitem>
     <para>
      Build shared Apache module. FILE is the optional pathname to the Apache
      apxs tool; defaults to apxs. Make sure you specify the version of apxs that
      is actually installed on your system and NOT the one that is in the apache
      source tarball.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="configure.with-apache">
    <term>
     <option role="configure">--with-apache[=DIR]</option>
    </term>
    <listitem>
     <para>
      Build a static Apache module. DIR is the top-level Apache build directory,
      defaults to <filename>/usr/local/apache</filename>.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="configure.with-mod-charset">
    <term>
     <option role="configure">--with-mod_charset</option>
    </term>
    <listitem>
     <para>
      Enable transfer tables for mod_charset (Russian Apache).
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="configure.with-apxs2">
    <term>
     <option role="configure">--with-apxs2[=FILE]</option>
    </term>
    <listitem>
     <para>
      Build shared Apache 2.0 module. FILE is the optional pathname to the Apache
      apxs tool; defaults to apxs.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="configure.disable-cli">
    <term>
     <option role="configure">--disable-cli</option>
    </term>
    <listitem>
     <para>
      Disable building the CLI version of PHP (this
      forces <link linkend="configure.without-pear">--without-pear</link>).
      More information is available in the section about
      <link linkend="features.commandline">Using PHP from the command line</link>.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="configure.enable-phpdbg">
    <term>
     <option role="configure">--enable-phpdbg</option>
    </term>
    <listitem>
     <para>
      Enable phpdbg interactive debugger SAPI module support in PHP 5.6.x or later.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="configure.enable-embed">
    <term>
     <option role="configure">--enable-embed[=TYPE]</option>
    </term>
    <listitem>
     <para>
      Enable building of the embedded SAPI library. TYPE is either
      <literal>shared</literal> or <literal>static</literal>, which
      defaults to <literal>shared</literal>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="configure.with-servlet">
    <term>
     <option role="configure">--with-servlet[=DIR]</option>
    </term>
    <listitem>
     <para>
      Include servlet support. DIR is the base install directory for the JSDK.
      This SAPI requires the java extension must be built as a shared dl.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="configure.disable-cgi">
    <term>
     <option role="configure">--disable-cgi</option>
    </term>
    <listitem>
     <para>
      Disable building CGI version of PHP.
     </para>
     <para>
      As of PHP 5.3.0 this argument enables FastCGI which previously 
      had to be enabled using <literal>--enable-fastcgi</literal>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="configure.enable-force-cgi-redirect">
    <term>
     <option role="configure">--enable-force-cgi-redirect</option>
    </term>
    <listitem>
     <para>
      Enable the security check for internal server redirects. You should use
      this if you are running the CGI version with Apache.
     </para>
     <para>
      As of PHP 5.3.0 this argument is enabled by default and no longer 
      exists. To disable this, the 
      <link linkend="ini.cgi.force-redirect">cgi.force_redirect</link> ini directive 
      should be set to <literal>0</literal>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="configure.enable-discard-path">
    <term>
     <option role="configure">--enable-discard-path</option>
    </term>
    <listitem>
     <para>
      If this is enabled, the PHP CGI binary can safely be placed outside of
      the web tree and people will not be able to circumvent &htaccess;
      security.
     </para>
     <para>
      As of PHP 5.3.0 this argument is disabled by default and no longer 
      exists. To enable this feature the cgi.discard_path ini directive 
      must be set to <literal>1</literal>.
     </para>
    </listitem>
   </varlistentry>

  <!--<varlistentry xml:id="configure.disable-path-info-check">
    <term>
     <option role="configure">disable-path-info-check</option>
    </term>
    <listitem>
     <para>
      Disables path info checks, disabling paths such as 
      <literal>/file.php/test?a=b</literal>.
     </para>
     <para>
      As of PHP 5.3.0 this argument is enabled by default and no longer 
      exists. To disable this, the 
      <link linkend="ini.cgi.fix-pathinfo">cgi.fix_pathinfo</link> ini directive 
      should be set to <literal>0</literal>.
     </para>
    </listitem>
   </varlistentry> -->

   <varlistentry xml:id="configure.enable-fastcgi">
    <term>
     <option role="configure">--enable-fastcgi</option>
    </term>
    <listitem>
     <para>
      If this is enabled, the CGI module will be built with support for FastCGI
      also.
     </para>
     <para>
      As of PHP 5.3.0 this argument no longer exists and is enabled by 
      <literal>--enable-cgi</literal> instead.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="configure.disable-path-info-check">
    <term>
     <option role="configure">--disable-path-info-check</option>
    </term>
    <listitem>
     <para>
      If this is disabled, paths such as <filename>/info.php/test?a=b</filename>
      will fail to work. For more information see the
      <link xlink:href="&url.apache.core;#acceptpathinfo">Apache Manual</link>.
     </para>
     <para>
      As of PHP 5.3.0 this argument is enabled by default and no longer exists.
      To disable this feature the <link
      linkend="ini.cgi.fix-pathinfo">cgi.fix_pathinfo</link> ini directive must
      be set to <literal>0</literal>.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </sect3>

<!-- 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
-->