Index: phpdoc/faqurls.ent
diff -u phpdoc/faqurls.ent:1.13 phpdoc/faqurls.ent:1.14
--- phpdoc/faqurls.ent:1.13 Mon Oct 8 11:25:26 2001
+++ phpdoc/faqurls.ent Sun Oct 14 05:16:30 2001
@@ -1,6 +1,6 @@
+
InstallationInstallation
-
- This section holds common questions about the way to install
- PHP. PHP is available for almost any OS (except may be for
- MacOS before OSX), and almost any web server.
-
-
- To install PHP, follow the instructions in the
- INSTALL
- file located in the distribution. Windows 95 and NT users should also read the
- install.txt
- file. There are also some helpful hints for Windows users
- here.
-
-
- If you are trying to install PHP for use with Netscape's web server on
- Unix see: &faqurl.install;
-
+
+ This section holds common questions about the way to install
+ PHP. PHP is available for almost any OS (except maybe for
+ MacOS before OSX), and almost any web server.
+
+
+ To install PHP, follow the instructions in the
+ INSTALL
+ file located in the distribution. Windows users should also read the
+ install.txt
+ file. There are also some helpful hints for Windows users
+ here.
+
- Where should my php.ini file be located?
+ Unix/Windows: Where should my php.ini file be located?
@@ -34,13 +30,17 @@
By default on UNIX it should be in /usr/local/lib.
Most people will want to change this at compile-time with the
--with-config-file-path
- flag. You would, for example, set it to something like:
-
- --with-config-file-path=/etc
-
- And then you would copy php.ini-dist from
- the distribution to /etc/php.ini and
- edit it to make any local changes you want.
+ flag. You would, for example, set it with something like:
+
+--with-config-file-path=/etc
+
+ And then you would copy php.ini-dist from
+ the distribution to /etc/php.ini and
+ edit it to make any local changes you want.
+
+
+ On Windows the default path for the php.ini
+ file is the Windows directory.
@@ -48,7 +48,7 @@
- I installed PHP using RPMS, but Apache isn't processing the
+ Unix: I installed PHP using RPMS, but Apache isn't processing the
PHP pages! What's going on here?
@@ -56,7 +56,7 @@
Assuming you installed both Apache and PHP from RPM packages,
you need to uncomment or add some or all of the following lines
- in your http.conf file:
+ in your http.conf file:
# Extra Modules
AddModule mod_php.c
@@ -83,59 +83,59 @@
- I installed PHP using RPMS, but it doesn't compile with the database
- support I need! What's going on here?
+ Unix: I installed PHP 3 using RPMS, but it doesn't compile with
+ the database support I need! What's going on here?
- Due to the way PHP is currently built, it is not easy to build a
- complete flexible PHP RPM. This issue will be addressed in PHP 4.
- For PHP, we currently suggest you use the mechanism described in the
+ Due to the way PHP 3 built, it is not easy to build a
+ complete flexible PHP RPM. This issue is addressed in PHP 4.
+ For PHP 3, we currently suggest you use the mechanism described in the
INSTALL.REDHAT file in the PHP distribution. If you insist on using
- an RPM version of PHP, read on...
-
-
- Currently the RPM packagers are setting up the RPMS to install
+ an RPM version of PHP 3, read on...
+
+
+ The RPM packagers are setting up the RPMS to install
without database support to simplify installations and
because RPMS use /usr/ instead of the standard /usr/local/ directory for
- files. You need to tell the RPM spec file which databases to support
+ files. You need to tell the RPM spec file which databases to support
and the location of the top-level of your database server.
-
-
+
+
This example will explain the process of adding support for the
popular MySQL database server, using the mod installation for Apache.
-
-
+
+
Of course all of this information can be adjusted for any database
- server that PHP supports. We will assume you installed MySQL and Apache
+ server that PHP supports. We will assume you installed MySQL and Apache
completely with RPMS for this example as well.
-
-
- First remove mod_php3 :
-
+
+
+ First remove mod_php3 :
+
rpm -e mod_php3
-
-
-
-
-
- Then get the source rpm and INSTALL it, NOT --rebuild
-
+
+
+
+
+
+ Then get the source rpm and INSTALL it, NOT --rebuild
+
rpm -Uvh mod_php3-3.0.5-2.src.rpm
-
-
-
-
-
- Then edit the /usr/src/redhat/SPECS/mod_php3.spec file
-
-
- In the %build section add the database support you want, and the path.
-
-
- For MySQL you would add
+
+
+
+
+
+ Then edit the /usr/src/redhat/SPECS/mod_php3.spec file
+
+
+ In the %build section add the database support you want, and the path.
+
+
+ For MySQL you would add
--with-mysql=/usr \
@@ -150,30 +150,131 @@
--with-mysql=/usr \
--with-system-regex
-
-
-
-
- Once this modification is made then build the binary rpm as follows:
+
+
+
+
+ Once this modification is made then build the binary rpm as follows:
rpm -bb /usr/src/redhat/SPECS/mod_php3.spec
-
-
-
-
-
- Then install the rpm
+
+
+
+
+
+ Then install the rpm
rpm -ivh /usr/src/redhat/RPMS/i386/mod_php3-3.0.5-2.i386.rpm
-
-
-
+
+
+
+
+ Make sure you restart Apache, and you now have PHP 3 with MySQL support
+ using RPM's. Note that it is probably much easier to just build
+ from the distribution tarball of PHP 3 and follow the instructions in
+ INSTALL.REDHAT found in that distribution.
+
+
+
+
+
+
+
+ Unix/Windows: I have installed PHP, but when I try to
+ access a PHP script file via my browser, I get a blank screen.
+
+
+
+
+ Do a 'view source' in the web browser and you will probably
+ find that you can see the source code of your PHP script.
+ This means that the web server did not send the script to
+ PHP for interpretation. Something is wrong with the server
+ configuration - double check the server configuration against
+ the PHP installation instructions.
+
+
+
+
+
+
+
+ Unix/Windows: I have installed PHP, but when try to
+ access a PHP script file via my browser, I get a
+ server 500 error.
+
+
+
+
+ Something went wrong when the server tried to run PHP. To
+ get to see a sensible error message, from the command line,
+ change to the directory containing the PHP executable
+ (php.exe on Windows) and run
+ php -i. If PHP has any problems running,
+ then a suitable error message will be displayed which will
+ give you a clue as to what needs to be done next. If you
+ get a screen full of html codes (the output of the
+ phpinfo function) then PHP is working,
+ and your problem may be related to your server configuration
+ which you should double check.
+
+
+
+
+
+
+
+ Windows: I have installed PHP, but when I to access
+ a PHP script file via my browser, I get the error:
+
+cgi error:
+ The specified CGI application misbehaved by not
+ returning a complete set of HTTP headers.
+ The headers it did return are:
+
+
+
+
+
+ This error message means that PHP failed to output anything
+ at all. To get to see a sensible error message, from the
+ command line, change to the directory containing the PHP
+ executable (php.exe on Windows) and run
+ php -i. If PHP has any problems running,
+ then a suitable error message will be displayed which will
+ give you a clue as to what needs to be done next. If you
+ get a screen full of html codes (the output of the
+ phpinfo function) then PHP is working.
+
+
+ Once PHP is working at the command line, try accessing the
+ script via the browser again. If it still fails then it
+ could be one of the following:
+
+
+
+
+ File permissions on your PHP script,
+ php.exe, php4ts.dll,
+ php.ini or any PHP extensions you are
+ trying to load are such that the anonymous internet user
+ ISUR_<machinename> cannot access them.
+
+
+
+
+ The script file does not exist (or possibly isn't where you
+ think it is relative to your web root directory). Note that
+ for IIS you can trap this error by ticking the 'check file
+ exists' box when setting up the script mappings in the
+ Internet Services Manager. If a script file does not exist
+ then the server will return a 404 error instead. There is
+ also the additional benefit that IIS will do any
+ authentication required for you based on the NTLanMan
+ permissions on your script file.
+
+
- Make sure you restart Apache, and you now have PHP with MySQL support
- using RPM's. Note that it is probably much easier to just build
- from the distribution tarball of PHP and follow the instructions in
- INSTALL.REDHAT found in that distribution.
-
