CFConfig

Background

CFConfig is a CommandBox module which allows most if not all of the CF / BoxLang settings for a server to be set via a JSON file rather than using the CFAdministrator. This makes it much easier to scaffold servers in various situations such as:

  • Keeping development environments up to date

  • Production servers with their own passwords / mappings / data sources etc

  • Development Environment

  • Containers

Some Examples

Mappings

  1. Create a folder outside of the root folder called JEMapps

  2. In JEMapps, create a text file called outsideroot.txt and put some text into it.

  3. From CommandBox, install install commandbox-cfconfig

  4. From CommandBox, from the root of the site, type cfconfig cfmapping save virtual=/JEMapps physical=path\to\JEMapps to=.cfconfig.json

  5. Type cat .cfconfig.json

  6. Restart your server with server restart

  7. In your index.cfm file, add:

    <cfdirectory directory="#expandpath('/JEMapps')#" name="listing" />
<cfdump var="#listing#" />
<cffile action="read" file="#expandpath('/JEMapps/outsideroot.txt')#" variable="read" />
<cfdump var="#read#" />

Datasources

From CommandBox, from the root of the site, type

cfconfig datasource save database=DATABASENAME dbdriver=mysql host=justenough.cyqisqc1fx3i.us-west-2.rds.amazonaws.com username=USERNAME password=PASSWORD port=3306 name=justEnough class=com.mysql.cj.jdbc.Driver to=.cfconfig.json

Restart the server ( server restart ). We're going to investigate that datasource more very soon but for now if there are no errors, the datasource is set up correctly.

PreviousSSLNextENV Files

Last updated