For so long as I will bear in mind, I have been the use of the per-application mappings in ColdFusion to alias directories. After which, the use of the ones aliases to prefix record paths and CFInclude template paths. The day before today, on the other hand, as I used to be having a look at eating configuration information in ColdFusion, it passed off to me that per-application mappings may be able to do greater than supply prefixes—they may be able to alias complete record paths. I will’t consider this by no means passed off to me ahead of; so, I sought after to check out it out in each Adobe ColdFusion and Lucee CFML.

To check this, all I’ll do is create a per-application mapping, /app.conf, that issues to the textual content record, take a look at.txt:

element
	output = false
	trace = "I outline the applying settings and tournament handlers."
	{

	// Outline the applying settings.
	this.identify = "AppMappingsDemo";
	this.applicationTimeout = createTimeSpan( 0, 1, 0, 0 );
	this.sessionManagement = false;
	this.setClientCookies = false;

	this.listing = getDirectoryFromPath( getCurrentTemplatePath() );

	// On this exploration, I am making a per-application mapping without delay to a FILE -
	// to not a listing (which is what I most often do). Be aware that the trail and filename
	// don't seem to be a mirrored image of the place the record in reality is living at the server.
	this.mappings = {
		"/app.conf": ( this.listing & "../config/take a look at.txt" )
	};

}

As you’ll see, /app.conf maps to take a look at.txt, which in reality lives above the present listing. Be aware that my mapped trail contains the ../ relative traversal section.

Now, in a separate CFML record in the similar software, I am going to check out and skim the /app.conf record:

<cfscript>

	// Attempt to learn within the content material of the mapped record! Hang onto your butts!
	writeDump(
		label = "/app.conf knowledge",
		var = fileRead( expandPath( "/app.conf" ), "utf-8" )
	);

</cfscript>

Now, after we run this code in Lucee CFML, we get the next output:

Oh my chickens! It labored! I used to be in a position to learn the contents of the record by means of completely the use of the per-application mapping. This additionally works in Adobe ColdFusion; however, I’ll fail to remember the output of that have because it does not upload price to the dialog.

Apart: I will be able to point out, on the other hand, that Adobe ColdFusion most effective labored if I integrated the expandPath() portion of the code within the fileRead(); and, Lucee CFML works with out it. That stated, Lucee CFML is traditionally extra amenable to relative record paths.

Looking back, I did not have any reason why to consider that this would not paintings; most effective, that it by no means passed off to me and I by no means attempted it ahead of. With that stated, I’d warning that this code is a little “magical”; and, it will confuse long term builders who’re searching for /app.conf and can not seem to in finding it within the record device. So, in case you cross this direction, continue with warning.

Need to use code from this submit?
Take a look at the license.