Imports server configuration defineď based on the CFConfig schema.
This configuration can be provided as a path (String) to a JSON based file or as a Struct
.
The values inside the provided configuration can use placeholders, following this pattern ${key:default}.
The function will check for the actual values for this placeholders in 3 places (in this order):
- Function arguments "params" (if provided)
- System properties
- Environment variables
directory-placeholders will be passed thru and dynamically evaluated when used.
Introduced: 6.0.0.460
ConfigImport( path=any, type=string, password=string, params=struct, flushExistingData=boolean, charset=string );
Argument |
Description |
Default |
path
any,
required
|
Path to the .CFConfig.json file or the data itself as a Struct.
Alias:
path, data
|
|
type
string,
optional
|
Config Context to manipulate, server or web context.
|
server
|
password
string,
optional
|
Password to access the configuration, depending on the value set for the attribute type.
If not set Lucee will check in the following places for the password (replace {type} with the actual type chosen for the attribute type).
Environment variable "LUCEE_{type}_ADMIN_PASSWORD" or system property "lucee.{type}.admin.password".
|
|
params
struct,
optional
|
placeholder parameters to use as actual data for the placeholders inside the configuration, see main description of this function for more details.
|
|
flushExistingData
boolean,
optional
|
if true that existing data get replaced with the given data, if set to false they get updated.
|
|
charset
string,
optional
|
charset to use to read the .CFConfig file, if not defined, Lucee will use the default resource charset.
|
|
Examples
There are currently no examples for this function
28,298ms WARN No examples for function ConfigImport
See also