Задает длительность времени в секундах, в течение которого кэш шаблона будет актуальным. По истечении этого времени кэш будет регенерирован. Переменная $caching должна быть установлена в "true" при использовании $cache_lifetime. Значение переменной -1 задает неограниченное время жизни кэша. Значение переменной 0 вызовет постоянную его регенерацию (подходит только для тестирования, для отключения кэширования более целесообразно устанавливать $caching = false.)
Если $force_compile активировано, файлы кэша каждый раз будут регенерироваться, отключая таким образом кэширование. Вы можете очистить сразу все файлы кэша, используя функцию clear_all_cache(), или в случае с конкретными файлами (группами) кэша - при помощи функции clear_cache().
Техническое замечание
Если вы хотите назначить конкретным шаблонам собственное время жизни их кэша, вы можете сделать это путем установки $caching = 2, затем установкой $cache_lifetime в нужное значение перед вызовом display() или fetch().