.. _variable_sub:

*****************************************************************************
 Variable Substitution
*****************************************************************************

Syntax: '%' + Variablenname + '%'

**Example 1**. Sichere Verbindung zu einer Datenbank

Eine PostGIS Datenbank enthält sensible Daten. Der zu benutzende Benutzername
und das Passwort für die Datenbankverbindung werden in 2 Cookies ("uid" und 
"passwd") durch einen separaten Authentifizierungsmechanismus gespeichert.

.. code-block:: mapfile

  CONNECTION "user=%uid% password=%passwd% dbname=postgis"

**Example 2**. Temporäre Dateien verwenden

Es gibt eine Anwendung die Shapefiles in einem Benutzerverzeichnis auf dem
Server erzeugt. Der Benutzername "username" wird aus einem Cookie gelesen,
der Dateiname "filename" stammt aus einem Abfrageparameter.

.. code-block:: mapfile

  DATA "/home/%username%/tempshp/%filename%"

Dies ist nur für den CGI Modus von MapServer verfügbar, da hier ein Mapfile
Preprozessor zum Einsatz kommt. Wenn MapScript benutzt werden soll, muss dafür
die Logik zum Ersetzen der Variablen implementiert werden, indem ein eigener
Preprozessor geschrieben wird.