Allow auto-detect for autoClearCache config.

Author: dereuromark

docs/Authentication.md

@@ -85,18 +85,12 @@ Once you move such a code based rule into the INI file, you can safely remove th
 ## Caching
 
 TinyAuth makes heavy use of caching to achieve optimal performance.
+By default it will not use caching in debug mode, though.
 
-You may however want to disable caching while developing to prevent
-confusing (outdated) results.
-
-To disable caching either:
-
-- pass ``true`` to the ``autoClearCache`` configuration option
-- use the example below to disable caching automatically for CakePHP debug mode
-
+To modify the caching behavior set the ``autoClearCache`` configuration option:
 ```php
 $this->loadComponent('TinyAuth.Auth', [
-	'autoClearCache' => Configure::read('debug')
+	'autoClearCache' => true|false
 )]
 ```
 

docs/Authorization.md

@@ -198,17 +198,10 @@ view, edit = user
 TinyAuth makes heavy use of caching to achieve optimal performance.
 By default it will not use caching in debug mode, though.
 
-You may however want to disable caching while developing RBAC to prevent
-confusing (outdated) results.
-
-To disable caching either:
-
-- pass ``true`` to the ``autoClearCache`` configuration option
-- use the example below to disable caching automatically for CakePHP debug mode
-
+To modify the caching behavior set the ``autoClearCache`` configuration option:
 ```php
 'TinyAuth.Tiny' => [
-	'autoClearCache' => Configure::read('debug')
+	'autoClearCache' => true|false
 ]
 ```
 

src/Auth/TinyAuthorize.php

@@ -69,7 +69,7 @@ class TinyAuthorize extends BaseAuthorize {
 		'adminPrefix' => 'admin', // name of the admin prefix route (only used when allowUser is enabled)
 		'cache' => '_cake_core_',
 		'cacheKey' => 'tiny_auth_acl',
-		'autoClearCache' => false, // Set to true to delete cache automatically in debug mode
+		'autoClearCache' => null, // Set to true to delete cache automatically in debug mode, keep null for auto-detect
 		'aclPath' => null, // @deprecated Use filePath
 		'filePath' => null, // Possible to locate ini file at given path e.g. Plugin::configPath('Admin')
 		'file' => 'acl.ini',
@@ -93,6 +93,10 @@ public function __construct(ComponentRegistry $registry, array $config = []) {
 			throw new Exception(sprintf('Invalid TinyAuthorization cache `%s`', $config['cache']));
 		}
 
+		if ($this->_config['autoClearCache'] === null) {
+			$this->_config['autoClearCache'] = Configure::read('debug');
+		}
+
 		// BC only
 		if (isset($this->_config['aclPath'])) {
 			$this->_config['filePath'] = $this->_config['aclPath'];

src/Controller/Component/AuthComponent.php

@@ -21,7 +21,7 @@ class AuthComponent extends CakeAuthComponent {
 	protected $_defaultTinyAuthConfig = [
 		'cache' => '_cake_core_',
 		'cacheKey' => 'tiny_auth_allow',
-		'autoClearCache' => false, // Set to true to delete cache automatically in debug mode
+		'autoClearCache' => null, // Set to true to delete cache automatically in debug mode, keep null for auto-detect
 		'filePath' => null, // Possible to locate ini file at given path e.g. Plugin::configPath('Admin')
 		'file' => 'auth_allow.ini',
 	];
@@ -39,6 +39,10 @@ public function __construct(ComponentRegistry $registry, array $config = []) {
 		if (!in_array($config['cache'], Cache::configured())) {
 			throw new Exception(sprintf('Invalid TinyAuth cache `%s`', $config['cache']));
 		}
+
+		if ($this->_config['autoClearCache'] === null) {
+			$this->_config['autoClearCache'] = Configure::read('debug');
+		}
 	}
 
 	/**