<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
span.EmailStyle20
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;
mso-ligatures:none;}
@page WordSection1
{size:8.5in 11.0in;
margin:70.85pt 56.7pt 70.85pt 56.7pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="#0563C1" vlink="#954F72" style="word-wrap:break-word">
<div class="WordSection1">
<p class="MsoNormal">Hi Jukka: Yeah, this is a potential area for improvement. We’ve be using a couple of strategies where I work. One being includes plus runtime subs so you can embed replacement strings as necessary, similar to your examples. The environment
file gets included in a validation block and you set both a default and validation patterns for each value:<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"> “dbhost_default” “some.database.host”<o:p></o:p></p>
<p class="MsoNormal"> “dbhost” “^some\.database\.host$”<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">So dbhost can only be the one value. I feels cleaner just write things the way you suggest. However, it feels wrong to have to set a value twice – and is potentially error prone in a bad way. Plus, there’s no connection to the environment.
I’m not a huge fan.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The other approach is using a pre-processor to essentially compile a mapfile into a final version. We’re using YAML + mappyfile to create an environment-specific version of the mapfile. The YAML definition can consist of constants plus
references to environment variables. There is loads of potential here but deployment in different environments requires a compilation step plus a working Python environment.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">So, I can see value in a VARIABLES block or reference to a file. Could also do that at the config file level instead. Beyond loading the hash somehow, one would need a method to apply the variables in a limited fashion, probably while the
mapfile is being parsed. So, load the DATA value and then apply variables or something like that.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">This warrants an RFC I think…<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">--Steve<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div style="border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b>From:</b> MapServer-dev <mapserver-dev-bounces@lists.osgeo.org>
<b>On Behalf Of </b>Rahkonen Jukka via MapServer-dev<br>
<b>Sent:</b> Thursday, November 9, 2023 5:08 PM<br>
<b>To:</b> 'mapserver-dev@lists.osgeo.org' <mapserver-dev@lists.osgeo.org><br>
<b>Subject:</b> [MapServer-dev] Variables in mapfiles<o:p></o:p></p>
</div>
</div>
<p class="MsoNormal"><span lang="FI"><o:p> </o:p></span></p>
<div>
<p class="MsoNormal"><span lang="FI">Hi,<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="FI"><o:p> </o:p></span></p>
<p class="MsoNormal">When I was reading the old bug reports in the OSGeo code sprint this 20 years old one
<a href="https://github.com/MapServer/MapServer/issues/408">https://github.com/MapServer/MapServer/issues/408</a> from year 2003 did not feel rotten at all. And the last comment
<a href="https://github.com/MapServer/MapServer/issues/408#issuecomment-1065080140">
https://github.com/MapServer/MapServer/issues/408#issuecomment-1065080140</a> has received 5 thumbs up within 1 year which shows great user activity by our standards.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">I think that environmental variables may be too strong tool for this purpose. For example, are those who write mapfiles allowed to set env variables in managed environments? Maybe something similar to SYMBOLSET and INCLUDE would be easier
to use.<o:p></o:p></p>
<p class="MsoNormal">As an example, I found a pretty good bug report that includes a mapfile and data, but for testing the mapfile on my Windows machine I need to make a few edits.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">CONFIG "PROJ_LIB" "/usr/local/share/proj"<o:p></o:p></p>
<p class="MsoNormal"> I am on Windows and my proj is in some other place<o:p></o:p></p>
<p class="MsoNormal">WMS_ONLINERESOURCE <a href="http://odroid1:5001/">http://odroid1:5001/</a><o:p></o:p></p>
<p class="MsoNormal">wms_service_onlineresource <a href="http://odroid1:5001/">http://odroid1:5001/</a><o:p></o:p></p>
<p class="MsoNormal"> I don’t understand the difference between those two, but anyway I run Mapserver at
<a href="http://localhost:8060/...">http://localhost:8060/...</a><o:p></o:p></p>
<p class="MsoNormal">DATA "./bug-report.xml"<o:p></o:p></p>
<p class="MsoNormal"> I prefer to keep data in different place than mapfiles<o:p></o:p></p>
<p class="MsoNormal">DATA "./data-in-31287"<o:p></o:p></p>
<p class="MsoNormal"> Same for this shapefile data<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">What if we could write non-fixed paths and other items into the mapfile like<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">CONFIG "PROJ_LIB" "%proj_lib%"<o:p></o:p></p>
<p class="MsoNormal">WMS_ONLINERESOURCE "%onlineresource_test%"<o:p></o:p></p>
<p class="MsoNormal">wms_service_onlineresource "%onlineresource_test%"<o:p></o:p></p>
<p class="MsoNormal">DATA "%datapath_test%/bug-report.xml"<o:p></o:p></p>
<p class="MsoNormal">DATA "%datapath_test%/data-in-31287"<o:p></o:p></p>
<p class="MsoNormal">….<o:p></o:p></p>
<p class="MsoNormal">MAPVARIABLES "map_variables.txt"<o:p></o:p></p>
<p class="MsoNormal">END # mapfile<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The contents of "map_variables.txt"<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">//Some magic<o:p></o:p></p>
<p class="MsoNormal">proj_lib [value]<o:p></o:p></p>
<p class="MsoNormal">onlineresource_test [value]<o:p></o:p></p>
<p class="MsoNormal">onlineresource_qa [value]<o:p></o:p></p>
<p class="MsoNormal">onlineresourse_production [value]<o:p></o:p></p>
<p class="MsoNormal">datapath_test [value]<o:p></o:p></p>
<p class="MsoNormal">datapath_qa [value]<o:p></o:p></p>
<p class="MsoNormal">datapath_production [value]<o:p></o:p></p>
<p class="MsoNormal">symbolset_topomap [value]<o:p></o:p></p>
<p class="MsoNormal">symbolset_citymap [value]<o:p></o:p></p>
<p class="MsoNormal">etc.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">A difference to INCLUDE is that while the whole include file is slipped inside the mapfile the variable file could be a dictionary. That would allow forwarding the mapfile from test to qa to production easily. And when the IP address of
test servers change an edit in one place would be enough. It would still be possible to use separate "map_variables_testing.txt" for testing if it feels better.
<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">I admit that there are alternative scenarios via INCLUDE or config file or environmental variables.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">-Jukka Rahkonen-<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
</body>
</html>