Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,059 of 9,059 pages
About the help in other languages
All help pages

file.ini [ClusteringSettings]

The settings of [ClusteringSettings] in file.ini: FileHandler, NonExistantStaleCacheHandling

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/examples/ini-settings/file/ClusteringSettings.md

On this page

file.ini [ClusteringSettings]

The block [ClusteringSettings] of settings/file.ini, with 2 setting(s).

Never edit settings/file.ini itself: an update replaces it. Put the settings you change in an override, which wins over the shipped file:

  • settings/override/file.ini.append.php for every siteaccess,
  • settings/siteaccess/<siteaccess>/file.ini.append.php for one siteaccess,
  • extension/<extension>/settings/file.ini.append.php in an extension (read when the extension is active).

FileHandler

Cluster file handler.
Since 4.1 name of the filehandlers have changed
you may choose between :

  • eZFSFileHandler
    standard file handler
  • eZDFSFileHandler
    distributed filesystem handler with a DB overlay. Required for NFS based
    architectures
    and it is case sensitive

Default: eZFSFileHandler.

<?php /* #?ini charset="utf-8"?
# settings/override/file.ini.append.php
[ClusteringSettings]
FileHandler=eZFSFileHandler
*/ ?>

NonExistantStaleCacheHandling

DEPRECATED
If you want to use your own cluster file handler located in an extension
then you should add the extension name to the list below.
In that case the handler will be searched for in the following directory:
extension/<your_extension>/clusterfilehandlers
ExtensionDirectories[]
Defines what happens when a requested cache file is already being generated
and no expired cache file exists (for instance if the content is new)
Two possible values:

  • wait: places the process in a wait loop for a limited time until the file
    is done generating. This is the default value
  • generate: let the requesting process generate its own data without storing
    the result
    The key of this array defined the type of cache impacted by the setting. Three
    cache types are allowed here: viewcache, cacheblock and misc (any cache that is
    not viewcache nor cacheblock).

Default: a hash of 3: viewcache=wait, cacheblock=wait, misc=wait.

<?php /* #?ini charset="utf-8"?
# settings/override/file.ini.append.php
[ClusteringSettings]
# an empty "NonExistantStaleCacheHandling[]" first replaces the shipped list; without it the items are added
NonExistantStaleCacheHandling[]
NonExistantStaleCacheHandling[viewcache]=wait
NonExistantStaleCacheHandling[cacheblock]=wait
NonExistantStaleCacheHandling[misc]=wait
*/ ?>

Generated by ./console exp:help:examples from settings/file.ini. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x