sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 00:48:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

. Adding general installation instructions, talking about

Browse source 
servers, the module and CGI option, command line a GTK
  setup.

. Correcting problems part with the actual bug information,
  inline link to the PHP FAQ

. Maybe some more small corrections


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@61826 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Gabor Hojtsy 2001-11-10 13:42:19 +00:00
parent 86370a521a
commit 7c46308baa
1 changed files with 83 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

95
chapters/install.xml
View file

@ -1,15 +1,84 @@
<?xml encoding="iso-8859-1"?>
<!-- $Revision: 1.86 $ -->
<!-- $Revision: 1.87 $ -->
<chapter id="installation">
<title>Installation</title>
<sect1 id="install.general">
<title>General Installation Considerations</title>
<para>
Before installing first, you need to know what do you
want to use PHP for. There are three main fields you
can use PHP, as described in the
<link linkend="intro-whatcando">What can PHP do?</link>
section:
<itemizedlist>
<listitem><simpara>Server-side scripting</simpara></listitem>
<listitem><simpara>Command line scripting</simpara></listitem>
<listitem><simpara>Client-side GUI applications</simpara></listitem>
</itemizedlist>
</para>
<para>
For the first and most common form, you need three things:
PHP itself, a web server and a web browser. You
probably already have a web browser, and depending on
your operating system setup, you may also have a web
server (eg. Apache on Linux or IIS on Windows).
You may also rent webspace at a company. This way, you
don't need to set up anything on your own, only write
your PHP scripts, upload it to the server you rent, and
see the results in your browser. You can find a list of
hosting companies at <ulink
url="&url.php.hosts;">&url.php.hosts;</ulink>.
</para>
<para>
While setting up the server and PHP on your own, you have
two choices for the method of connecting PHP to the
server. For many servers PHP has a direct module
interface (also called SAPI). These servers include
Apache, Microsoft Internet Information Server,
Netscape and iPlanet servers. Many other servers
have support for ISAPI, the Microsoft module
interface (OmniHTTPd for example). If PHP has no
module support for your web server, you can always
use it as a CGI processor. This means you set up
your server to use the command line executable of
PHP (<filename>php.exe</filename> on Windows) to
process all PHP file requests on the server.
</para>
<para>
If you are also interested to use PHP for command line
scripting (eg. write scripts autogenerating some images
for you offline, or processing text files depending
on some arguments you pass to them), you always need
the command line executable. For more information, read
the section about <link linkend="commandline">writing
command line PHP applications</link>. In this case,
you need no server and no browser.
</para>
<para>
With PHP you can also write client side GUI applications
using the PHP-GTK extension. This is a completely
different approach than writing web pages, as you
do not output any HTML, but manage windows and objects
within them. For more information about PHP-GTK, please
<ulink url="&url.php.gtk;">visit the site dedicated to
this extension</ulink>. PHP-GTK is not included in the
official PHP distribution.
</para>
<para>
From now on, this section deals with setting up PHP
for web servers on Unix and Windows with server module
interfaces and CGI executables.
</para>
</sect1>
<sect1 id="install.downloading">
<title>Downloading the latest version</title>
<simpara>
The source code, and binary distributions for some platforms
(including Windows), can be found at <literal><ulink
url="&url.php;">&url.php;</ulink></literal>. We recommend
you to choose <ulink url="&url.mirrors;">mirror</ulink> nearest
The source code, and binary distributions for Windows
can be found at <ulink url="&url.php;">&url.php;</ulink>.
We recommend you to choose a
<ulink url="&url.mirrors;">mirror</ulink> nearest
to you for downloading the distributions.
</simpara>
</sect1>
@ -18,7 +87,7 @@
<title>Installation on UNIX systems</title>
<para>
This section will guide you through the general configuration and
installation of PHP on unix systems. Be sure to investigate any
installation of PHP on Unix systems. Be sure to investigate any
sections specific to your platform or web server before you begin
the process.
</para>
@ -5024,7 +5093,7 @@ Service fn=php4_execute
see <link linkend="install.configure.servers">Server-related
options</link> for a full list of server-related configure
options. The PHP CGI binaries are compatible with almost all
webservers supporting the CGI interface.
webservers supporting the CGI standard.
</para>
</sect1>
@ -5035,8 +5104,8 @@ Service fn=php4_execute
<title>Read the FAQ</title>
<simpara>
Some problems are more common than others. The most
common ones are listed in the PHP FAQ, found at <ulink
url="&url.php.faq;">&url.php.faq;</ulink>
common ones are listed in the <link linkend="faq">PHP
FAQ</link>, part of this manual.
</simpara>
</sect2>
@ -5070,12 +5139,14 @@ Service fn=php4_execute
PHP developers probably don't know about it, and unless you
report it, chances are it won't be fixed. You can report bugs
using the bug-tracking system at <ulink
url="&url.php.bugs;">&url.php.bugs;</ulink>.
url="&url.php.bugs;">&url.php.bugs;</ulink>. Please do not
send bug reports in mailing list or personal letters. The
bug system is also suitable to submit feature requests.
</simpara>
<simpara>
Read the <ulink
url="&url.php.bugdosdonts;">Bugs-Dos-And-Donts</ulink>
before submitting any bug reports!
url="&url.php.bugs.howtoreport;">How to report a bug</ulink>
document before submitting any bug reports!
</simpara>
</sect2>