[mapserver-commits] r8368 - trunk/docs/installation
svn at osgeo.org
svn at osgeo.org
Wed Dec 31 12:58:43 EST 2008
Author: jmckenna
Date: 2008-12-31 12:58:42 -0500 (Wed, 31 Dec 2008)
New Revision: 8368
Modified:
trunk/docs/installation/php.txt
Log:
add more internal referencing, and add readable labels for the references
Modified: trunk/docs/installation/php.txt
===================================================================
--- trunk/docs/installation/php.txt 2008-12-31 16:41:30 UTC (rev 8367)
+++ trunk/docs/installation/php.txt 2008-12-31 17:58:42 UTC (rev 8368)
@@ -6,7 +6,8 @@
:Author: Jeff McKenna
:Contact: jmckenna at gatewaygeomatics.com
-:Last Updated: 2007/09/11
+:Revision: $Revision$
+:Date: $Date$
.. contents:: Table of Contents
:depth: 2
@@ -26,7 +27,8 @@
support the PHP language, the module has to be maintained separately and may
not always be in sync with the Perl version.
-The PHP module was developed and is currently maintained by `DM Solutions Group`_.
+The PHP module was developed by `DM Solutions Group`_ and is currently
+maintained by `Mapgears`_.
This document assumes that you are already familiar with certain aspects of
your operating system:
@@ -54,13 +56,13 @@
---------------------------------------------------------------------
- For a list of all classes, properties, and methods available in the module
- see the :ref:`php`.
+ see the :ref:`php` reference document.
- More information on the PHP/MapScript module can be found on the
`PHP/MapScript page`_ on MapTools.org.
-- The old `MapServer Wiki`_ also has PHP/MapScript build and installation notes
- and some php code snippets.
+.. - The old `MapServer Wiki`_ also has PHP/MapScript build and installation notes
+ and some php code snippets.
- Questions regarding the module should be forwarded to the :ref:`MapServer mailing list <lists>`.
@@ -107,8 +109,8 @@
When setting up PHP on Windows, make sure that PHP is configured as a CGI and not
as an Apache module because php_mapscript.dll is not thread-safe and does not work
- as an Apache module (See the `Example Steps of a Full Windows Installation section`_
- of this document).
+ as an Apache module (See the :ref:`Example Steps of a Full Windows Installation
+ <php_install_example_steps>` section of this document).
Build/Install the PHP/MapScript Module
--------------------------------------
@@ -116,7 +118,8 @@
**Building on a Linux Box**
-NOTE: For UNIX users, see the README.CONFIGURE file in the MapServer source, or see the :ref:`unix`.
+NOTE: For UNIX users, see the README.CONFIGURE file in the MapServer source, or
+see the :ref:`unix` HowTo.
- The main MapServer configure script will automatically setup the main makefile
to compile php_mapscript.so if you pass the *--with-php=DIR* argument to the configure script.
@@ -140,7 +143,7 @@
**Building on Windows**
- For Windows users, it is recommended to look for a precompiled binary for your
- PHP version on the `MapServer download page`_ or on `MapTools.org`_.
+ PHP version on the :ref:`MapServer download page <download>` or on `MapTools.org`_.
- If for some reason you really need to compile your own Windows binary then see the
README.WIN32 file in the MapServer source (good luck!).
@@ -182,6 +185,8 @@
displayed on your page, and 'MapScript' should be listed in the 'Extensions'
table.
+.. _php_install_example_steps:
+
Example Steps of a Full Windows Installation
--------------------------------------------
@@ -209,7 +214,8 @@
2. Download `PHP4`_ and extract it to your Apache folder (eg. D:/Apache/PHP4).
3. Create a temp directory to store MapServer created GIFs. NOTE: This directory
- is specified in the IMAGEPATH parameter of the WEB Object in the :ref:`mapfile`.
+ is specified in the IMAGEPATH parameter of the WEB Object in the :ref:`mapfile`
+ reference.
For this example we will call the temp directory "ms_tmp" (eg. E:/tmp/ms_tmp).
4. Locate the file *httpd.conf* in the conf directory of Apache, and open it
@@ -252,7 +258,7 @@
**Installation Using Microsoft's IIS**
-(please see the `MapServer IIS Setup howto`_ for uptodate steps)
+(please see the :ref:`iis` document for uptodate steps)
1. Install IIS if required (see the `IIS 4.0 installation procedure`_).
@@ -304,16 +310,16 @@
:Q: **Is there any documentation available?**
-:A: The main reference document is the :ref:`php`,
+:A: The main reference document is the :ref:`PHP MapScript reference <php>`,
which describes all of the current classes, properties and methods
associated with the PHP/MapScript module.
To get a more complete description of each class and the meaning of
- their member variables, see the :ref:`mapscript`
- and the :ref:`mapfile`.
+ their member variables, see the :ref:`MapScript reference <mapscript>`
+ and the :ref:`MapFile reference <mapfile>`.
- The `MapServer Wiki`_ also has PHP/MapScript build and installation
- notes and some php code snippets.
+ .. The `MapServer Wiki`_ also has PHP/MapScript build and installation
+ notes and some php code snippets.
--------
@@ -324,7 +330,7 @@
*test_draw_map.phtml*: it's a very simple script that just draws a map,
legend and scalebar in an HTML page.
- A good intermediate example is the :ref:`php_example`
+ A good intermediate example is the :ref:`PHP MapScript By Example guide <php_example>`
(note that this document was created for an earlier MapServer version
but the code might be still useful).
@@ -368,8 +374,8 @@
AddType application/x-httpd-php .phtml
- For a more detailed explanation, see the `Example Steps of a Full Windows Installation section`_
- section of this document.
+ For a more detailed explanation, see the :ref:`Example Steps of a Full Windows
+ Installation <php_install_example_steps>` section of this document.
--------
@@ -447,24 +453,21 @@
.. _`SWIG`: http://www.swig.org/
.. _`DM Solutions Group`: http://www.dmsolutions.ca/
+.. _`Mapgears`: http://www.mapgears.com
.. _`PHP/MapScript page`: http://www.maptools.org/php_mapscript/
.. _`MapServer Wiki`: http://mapserver.gis.umn.edu/cgi-bin/wiki.pl?PHPMapScript
-.. _`MapServer mailing list`: http://mapserver.gis.umn.edu/community/mailinglists/
.. _`PHP web site`: http://www.php.net/
.. _`Installation on Unix systems`: http://php.net/manual/en/install.unix.php
.. _`MS4W (MapServer For Windows)`: http://www.maptools.org/ms4w/
.. _`Installing Apache, PHP and MySQL on Windows tutorial`: http://www.php-mysql-tutorial.com/install-apache-php-mysql.php
.. _`php.net's howto`: http://www.php.net/manual/en/install.iis.php
-.. _`Example Steps of a Full Windows Installation section`: http://mapserver.gis.umn.edu/docs/howto/phpmapscript-install/#example-steps-of-a-full-windows-installation
.. _`extension_loaded()`: http://www.php.net/manual/en/function.extension-loaded.php
-.. _`MapServer download page`: http://mapserver.gis.umn.edu/download/current/windows/
.. _`MapTools.org`: http://www.maptools.org/php_mapscript/index.phtml?page=downloads.html
.. _`MS4W base package`: http://www.maptools.org/ms4w/index.phtml?page=downloads.html
.. _`MS4W download page`: http://www.maptools.org/ms4w/index.phtml?page=downloads.html
.. _`Apache Web Server`: http://httpd.apache.org/
.. _`PHP4`: http://www.php.net/
.. _`IIS 4.0 installation procedure`: http://support.microsoft.com/support/iis/install/install_iis4.asp
-.. _`MapServer IIS Setup howto`: http://mapserver.gis.umn.edu/docs/howto/setupiis
.. _`MapTools.org download page`: http://www.maptools.org/dl/
.. _`GMap demo`: http://www.mapsherpa.com/gmap/
.. _`PHP/MapScript CGI page`: http://mapserver.gis.umn.edu/cgi-bin/wiki.pl?PHPMapScriptCGI
More information about the mapserver-commits
mailing list