From 7c46308baa45e1567de3cf859617c5a04cb63e98 Mon Sep 17 00:00:00 2001 From: Gabor Hojtsy Date: Sat, 10 Nov 2001 13:42:19 +0000 Subject: [PATCH] . Adding general installation instructions, talking about 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 --- chapters/install.xml | 95 ++++++++++++++++++++++++++++++++++++++------ 1 file changed, 83 insertions(+), 12 deletions(-) diff --git a/chapters/install.xml b/chapters/install.xml index 385a7443c3..6d236d090f 100644 --- a/chapters/install.xml +++ b/chapters/install.xml @@ -1,15 +1,84 @@ - + Installation + + General Installation Considerations + + 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 + What can PHP do? + section: + + Server-side scripting + Command line scripting + Client-side GUI applications + + + + 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 &url.php.hosts;. + + + 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 (php.exe on Windows) to + process all PHP file requests on the server. + + + 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 writing + command line PHP applications. In this case, + you need no server and no browser. + + + 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 + visit the site dedicated to + this extension. PHP-GTK is not included in the + official PHP distribution. + + + From now on, this section deals with setting up PHP + for web servers on Unix and Windows with server module + interfaces and CGI executables. + + + Downloading the latest version - The source code, and binary distributions for some platforms - (including Windows), can be found at &url.php;. We recommend - you to choose mirror nearest + The source code, and binary distributions for Windows + can be found at &url.php;. + We recommend you to choose a + mirror nearest to you for downloading the distributions. @@ -18,7 +87,7 @@ Installation on UNIX systems 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. @@ -5024,7 +5093,7 @@ Service fn=php4_execute see Server-related options 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. @@ -5035,8 +5104,8 @@ Service fn=php4_execute Read the FAQ Some problems are more common than others. The most - common ones are listed in the PHP FAQ, found at &url.php.faq; + common ones are listed in the PHP + FAQ, part of this manual. @@ -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 &url.php.bugs;. + url="&url.php.bugs;">&url.php.bugs;. Please do not + send bug reports in mailing list or personal letters. The + bug system is also suitable to submit feature requests. Read the Bugs-Dos-And-Donts - before submitting any bug reports! + url="&url.php.bugs.howtoreport;">How to report a bug + document before submitting any bug reports!