Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion en/MIGRATION_GUIDE.txt
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,25 @@
MapServer Migration Guide
*****************************************************************************

:Last Updated: 2025-11-19
:Last Updated: 2026-03-24

.. contents:: Table of Contents
:depth: 2
:backlinks: top

.. tip::

Review MapServer's `Security Policy <https://github.com/MapServer/MapServer/blob/main/SECURITY.md/>`__,
and also review any recent published `vulnerabilities <https://github.com/MapServer/MapServer/security/advisories?state=published/>`__.

.. _migration-8-6:

MapServer 8.4 to 8.6 Migration
==============================

- The 8.6.1 release includes a fix for a security flaw in the SLD parser
(see MapServer's `Security Advisory <https://github.com/MapServer/MapServer/security/advisories/GHSA-cv4m-mr84-fgjp>`__)

- You can now enable an automatically generated index page, that lists
all of your OGC services and endpoints, for each mapfile that you
defined in your CONFIG file. To enable the index, add `MS_INDEX_TEMPLATE_DIRECTORY`
Expand Down
9 changes: 7 additions & 2 deletions en/development/bugs.txt
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,11 @@ Please keep the following issues in mind when submitting a bug/issue:
Security/vulnerability reports should not be submitted through GitHub, but instead
please send your report to the email address:
`mapserver-security nospam @ osgeo.org` (remove the blanks and 'nospam').

.. tip::

Review MapServer's `Security Policy <https://github.com/MapServer/MapServer/blob/main/SECURITY.md/>`__,
and also review any recent published `vulnerabilities <https://github.com/MapServer/MapServer/security/advisories?state=published/>`__.

1. Set a meaningful yet reasonably brief title of your ticket.

Expand All @@ -36,15 +41,15 @@ Please keep the following issues in mind when submitting a bug/issue:

The most important thing when reporting a bug is to boil down a minimum
example that is needed to reproduce the bug. That means a minimal mapfile +
any data files it depends on. Remove everything from the map file that isn't
any data files it depends on. Remove everything from the mapfile that isn't
needed to reproduce the bug.

The developers often dislike having to spend the first 30 minutes working on a
bug, having to fix paths, remove unnecessary layers, removing references to
external symbols or fonts that were not included or even needed and otherwise
doctoring your test case to get it to a point when they can actually use it.

If the bug is easily demonstrated with ":ref:`map2img`", without the need to
If the bug is easily demonstrated with :ref:`map2img`, without the need to
setup a proper web service and test it through http, then please show it that
way. If a standalone :ref:`mapscript` script can demonstrate a problem without it
having to be a web service, likewise submit it that way. If your problem
Expand Down
7 changes: 6 additions & 1 deletion en/documentation.txt
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,12 @@
:height: 15
:width: 15
:alt: PDF icon
:target: https://download.osgeo.org/mapserver/docs/MapServer.pdf
:target: https://download.osgeo.org/mapserver/docs/MapServer.pdf

.. tip::

Review MapServer's `Security Policy <https://github.com/MapServer/MapServer/blob/main/SECURITY.md/>`__,
and also review any recent published `vulnerabilities <https://github.com/MapServer/MapServer/security/advisories?state=published/>`__.

Introduction
.......................................................
Expand Down
2 changes: 1 addition & 1 deletion en/mapscript/index.txt
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

Since the MapServer 8.0.0 release PHP support is only available through
MapServer's :ref:`SWIG API <swig>`. Supported versions are PHP 8.5 and
PHP 8.4 with MapServer 8.6.0
PHP 8.4 with MapServer 8.6.1

.. toctree::
:maxdepth: 2
Expand Down
2 changes: 1 addition & 1 deletion en/mapscript/mapscript-api/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ meaningless, and even dangerous attributes might be exposed by objects.

Since the MapServer 8.0.0 release PHP support is only available through
MapServer's :ref:`SWIG API <swig>`. Supported versions are PHP 8.5 and
PHP 8.4 with MapServer 8.6.0
PHP 8.4 with MapServer 8.6.1

=============================================================================
Appendices
Expand Down
4 changes: 2 additions & 2 deletions en/ogc/wms_client.txt
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

:Author: Jeff McKenna
:Contact: jmckenna at gatewaygeomatics.com
:Last Updated: 2024-07-08
:Last Updated: 2026-03-24

.. contents:: Table of Contents
:depth: 4
Expand Down Expand Up @@ -313,7 +313,7 @@ Optional Layer Parameters and Metadata
- basic
- digest
- ntlm
- any (the underlying http library picks the best among the opotions supported by the remote server)
- any (the underlying http library picks the best among the options supported by the remote server)
- anysafe (the underlying http library picks only safe methods among the options supported by the remote server)

.. code-block:: mapfile
Expand Down