[[TOC]]

= Upgrade Information for p.mapper versions =

== Upgrade 3.x -> 4.x ==

The main change in the configuration is the move from ini file to XML based configuration. The XML file also contains most parts of the former php_config.php file and search.xml. To convert existing config files to the new structure download the 
[http://svn.pmapper.net/trac/browser/pmapper/trunk/utils/ini2xml.php?format=txt ini2xml.php converter script] and run it from the command line like
{{{
# php ini2xml.php /path/to/config_yourconfig.ini
}}}

It will then  create the corresponding XML file (like {{{ config_default.ini -> config_default.xml}}})

For more detailed information about the configuration of p.mapper v.4 see the docs at
   * [XmlFileSettings XML file settings]
   * [DocJsSettings JavaScript settings ]
     * [DocAdvancedJsSettings Advanced JavaScript settings]

----
[UpgradeOlderVersions Upgrade information for older versions see here]

----


= Upgrade Information for !MapServer versions =
== !MapServer 5.6.x ==
If using !MapServer 5.6 and PostGIS all p.mapper versions <= 4.0.0 will not work correctly for '''query operations''' due to substantial changes in the !MapScript API. p.mapper starting with 4.0.1 (and SVN trunk) is supposed to work correctly with this configuration. For older p.mapper versions you need to stick to older !MapServer <= 5.4.x versions or upgrade some files to the latest stable v3 branch, see [http://svn.pmapper.net/trac/changeset/998 this changeset] for details .


= Upgrade Information for PHP versions =
== PHP 5.3.x ==
In version 5.3 PHP has removed some functions used in p.mapper:

=== function {{{dl()}}} ===
PHP 5.3 cannot dynamically load any more extensions if missing in the compilation (UNIX/Linux) or not loaded via {{{php.ini}}} file (Windows, some Linux distros). This is the case for {{{pgsql}}} and {{{curl}}} extensions. So in this case you have to enable them via the {{{php.ini}}}.

=== dBase functions ===
PHP 5.3 does not any more support dBase functions. This means that some definitions for '''special search functionality''' (suggest, options) like
{{{
<definition type="suggest" connectiontype="dbase">
}}} 

will not work any more. You need to use the generic "ms" definition, like
{{{
<definition type="suggest" connectiontype="ms">
}}}
In addition, the export plugin cannot any more '''export to shapefiles''' since also for this dBase functions are required.

If you're also annoyed by this loss of functionality, please send a mail to the PHP maintainers to request this functions coming back.