Holds ProcessWire configuration settings as defined in /wire/config.php and /site/config.php.
For more detailed descriptions of these $config properties, including default values, see the /wire/config.php file.
Click any linked item for full usage details and examples. Hookable methods are indicated with the icon. In addition to those shown below, the Config class also inherits all the methods and properties of: WireData and Wire.
- Common
- Date time
- URLs
- Paths
- Js
- Tools
- Runtime
- HTTP and input
- System
- Template files
- Files
- Session
- Images
- Database
- Modules
- Admin
- System IDs
Common
| Name | Return | Summary | |
|---|---|---|---|
$config->AdminThemeUikit() $config->AdminThemeUikit() $config->AdminThemeUikit($key = '', $value = null) | array string bool | Can also be used as property: $config->AdminThemeUikit | |
$config->contentTypes() $config->contentTypes() $config->contentTypes($key = '', $value = null) | array string | Can also be used as property: $config->contentTypes | |
$config->fileCompilerOptions() $config->fileCompilerOptions() $config->fileCompilerOptions($key = '', $value = null) | array string bool | Can also be used as property: $config->fileCompilerOptions | |
$config->fileContentTypes() $config->fileContentTypes() $config->fileContentTypes($key = '', $value = null) | array string | Can also be used as property: $config->fileContentTypes | |
$config->imageSizerOptions() $config->imageSizerOptions() $config->imageSizerOptions($key = '', $value = null) | array bool string int float | Can also be used as property: $config->imageSizerOptions | |
$config->imageSizes() $config->imageSizes() $config->imageSizes($key = '', $value = null) | array | Can also be used as property: $config->imageSizes | |
$config->markupQA() $config->markupQA() $config->markupQA($key = '', $value = null) | array bool | Can also be used as property: $config->markupQA | |
$config->modals() $config->modals() $config->modals($key = '', $value = null) | array string | Can also be used as property: $config->modals | |
$config->moduleInstall() $config->moduleInstall() $config->moduleInstall($key = '', $value = null) | array string | Can also be used as property: $config->moduleInstall | |
$config->pageAdd() $config->pageAdd() $config->pageAdd($key = '', $value = null) | array string | Can also be used as property: $config->pageAdd | |
$config->pageEdit() $config->pageEdit() $config->pageEdit($key = '', $value = null) | array bool | Can also be used as property: $config->pageEdit | |
$config->pageList() $config->pageList() $config->pageList($key = '', $value = null) | array int bool | Can also be used as property: $config->pageList | |
$config->statusFiles() $config->statusFiles() $config->statusFiles($key = '', $value = null) | array string | Can also be used as property: $config->statusFiles | |
$config->substituteModules() $config->substituteModules() $config->substituteModules($key = '', $value = null) | array string | Can also be used as property: $config->substituteModules | |
$config->webpOptions() $config->webpOptions() $config->webpOptions($key = '', $value = null) | array int bool | Can also be used as property: $config->webpOptions | |
$config->wireMail() $config->wireMail() $config->wireMail($key = '', $value = null) | array string | Can also be used as property: $config->wireMail |
Date time
| Name | Return | Summary | |
|---|---|---|---|
| $config->dateFormat | string | Default system date format, preferably in sortable string format. Default is 'Y-m-d H:i:s' | |
| $config->timezone | string | Current timezone using PHP timeline options: http://php.net/manual/en/timezones.php |
URLs
| Name | Return | Summary | |
|---|---|---|---|
| $config->longUrlResponse | int | Response code when URL segments, depth or length exceeds max allowed. | |
| $config->maxPageNum | int | Maximum number of recognized paginations | |
| $config->maxUrlDepth | int | Maximum URL/path slashes (depth) for request URLs. (Min=10, Max=60) | |
| $config->maxUrlSegmentLength | int | Maximum length of any individual URL segment (default=128). | |
| $config->maxUrlSegments | int | Maximum number of extra stacked URL segments allowed in a page's URL (including page numbers) | |
| $config->pageNameCharset | string | Character set for page names, must be 'ascii' (default, lowercase) or 'UTF8' (uppercase). | |
| $config->pageNameUntitled | string | Name to use for untitled pages (default="untitled"). | |
| $config->pageNameWhitelist | string | Whitelist of characters allowed in UTF8 page names. | |
| $config->pageNumUrlPrefix | string | Prefix used for pagination URLs. Default is "page", resulting in "/page1", "/page2", etc. | |
| $config->pageNumUrlPrefixes | array | Multiple prefixes that may be used for detecting pagination (internal use, for multi-language) | |
$config->requestPath() $config->requestPath() $config->requestPath($match = '') | string | Current unsanitized request path (URL sans ProcessWire installation subdirectory, if present) | |
$config->requestUrl() $config->requestUrl() $config->requestUrl($match = '', string $get = '') | string | Current unsanitized request URL | |
$config->setLocation() $config->setLocation(string $for, string $dir) $config->setLocation(string $for, string $dir, $url = '') | self | Given a directory to a named location, updates $config->paths and $config->urls for it | |
$config->setUrl() $config->setUrl(string $for, string $url) $config->setUrl(string $for, string $url) | self | Change or set just the URL for the named location (leaving server disk path as-is) | |
$config->url() $config->url($for) $config->url($for) | string null | Get URL for requested resource or module | |
$config->urls() $config->urls() $config->urls($for = '') | null string Paths | Get URL for requested resource or module or get all URLs if no argument Can also be used as property: $config->urls | |
$config->versionUrl() $config->versionUrl(string $url) $config->versionUrl(string $url, $useVersion = null) | string | Given a file asset URLs return it with cache-busting version string | |
$config->versionUrls() $config->versionUrls($urls) $config->versionUrls($urls, $useVersion = null) | array | Given array of file asset URLs return them with cache-busting version strings |
Paths
| Name | Return | Summary | |
|---|---|---|---|
$config->path() $config->path(string $for) $config->path(string $for) | null string | Get disk path for requested resource or module | |
$config->paths() $config->paths() $config->paths(string $for = '') | null string Paths | Get disk path for requested resource or module or get all paths if no argument Can also be used as property: $config->paths | |
$config->setLocation() $config->setLocation(string $for, string $dir) $config->setLocation(string $for, string $dir, $url = '') | self | Given a directory to a named location, updates $config->paths and $config->urls for it | |
$config->setPath() $config->setPath(string $for, string $path) $config->setPath(string $for, string $path) | self | Change or set just the server disk path for the named location (leaving URL as-is) |
Js
Javascript configuration
| Name | Return | Summary | |
|---|---|---|---|
$config->js() $config->js() $config->js($key = null, mixed $value = null) | array mixed null this | Set or retrieve a config value to be shared with javascript | |
$config->jsConfig() $config->jsConfig() $config->jsConfig(string $key = null, $value = null) | mixed null array self | Set or retrieve a config value exclusive to Javascript (ProcessWire.config) |
Tools
Runtime
| Name | Return | Summary | |
|---|---|---|---|
| $config->admin | bool int | Is current request for logged-in user in admin? True, false, or 0 if not yet known. @since 3.0.142 | |
| $config->ajax | bool | If the current request is an ajax (asynchronous javascript) request, this is set to true. | |
| $config->cli | bool | This is automatically set to TRUE when PW is booted as a command line (non HTTP) script. | |
| $config->https | bool | If the current request is an HTTPS request, this is set to true. | |
| $config->internal | bool | This is automatically set to FALSE when PW is externally bootstrapped. | |
| $config->modal | bool int | If the current request is in a modal window, this is set to a positive number. False if not. | |
| $config->pagerHeadTags | string null | Populated at runtime to contain `<link rel=prev|next />` tags for document head, after pagination has been rendered by MarkupPagerNav module. | |
$config->requestMethod() $config->requestMethod() $config->requestMethod($match = '') | string | Current request method | |
$config->requestPath() $config->requestPath() $config->requestPath($match = '') | string | Current unsanitized request path (URL sans ProcessWire installation subdirectory, if present) | |
$config->requestUrl() $config->requestUrl() $config->requestUrl($match = '', string $get = '') | string | Current unsanitized request URL | |
| $config->scripts | FilenameArray | Array used by ProcessWire admin to keep track of what javascript files its template should load. It will be blank otherwise. Feel free to use it for the same purpose in your own sites. | |
| $config->serverProtocol | string | Current server protocol, one of: HTTP/1.1, HTTP/1.0, HTTP/2, or HTTP/2.0. | |
| $config->styles | FilenameArray | Array used by ProcessWire admin to keep track of what stylesheet files its template should load. It will be blank otherwise. Feel free to use it for the same purpose in your own sites. | |
| $config->systemVersion | int | System version, used by SystemUpdater to determine when updates must be applied. | |
| $config->versionName | string | This is automatically populated with the current PW version name (i.e. 2.5.0 dev) |
HTTP and input
| Name | Return | Summary | |
|---|---|---|---|
| $config->cookieOptions | array | Options for setting cookies from $input->cookie | |
| $config->httpHost | string | Current HTTP host name. | |
| $config->httpHosts | array | HTTP hosts For added security, specify the host names ProcessWire should recognize. | |
| $config->noHTTPS | bool string array | When boolean true, pages requiring HTTPS will not enforce it (useful for dev environments). May also specify hostname (string) or hostnames (array) to disable HTTPS for. | |
| $config->protectCSRF | bool | Enables CSRF (cross site request forgery) protection on all PW forms, recommended for security. | |
| $config->wireInputArrayDepth | int | Maximum multi-dimensional array depth for input variables accessed from $input or 1 to only allow single dimension arrays. | |
| $config->wireInputLazy | bool | Specify true for $input API var to load input data in a lazy fashion and potentially use less memory. Default is false. | |
| $config->wireInputOrder | string | Order that variables with the $input API var are handled when you access $input->var. |
System
| Name | Return | Summary | |
|---|---|---|---|
| $config->adminEmail | string | Email address to send fatal error notifications to. | |
| $config->adminTemplates | array | Names of templates that ProcessWire should consider exclusive to the admin. | |
| $config->advanced | bool | Special mode for ProcessWire system development. Not recommended for regular site development or production use. | |
| $config->allowExceptions | bool | Allow Exceptions to propagate? (default=false, specify true only if you implement your own exception handler) | |
| $config->debug | bool int string | Special mode for use when debugging or developing a site. Recommended TRUE when site is in development and FALSE when not. Or set to `Config::debug*` constant. | |
| $config->debugIf | string callable array | Enable debug mode if condition is met. One of IP address to match, regex to match IP, array of IPs to match, or callable function that returns true|false. | |
| $config->debugTools | array | Tools, and their order, to show in debug mode (admin) | |
| $config->demo | bool | Special mode for demonstration use that causes POST requests to be disabled. Applies to core, but may not be safe with 3rd party modules. | |
| $config->fatalErrorCode | int | HTTP code to send on fatal error (typically 500 or 503). | |
| $config->fatalErrorHTML | string | HTML used for fatal error messages in HTTP mode. | |
| $config->installed | int | Timestamp of when this PW was installed, set automatically by the installer for future compatibility detection. | |
| $config->lazyPageChunkSize | int | Chunk size for for $pages->findMany() calls. | |
| $config->phpMailAdditionalParameters | string null | Additional params to pass to PHP’s mail() function (when used), see $additional_params argument at https://www.php.net/manual/en/function.mail.php | |
| $config->preloadCacheNames | array | Cache names to preload at beginning of request | |
| $config->systemVersion | int | System version, used by SystemUpdater to determine when updates must be applied. | |
| $config->tableSalt | string | Additional hash for other (non-authentication) purposes. | |
| $config->useFunctionsAPI | bool | Allow most API variables to be accessed as functions? (see /wire/core/FunctionsAPI.php) | |
| $config->useLazyLoading | bool array | Delay loading of fields (and templates/fieldgroups) till requested? Can improve performance on systems with lots of fields or templates. | |
| $config->useMarkupRegions | bool | Enable support for front-end markup regions? | |
| $config->usePageClasses | bool | Use custom Page classes in `/site/classes/[TemplateName]Page.php`? | |
| $config->usePoweredBy | bool | Use the x-powered-by header? Set to false to disable. | |
| $config->useVersionUrls | bool int string null | Default value for $useVersion argument of $config->versionUrls() method |
Template files
| Name | Return | Summary | |
|---|---|---|---|
| $config->appendTemplateFile | string | PHP file in /site/templates/ that will be loaded after each page's template file (default=none) | |
| $config->ignoreTemplateFileRegex | string | Regular expression to ignore template files | |
| $config->prependTemplateFile | string | PHP file in /site/templates/ that will be loaded before each page's template file (default=none) | |
| $config->templateCompile | bool | Allow use of compiled templates? | |
| $config->templateExtension | string | Default is 'php' |
Files
| Name | Return | Summary | |
|---|---|---|---|
| $config->chmodDir | string | Octal string permissions assigned to directories created by ProcessWire | |
| $config->chmodFile | string | Octal string permissions assigned to files created by ProcessWire | |
| $config->chmodWarn | bool | Set to false to suppress warnings about 0666/0777 file permissions that are potentially too loose | |
| $config->pagefileExtendedPaths | bool | Use extended file mapping? | |
| $config->pagefileSecure | bool | When used, files in /site/assets/files/ will be protected with the same access as the page. Routes files through a passthrough script. Note if applying to existing site it may not affect existing pages and file/image fields until they are accessed or saved. | |
| $config->pagefileSecurePathPrefix | string | One or more characters prefixed to the pathname of protected file dirs. This should be some prefix that the .htaccess file knows to block requests for. | |
| $config->uploadBadExtensions | string | Space separated list of file extensions that are always disallowed from uploads. | |
| $config->uploadTmpDir | string | Optionally override PHP's upload_tmp_dir with your own. Should include a trailing slash. |
Session
| Name | Return | Summary | |
|---|---|---|---|
| $config->loginDisabledRoles | array | Array of role name(s) or ID(s) of roles where login is disallowed. | |
| $config->sessionAllow | bool callable | Are sessions allowed? Typically boolean true, unless provided a callable function that returns boolean. See /wire/config.php for an example. | |
| $config->sessionChallenge | bool | Should login sessions have a challenge key? (for extra security, recommended) | |
| $config->sessionCookieDomain | null string | Domain to use for sessions, which enables a session to work across subdomains, or NULL to disable (default/recommended). | |
| $config->sessionCookieSameSite | string | Cookie “SameSite” value for sessions - “Lax” (default) or “Strict”. | |
| $config->sessionCookieSecure | bool int | Use secure cookies when on HTTPS? When enabled, separate sessions will be maintained for HTTP vs. HTTPS. Good for security but tradeoff is login session may be lost when switching (default=1 or true). | |
| $config->sessionExpireSeconds | int | How many seconds of inactivity before session expires? | |
| $config->sessionFingerprint | int bool | Should login sessions be tied to IP and user agent? 0 or false: Fingerprint off. 1 or true: Fingerprint on with default/recommended setting (currently 10). 2: Fingerprint only the remote IP. 4: Fingerprint only the forwarded/client IP (can be spoofed). 8: Fingerprint only the useragent. 10: Fingerprint the remote IP and useragent (default). 12: Fingerprint the forwarded/client IP and useragent. 14: Fingerprint the remote IP, forwarded/client IP and useragent (all). | |
| $config->sessionForceIP | string | Force the client IP address returned by $session->getIP() to be this rather than auto-detect (useful with load balancer). Use for setting value only. | |
| $config->sessionHistory | int | Number of session entries to keep (default=0, which means off). | |
| $config->sessionName | string | Default session name to use (default='wire') | |
| $config->sessionNameSecure | string | Session name when on HTTPS. Used when the sessionCookieSecure option is enabled (default). When blank (default), it will assume sessionName + 's'. | |
| $config->userAuthHashType | string | Default is 'sha1' - used only if Blowfish is not supported by the system. | |
| $config->userAuthSalt | string | Salt generated at install time to be used as a secondary/non-database salt for the password system. | |
| $config->userOutputFormatting | bool | Enable output formatting for current $user API variable at boot? (default=false) |
Images
| Name | Return | Summary | |
|---|---|---|---|
| $config->adminThumbOptions | array | Admin thumbnail image options |
Database
| Name | Return | Summary | |
|---|---|---|---|
| $config->dbCache | bool | Whether to allow MySQL query caching. | |
| $config->dbCharset | string | Default is 'utf8' but 'utf8mb4' is also supported. | |
| $config->dbEngine | string | Database engine (MyISAM or InnoDB) | |
| $config->dbHost | string | Database host | |
| $config->dbInitCommand | string | Database init command, for PDO::MYSQL_ATTR_INIT_COMMAND. Note placeholder {charset} gets replaced with $config->dbCharset. | |
| $config->dbLowercaseTables | bool | Force any created field_* tables to be lowercase. | |
| $config->dbName | string | Database name | |
| $config->dbOptions | array | Any additional driver options to pass as $options argument to "new PDO(...)". | |
| $config->dbPass | string | Database password | |
| $config->dbPath | string | MySQL database exec path (Path to mysqldump) | |
| $config->dbPort | string | Database port (default=3306) | |
| $config->dbQueryLogMax | int | Maximum number of queries WireDatabasePDO will log in memory, when debug mode is enabled (default=1000). | |
| $config->dbReader | array null | Configuration values for read-only database connection (if available). | |
| $config->dbSocket | string | Optional DB socket config for sites that need it. | |
| $config->dbSqlModes | array | Set or adjust SQL mode per MySQL version, where array keys are MySQL version and values are SQL mode command(s). | |
| $config->dbStripMB4 | bool | When dbEngine is not utf8mb4 and this is true, we will attempt to remove 4-byte characters (like emoji) from inserts when possible. Note that this adds some overhead. | |
| $config->dbUser | string | Database user |
Modules
| Name | Return | Summary | |
|---|---|---|---|
| $config->moduleCompile | bool | Allow use of compiled modules? | |
| $config->moduleServiceKey | string | API key for modules web service | |
| $config->moduleServiceURL | string | URL where the modules web service can be accessed |
Admin
| Name | Return | Summary | |
|---|---|---|---|
| $config->defaultAdminTheme | string | Default admin theme: AdminThemeUikit, AdminThemeDefault or AdminThemeReno. | |
| $config->logIP | bool | Include IP address in logs, when applicable? | |
| $config->logs | array | Additional core logs to keep |
System IDs
| Name | Return | Summary | |
|---|---|---|---|
| $config->adminRootPageID | int | Page ID of admin root page | |
| $config->externalPageID | int | Page ID of page assigned to $page API variable when externally bootstrapped | |
| $config->guestUserPageID | int | Page ID of the guest (default/not-logged-in) user. | |
| $config->guestUserRolePageID | int | Page ID of the guest user role (inherited by all users, not just guest). | |
| $config->http404PageID | int | Page ID of the 404 “page not found” page. | |
| $config->loginPageID | int | Page ID of the admin login page. | |
| $config->permissionTemplateID | int | Template ID of the permission template. | |
| $config->permissionsPageID | int | Page ID of the page having permissions as children. | |
| $config->preloadPageIDs | array | Page IDs of pages that will always be preloaded at beginning of request | |
| $config->roleTemplateID | int | Template ID of the role template. | |
| $config->rolesPageID | int | Page ID of the page having roles as children. | |
| $config->rootPageID | int | Page ID of homepage (usually 1) | |
| $config->superUserPageID | int | Page ID of the original superuser (created during installation). | |
| $config->superUserRolePageID | int | Page ID of the superuser role. | |
| $config->trashPageID | int | Page ID of the trash page. | |
| $config->userTemplateID | int | Template ID of the user template. | |
| $config->userTemplateIDs | array | Array of template IDs when multiple allowed for users. | |
| $config->usersPageID | int | Page ID of the page having users as children. | |
| $config->usersPageIDs | array | Populated if multiple possible users page IDs (parent for users pages) |
Additional methods and properties
In addition to the methods and properties above, Config also inherits the methods and properties of these classes:
API reference based on ProcessWire core version 3.0.248