6use InvalidArgumentException;
10use UnexpectedValueException;
89 'LateJSConfigVarNames',
90 'TempUserSerialProviders',
91 'TempUserSerialMappings',
92 'DatabaseVirtualDomains',
93 'UserOptionsStoreProviders',
94 'NotificationHandlers',
95 'NotificationMiddleware',
105 'wgAddGroups' =>
'array_merge_recursive',
106 'wgAuthManagerAutoConfig' =>
'array_plus_2d',
107 'wgCapitalLinkOverrides' =>
'array_plus',
108 'wgExtraGenderNamespaces' =>
'array_plus',
109 'wgGrantPermissions' =>
'array_plus_2d',
110 'wgGroupPermissions' =>
'array_plus_2d',
111 'wgHooks' =>
'array_merge_recursive',
112 'wgNamespaceContentModels' =>
'array_plus',
113 'wgNamespaceProtection' =>
'array_plus',
114 'wgNamespacesWithSubpages' =>
'array_plus',
115 'wgPasswordPolicy' =>
'array_merge_recursive',
116 'wgRateLimits' =>
'array_plus_2d',
117 'wgRemoveGroups' =>
'array_merge_recursive',
118 'wgRevokePermissions' =>
'array_plus_2d',
144 'load_composer_autoloader',
149 'AutoloadNamespaces',
150 'ExtensionMessagesFiles',
151 'TranslationAliasesDirs',
152 'ForeignResourcesDir',
154 'DomainEventIngresses',
155 'MessagePosterModule',
159 'ResourceFileModulePaths',
160 'ResourceModuleSkinStyles',
162 'ServiceWiringFiles',
173 'wgExtensionMessagesFiles' => [],
174 'wgRestAPIAdditionalRouteFiles' => [],
175 'wgMessagesDirs' => [],
176 'TranslationAliasesDirs' => [],
249 $json = file_get_contents(
$path );
250 $info = json_decode( $json,
true );
253 throw new RuntimeException(
"Failed to load JSON data from $path" );
256 $this->
extractInfo( $path, $info, $info[
'manifest_version'] );
265 $dir = dirname(
$path );
278 if ( isset( $info[
'ServiceWiringFiles'] ) ) {
280 'wgServiceWiringFiles',
282 $info[
'ServiceWiringFiles']
286 if ( isset( $info[
'callback'] ) ) {
287 $this->callbacks[$name] = $info[
'callback'];
290 $this->extractAutoload( $info, $dir );
294 if ( $version >= 2 ) {
302 if ( isset( $info[
'ParsoidModules'] ) ) {
303 foreach ( $info[
'ParsoidModules'] as &$module ) {
304 if ( is_string( $module ) ) {
305 $className = $module;
307 'class' => $className,
310 $module[
'name'] ??= $name;
316 if ( $version >= 2 ) {
320 foreach ( $info as $key => $val ) {
322 if ( in_array( $key, self::$globalSettings ) ) {
327 if ( $key[0] ===
'@' ) {
331 if ( $version >= 2 ) {
333 if ( in_array( $key, self::CORE_ATTRIBS ) ) {
334 $this->
storeToArray( $path, $key, $val, $this->attributes );
338 if ( !in_array( $key, self::NOT_ATTRIBS )
339 && !in_array( $key, self::CREDIT_ATTRIBS )
353 if ( isset( $info[
'attributes'] ) ) {
354 foreach ( $info[
'attributes'] as $extName => $value ) {
362 foreach ( $this->globals as $key => $val ) {
363 if ( isset( self::MERGE_STRATEGIES[$key] ) ) {
369 foreach ( $this->extAttributes as $extName => $value ) {
371 if ( isset( $this->credits[$extName] ) ) {
372 foreach ( $value as $attrName => $attrValue ) {
375 $extName . $attrName,
380 unset( $this->extAttributes[$extName] );
393 'autoloaderClasses' =>
$autoload[
'classes'],
394 'autoloaderNS' =>
$autoload[
'namespaces'],
400 if ( !$includeDev || !isset( $info[
'dev-requires'] ) ) {
401 return $info[
'requires'] ?? [];
404 if ( !isset( $info[
'requires'] ) ) {
405 return $info[
'dev-requires'] ?? [];
415 $pick =
static function ( $a, $b ) {
418 } elseif ( $b ===
null ) {
425 $req = $info[
'requires'];
426 $dev = $info[
'dev-requires'];
427 if ( isset( $req[
'MediaWiki'] ) || isset( $dev[
'MediaWiki'] ) ) {
428 $merged[
'MediaWiki'] = $pick(
429 $req[
'MediaWiki'] ??
null,
430 $dev[
'MediaWiki'] ??
null
434 $platform = array_merge(
435 array_keys( $req[
'platform'] ?? [] ),
436 array_keys( $dev[
'platform'] ?? [] )
439 foreach ( $platform as $pkey ) {
440 if ( $pkey ===
'php' ) {
442 $req[
'platform'][
'php'] ??
null,
443 $dev[
'platform'][
'php'] ??
null
448 $value = $dev[
'platform'][$pkey] ?? $req[
'platform'][$pkey];
450 $merged[
'platform'][$pkey] = $value;
454 foreach ( [
'extensions',
'skins' ] as $thing ) {
455 $things = array_merge(
456 array_keys( $req[$thing] ?? [] ),
457 array_keys( $dev[$thing] ?? [] )
459 foreach ( $things as $name ) {
460 $merged[$thing][$name] = $pick(
461 $req[$thing][$name] ??
null,
462 $dev[$thing][$name] ??
null
482 private function setArrayHookHandler(
484 array $hookHandlersAttr,
488 if ( isset( $callback[
'handler'] ) ) {
489 $handlerName = $callback[
'handler'];
490 $handlerDefinition = $hookHandlersAttr[$handlerName] ??
false;
491 if ( !$handlerDefinition ) {
492 throw new UnexpectedValueException(
493 "Missing handler definition for $name in HookHandlers attribute in $path"
496 $callback[
'handler'] = $handlerDefinition;
497 $callback[
'extensionPath'] =
$path;
498 $this->attributes[
'Hooks'][$name][] = $callback;
500 foreach ( $callback as $callable ) {
501 if ( is_array( $callable ) ) {
502 if ( isset( $callable[
'handler'] ) ) {
503 $this->setArrayHookHandler( $callable, $hookHandlersAttr, $name,
$path );
505 $this->globals[
'wgHooks'][$name][] = $callable;
507 } elseif ( is_string( $callable ) ) {
508 $this->setStringHookHandler( $callable, $hookHandlersAttr, $name,
$path );
524 private function setStringHookHandler(
526 array $hookHandlersAttr,
530 if ( isset( $hookHandlersAttr[$callback] ) ) {
532 'handler' => $hookHandlersAttr[$callback],
533 'extensionPath' =>
$path
535 $this->attributes[
'Hooks'][$name][] = $handler;
537 $this->globals[
'wgHooks'][$name][] = $callback;
550 $extName = $info[
'name'];
551 if ( isset( $info[
'Hooks'] ) ) {
552 $hookHandlersAttr = [];
553 foreach ( $info[
'HookHandlers'] ?? [] as $name => $def ) {
554 $hookHandlersAttr[$name] = [
'name' =>
"$extName-$name" ] + $def;
556 foreach ( $info[
'Hooks'] as $name => $callback ) {
557 if ( is_string( $callback ) ) {
558 $this->setStringHookHandler( $callback, $hookHandlersAttr, $name,
$path );
559 } elseif ( is_array( $callback ) ) {
560 $this->setArrayHookHandler( $callback, $hookHandlersAttr, $name,
$path );
564 if ( isset( $info[
'DeprecatedHooks'] ) ) {
565 $deprecatedHooks = [];
566 foreach ( $info[
'DeprecatedHooks'] as $name => $deprecatedHookInfo ) {
567 $deprecatedHookInfo += [
'component' => $extName ];
568 $deprecatedHooks[$name] = $deprecatedHookInfo;
570 if ( isset( $this->attributes[
'DeprecatedHooks'] ) ) {
571 $this->attributes[
'DeprecatedHooks'] += $deprecatedHooks;
573 $this->attributes[
'DeprecatedHooks'] = $deprecatedHooks;
585 $this->attributes[
'DomainEventIngresses'] ??= [];
586 foreach ( $info[
'DomainEventIngresses'] ?? [] as $subscriber ) {
587 $subscriber[
'extensionPath'] =
$path;
588 $this->attributes[
'DomainEventIngresses'][] = $subscriber;
596 if ( isset( $info[
'namespaces'] ) ) {
597 foreach ( $info[
'namespaces'] as $ns ) {
598 if ( defined( $ns[
'constant'] ) ) {
601 $id = constant( $ns[
'constant'] );
605 $this->defines[ $ns[
'constant'] ] = $id;
607 if ( !( isset( $ns[
'conditional'] ) && $ns[
'conditional'] ) ) {
609 $this->attributes[
'ExtensionNamespaces'][$id] = $ns[
'name'];
611 if ( isset( $ns[
'movable'] ) && !$ns[
'movable'] ) {
612 $this->attributes[
'ImmovableNamespaces'][] = $id;
614 if ( isset( $ns[
'gender'] ) ) {
615 $this->globals[
'wgExtraGenderNamespaces'][$id] = $ns[
'gender'];
617 if ( isset( $ns[
'subpages'] ) && $ns[
'subpages'] ) {
618 $this->globals[
'wgNamespacesWithSubpages'][$id] =
true;
620 if ( isset( $ns[
'content'] ) && $ns[
'content'] ) {
621 $this->globals[
'wgContentNamespaces'][] = $id;
623 if ( isset( $ns[
'defaultcontentmodel'] ) ) {
624 $this->globals[
'wgNamespaceContentModels'][$id] = $ns[
'defaultcontentmodel'];
626 if ( isset( $ns[
'protection'] ) ) {
627 $this->globals[
'wgNamespaceProtection'][$id] = $ns[
'protection'];
629 if ( isset( $ns[
'capitallinkoverride'] ) ) {
630 $this->globals[
'wgCapitalLinkOverrides'][$id] = $ns[
'capitallinkoverride'];
632 if ( isset( $ns[
'includable'] ) && !$ns[
'includable'] ) {
633 $this->globals[
'wgNonincludableNamespaces'][] = $id;
640 $defaultPaths = $info[
'ResourceFileModulePaths'] ??
false;
641 if ( isset( $defaultPaths[
'localBasePath'] ) ) {
642 if ( $defaultPaths[
'localBasePath'] ===
'' ) {
644 $defaultPaths[
'localBasePath'] = $dir;
646 $defaultPaths[
'localBasePath'] =
"$dir/{$defaultPaths['localBasePath']}";
650 foreach ( [
'ResourceModules',
'ResourceModuleSkinStyles',
'OOUIThemePaths' ] as $setting ) {
651 if ( isset( $info[$setting] ) ) {
652 foreach ( $info[$setting] as $name => $data ) {
653 if ( isset( $data[
'localBasePath'] ) ) {
654 if ( $data[
'localBasePath'] ===
'' ) {
656 $data[
'localBasePath'] = $dir;
658 $data[
'localBasePath'] =
"$dir/{$data['localBasePath']}";
661 if ( $defaultPaths ) {
662 $data += $defaultPaths;
664 $this->attributes[$setting][$name] = $data;
669 if ( isset( $info[
'QUnitTestModule'] ) ) {
670 $data = $info[
'QUnitTestModule'];
671 if ( isset( $data[
'localBasePath'] ) ) {
672 if ( $data[
'localBasePath'] ===
'' ) {
674 $data[
'localBasePath'] = $dir;
676 $data[
'localBasePath'] =
"$dir/{$data['localBasePath']}";
679 $this->attributes[
'QUnitTestModule'][
"test.{$info['name']}"] = $data;
682 if ( isset( $info[
'MessagePosterModule'] ) ) {
683 $data = $info[
'MessagePosterModule'];
684 $basePath = $data[
'localBasePath'] ??
'';
685 $baseDir = $basePath ===
'' ? $dir :
"$dir/$basePath";
686 foreach ( $data[
'scripts'] ?? [] as $scripts ) {
687 $this->attributes[
'MessagePosterModule'][
'scripts'][] =
690 foreach ( $data[
'dependencies'] ?? [] as $dependency ) {
691 $this->attributes[
'MessagePosterModule'][
'dependencies'][] = $dependency;
697 if ( isset( $info[
'ExtensionMessagesFiles'] ) ) {
698 foreach ( $info[
'ExtensionMessagesFiles'] as &$file ) {
699 $file =
"$dir/$file";
701 $this->globals[
"wgExtensionMessagesFiles"] += $info[
'ExtensionMessagesFiles'];
707 if ( isset( $info[
'RestModuleFiles'] ) ) {
708 foreach ( $info[
'RestModuleFiles'] as &$file ) {
709 $this->globals[
"wg$var"][] =
"$dir/$file";
722 if ( isset( $info[
'MessagesDirs'] ) ) {
723 foreach ( $info[
'MessagesDirs'] as $name => $files ) {
724 foreach ( (array)$files as $file ) {
725 $this->globals[
"wgMessagesDirs"][$name][] =
"$dir/$file";
739 foreach ( $info[
'TranslationAliasesDirs'] ?? [] as $name => $files ) {
740 foreach ( (array)$files as $file ) {
741 $this->globals[
'wgTranslationAliasesDirs'][$name][] =
"$dir/$file";
753 if ( isset( $info[
'ValidSkinNames'] ) ) {
754 foreach ( $info[
'ValidSkinNames'] as $skinKey => $data ) {
755 if ( isset( $data[
'args'][0] ) ) {
756 $templateDirectory = $data[
'args'][0][
'templateDirectory'] ??
'templates';
757 $data[
'args'][0][
'templateDirectory'] = $dir .
'/' . $templateDirectory;
759 $this->globals[
'wgValidSkinNames'][$skinKey] = $data;
772 if ( isset( $info[
'RateLimits'] ) ) {
773 $rights = array_keys( $info[
'RateLimits'] );
775 if ( isset( $info[
'AvailableRights'] ) ) {
776 $rights = array_diff( $rights, $info[
'AvailableRights'] );
779 $this->globals[
'wgImplicitRights'] = array_merge(
780 $this->globals[
'wgImplicitRights'] ?? [],
791 if ( isset( $info[
'SkinLessImportPaths'] ) ) {
792 foreach ( $info[
'SkinLessImportPaths'] as $skin => $subpath ) {
793 $this->attributes[
'SkinLessImportPaths'][$skin] =
"$dir/$subpath";
810 foreach ( self::CREDIT_ATTRIBS as $attr ) {
811 if ( isset( $info[$attr] ) ) {
820 if ( isset( $this->credits[$name] ) ) {
821 $firstPath = $this->credits[$name][
'path'];
823 throw new InvalidArgumentException(
824 "It was attempted to load $name twice, from $firstPath and $secondPath."
834 if ( array_key_exists(
'ForeignResourcesDir', $info ) ) {
835 if ( !is_string( $info[
'ForeignResourcesDir'] ) ) {
836 throw new InvalidArgumentException(
"Incorrect ForeignResourcesDir type, must be a string (in $name)" );
838 $this->attributes[
'ForeignResourcesDir'][$name] =
"{$dir}/{$info['ForeignResourcesDir']}";
843 if ( isset( $info[
'InstallerTasks'] ) ) {
846 $schemaBasePath =
$path .
'/sql';
847 foreach ( $info[
'InstallerTasks'] as $taskSpec ) {
848 $this->attributes[
'InstallerTasks'][]
849 = $taskSpec + [
'schemaBasePath' => $schemaBasePath ];
862 if ( isset( $info[
'config'] ) ) {
863 if ( isset( $info[
'config'][
'_prefix'] ) ) {
864 $prefix = $info[
'config'][
'_prefix'];
865 unset( $info[
'config'][
'_prefix'] );
869 foreach ( $info[
'config'] as $key => $val ) {
870 if ( $key[0] !==
'@' ) {
871 $this->addConfigGlobal(
"$prefix$key", $val, $info[
'name'] );
885 private function applyPath( array $value,
string $dir ): array {
888 foreach ( $value as $k => $v ) {
889 $result[$k] = $dir .
'/' . $v;
904 $prefix = $info[
'config_prefix'] ??
'wg';
905 if ( isset( $info[
'config'] ) ) {
906 foreach ( $info[
'config'] as $key => $data ) {
907 if ( !array_key_exists(
'value', $data ) ) {
908 throw new UnexpectedValueException(
"Missing value for config $key" );
911 $value = $data[
'value'];
912 if ( isset( $data[
'path'] ) && $data[
'path'] ) {
913 if ( is_array( $value ) ) {
914 $value = $this->applyPath( $value, $dir );
916 $value =
"$dir/$value";
919 if ( isset( $data[
'merge_strategy'] ) ) {
920 $value[ExtensionRegistry::MERGE_STRATEGY] = $data[
'merge_strategy'];
922 $this->addConfigGlobal(
"$prefix$key", $value, $info[
'name'] );
923 $data[
'providedby'] = $info[
'name'];
924 if ( isset( $info[
'ConfigRegistry'][0] ) ) {
925 $data[
'configregistry'] = array_keys( $info[
'ConfigRegistry'] )[0];
938 private function addConfigGlobal( $key, $value, $extName ) {
939 if ( array_key_exists( $key, $this->globals ) ) {
940 throw new RuntimeException(
941 "The configuration setting '$key' was already set by MediaWiki core or"
942 .
" another extension, and cannot be set again by $extName." );
944 if ( isset( $value[ExtensionRegistry::MERGE_STRATEGY] ) &&
945 $value[ExtensionRegistry::MERGE_STRATEGY] ===
'array_merge_recursive' ) {
947 "Using the array_merge_recursive merge strategy in extension.json and skin.json" .
948 " was deprecated in MediaWiki 1.42",
952 $this->globals[$key] = $value;
956 foreach ( $paths as
$path ) {
957 $this->globals[$global][] =
"$dir/$path";
971 if ( !is_array( $value ) ) {
972 throw new InvalidArgumentException(
"The value for '$name' should be an array (from $path)" );
974 if ( isset( $array[$name] ) ) {
975 $array[$name] = array_merge_recursive( $array[$name], $value );
977 $array[$name] = $value;
992 if ( !is_array( $value ) ) {
993 throw new InvalidArgumentException(
"The value for '$name' should be an array (from $path)" );
995 if ( isset( $array[$name] ) ) {
996 $array[$name] = array_merge( $array[$name], $value );
998 $array[$name] = $value;
1017 $autoload = $this->autoload;
1019 if ( $includeDev ) {
1020 $autoload[
'classes'] += $this->autoloadDev[
'classes'];
1021 $autoload[
'namespaces'] += $this->autoloadDev[
'namespaces'];
1026 if ( !empty( $this->autoloadDev[
'files'] ) ) {
1029 $autoload[
'files'] = array_merge(
1031 $this->autoloadDev[
'files']
1039 private function extractAutoload( array $info,
string $dir ) {
1040 if ( isset( $info[
'load_composer_autoloader'] ) && $info[
'load_composer_autoloader'] ===
true ) {
1041 $file =
"$dir/vendor/autoload.php";
1042 if ( file_exists( $file ) ) {
1043 $this->autoload[
'files'][] = $file;
1047 if ( isset( $info[
'AutoloadClasses'] ) ) {
1048 $paths = $this->applyPath( $info[
'AutoloadClasses'], $dir );
1049 $this->autoload[
'classes'] += $paths;
1052 if ( isset( $info[
'AutoloadNamespaces'] ) ) {
1053 $paths = $this->applyPath( $info[
'AutoloadNamespaces'], $dir );
1054 $this->autoload[
'namespaces'] += $paths;
1057 if ( isset( $info[
'TestAutoloadClasses'] ) ) {
1058 $paths = $this->applyPath( $info[
'TestAutoloadClasses'], $dir );
1059 $this->autoloadDev[
'classes'] += $paths;
1062 if ( isset( $info[
'TestAutoloadNamespaces'] ) ) {
1063 $paths = $this->applyPath( $info[
'TestAutoloadNamespaces'], $dir );
1064 $this->autoloadDev[
'namespaces'] += $paths;
1070class_alias( ExtensionProcessor::class,
'ExtensionProcessor' );
wfDeprecatedMsg( $msg, $version=false, $component=false, $callerOffset=2)
Log a deprecation warning with arbitrary message text.
if(!defined('MW_SETUP_CALLBACK'))
A class containing constants representing the names of configuration variables.
const HiddenPrefs
Name constant for the HiddenPrefs setting, for use with Config::get()
const DefaultUserOptions
Name constant for the DefaultUserOptions setting, for use with Config::get()
const FeedClasses
Name constant for the FeedClasses setting, for use with Config::get()
const AvailableRights
Name constant for the AvailableRights setting, for use with Config::get()
const APIListModules
Name constant for the APIListModules setting, for use with Config::get()
const APIFormatModules
Name constant for the APIFormatModules setting, for use with Config::get()
const ImplicitGroups
Name constant for the ImplicitGroups setting, for use with Config::get()
const RemoveCredentialsBlacklist
Name constant for the RemoveCredentialsBlacklist setting, for use with Config::get()
const LogRestrictions
Name constant for the LogRestrictions setting, for use with Config::get()
const ExtensionFunctions
Name constant for the ExtensionFunctions setting, for use with Config::get()
const ActionFilteredLogs
Name constant for the ActionFilteredLogs setting, for use with Config::get()
const RevokePermissions
Name constant for the RevokePermissions setting, for use with Config::get()
const RecentChangesFlags
Name constant for the RecentChangesFlags setting, for use with Config::get()
const GroupsRemoveFromSelf
Name constant for the GroupsRemoveFromSelf setting, for use with Config::get()
const Actions
Name constant for the Actions setting, for use with Config::get()
const CentralIdLookupProviders
Name constant for the CentralIdLookupProviders setting, for use with Config::get()
const ExtensionEntryPointListFiles
Name constant for the ExtensionEntryPointListFiles setting, for use with Config::get()
const APIModules
Name constant for the APIModules setting, for use with Config::get()
const LogNames
Name constant for the LogNames setting, for use with Config::get()
const SpecialPages
Name constant for the SpecialPages setting, for use with Config::get()
const UserRegistrationProviders
Name constant for the UserRegistrationProviders setting, for use with Config::get()
const AuthManagerAutoConfig
Name constant for the AuthManagerAutoConfig setting, for use with Config::get()
const FilterLogTypes
Name constant for the FilterLogTypes setting, for use with Config::get()
const LogTypes
Name constant for the LogTypes setting, for use with Config::get()
const ResourceLoaderSources
Name constant for the ResourceLoaderSources setting, for use with Config::get()
const LogHeaders
Name constant for the LogHeaders setting, for use with Config::get()
const JobClasses
Name constant for the JobClasses setting, for use with Config::get()
const RateLimits
Name constant for the RateLimits setting, for use with Config::get()
const MediaHandlers
Name constant for the MediaHandlers setting, for use with Config::get()
const OutputPipelineStages
Name constant for the OutputPipelineStages setting, for use with Config::get()
const GrantRiskGroups
Name constant for the GrantRiskGroups setting, for use with Config::get()
const GrantPermissionGroups
Name constant for the GrantPermissionGroups setting, for use with Config::get()
const GroupPermissions
Name constant for the GroupPermissions setting, for use with Config::get()
const AddGroups
Name constant for the AddGroups setting, for use with Config::get()
const ConfigRegistry
Name constant for the ConfigRegistry setting, for use with Config::get()
const FileExtensions
Name constant for the FileExtensions setting, for use with Config::get()
const SessionProviders
Name constant for the SessionProviders setting, for use with Config::get()
const RawHtmlMessages
Name constant for the RawHtmlMessages setting, for use with Config::get()
const LogActionsHandlers
Name constant for the LogActionsHandlers setting, for use with Config::get()
const LogActions
Name constant for the LogActions setting, for use with Config::get()
const APIPropModules
Name constant for the APIPropModules setting, for use with Config::get()
const PrivilegedGroups
Name constant for the PrivilegedGroups setting, for use with Config::get()
const APIMetaModules
Name constant for the APIMetaModules setting, for use with Config::get()
const GroupsAddToSelf
Name constant for the GroupsAddToSelf setting, for use with Config::get()
const ContentHandlers
Name constant for the ContentHandlers setting, for use with Config::get()
const GrantPermissions
Name constant for the GrantPermissions setting, for use with Config::get()
const ChangeCredentialsBlacklist
Name constant for the ChangeCredentialsBlacklist setting, for use with Config::get()
const ReauthenticateTime
Name constant for the ReauthenticateTime setting, for use with Config::get()
const RemoveGroups
Name constant for the RemoveGroups setting, for use with Config::get()
const PasswordPolicy
Name constant for the PasswordPolicy setting, for use with Config::get()
const ConditionalUserOptions
Name constant for the ConditionalUserOptions setting, for use with Config::get()
const RestAPIAdditionalRouteFiles
Name constant for the RestAPIAdditionalRouteFiles setting, for use with Config::get()