Configuration: Lucee Directory Placeholders
Directory Placeholders
In order to make configuring Lucee a little easier, there are several constants (we call them "directory placeholders") that contain a certain value which might change depending on the system, the environment or the context.
Available Directory Placeholders
Here are the available placeholders in Lucee:
| Directory Placeholder | Description |
|---|---|
| {lucee-web} | Path to the Lucee web directory, usually {web-root}/WEB-INF/lucee. |
| {lucee-server} | Path to the Lucee server directory, usually where the lucee.jar is located |
| {lucee-config} | This is the same as {lucee-server} in server context and the same as {lucee-web} in web context. |
| {temp-directory} | Path to the temp directory of the current user of the system. |
| {home-directory} | Path to the home directory of the current user of the system. |
| {web-root-directory} | Path to the web root. |
| {system-directory} | Path to the system directory. |
| {web-context-hash} | Hash of the web context. |
| {web-context-label} | A label for the web context. See A note on {web-context-label} below. |
Directory Placeholders in CFML
You can reference the directory placeholders in your CFML code like this:
<cfdump var="#expandPath('{lucee-web-root}')#">
A note on {web-context-label}
If you have configured Lucee to generate the configuration directories using the {web-context-hash}, you may have wished that the resulting hashed directories were a little more readable. You'll end up with a list of directories named with a hash value that is 32 bytes long. This is far from readable.
Therefore, in Lucee 3.3, we introduced a new directory placeholder: {web-context-label}. Now you have the opportunity to use a label as a path to the configuration files for each web context. In order to use this label, you need to define it in every lucee-web.xml.cfm in every configuration directory.
As of Lucee 4.0.2.002 final, you can update the {web-context-label} through the Server Administrator. After you've logged in to [domain]/lucee/admin/server.cfm, you will see a section marked "Web Contexts" at the bottom of the page. Here you can modify your labels and click the update button to save the changes.