php-doc-en/appendices/configure/servers.xml
George Peter Banyard d278431ef5 Remove docs about NSAPI
This SAPI has been removed in PHP 7
2021-01-13 12:49:23 +00:00

231 lines
7 KiB
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
-->