Merge branch 'release/0.6.34'

Author: ljonesfl

.gitignore

@@ -10,3 +10,5 @@ build/
 .phpunit.result.cache
 /examples/test.log
 /examples/bad/test.log
+/CLAUDE.md
+/cache/

.version.json

@@ -2,6 +2,6 @@
   "strategy": "semver",
   "major": 0,
   "minor": 6,
-  "patch": 33,
+  "patch": 34,
   "build": 0
 }

examples/config/config.yaml

@@ -7,6 +7,17 @@ logging:
 views:
   path: views
 
+cache:
+  enabled: true
+  storage: file
+  path: cache/views
+  ttl: 3600
+  views:
+    html: true
+    markdown: true
+    json: false
+    xml: false
+
 system:
   timezone: US/Eastern
   base_path: examples

src/Mvc/Cache/CacheConfig.php

@@ -0,0 +1,127 @@
+<?php
+namespace Neuron\Mvc\Cache;
+
+use Neuron\Data\Setting\Source\ISettingSource;
+
+class CacheConfig
+{
+	private array $_Settings;
+
+	/**
+	 * CacheConfig constructor
+	 *
+	 * @param array $Settings
+	 */
+	public function __construct( array $Settings )
+	{
+		$this->_Settings = $Settings;
+	}
+
+	/**
+	 * Check if cache is enabled
+	 *
+	 * @return bool
+	 */
+	public function isEnabled(): bool
+	{
+		return $this->_Settings['enabled'] ?? false;
+	}
+
+	/**
+	 * Get cache path
+	 *
+	 * @return string
+	 */
+	public function getCachePath(): string
+	{
+		return $this->_Settings['path'] ?? 'cache/views';
+	}
+
+	/**
+	 * Get default TTL
+	 *
+	 * @return int
+	 */
+	public function getDefaultTtl(): int
+	{
+		return $this->_Settings['ttl'] ?? 3600;
+	}
+
+	/**
+	 * Get storage type
+	 *
+	 * @return string
+	 */
+	public function getStorageType(): string
+	{
+		return $this->_Settings['storage'] ?? 'file';
+	}
+
+	/**
+	 * Check if specific view type caching is enabled
+	 *
+	 * @param string $ViewType
+	 * @return bool
+	 */
+	public function isViewTypeEnabled( string $ViewType ): bool
+	{
+		$ViewSettings = $this->_Settings['views'] ?? [];
+		
+		return $ViewSettings[$ViewType] ?? true;
+	}
+
+	/**
+	 * Create CacheConfig from settings source
+	 *
+	 * @param ISettingSource $Settings
+	 * @return self
+	 */
+	public static function fromSettings( ISettingSource $Settings ): self
+	{
+		$CacheSettings = [];
+		
+		$Enabled = $Settings->get( 'cache', 'enabled' );
+		if( $Enabled !== null )
+		{
+			$CacheSettings['enabled'] = $Enabled === 'true' || $Enabled === '1';
+		}
+		
+		$Path = $Settings->get( 'cache', 'path' );
+		if( $Path !== null )
+		{
+			$CacheSettings['path'] = $Path;
+		}
+		
+		$Ttl = $Settings->get( 'cache', 'ttl' );
+		if( $Ttl !== null )
+		{
+			$CacheSettings['ttl'] = (int) $Ttl;
+		}
+		
+		$Storage = $Settings->get( 'cache', 'storage' );
+		if( $Storage !== null )
+		{
+			$CacheSettings['storage'] = $Storage;
+		}
+		
+		// For views settings, we need to check each view type
+		$ViewTypes = [ 'html', 'markdown', 'json', 'xml' ];
+		$ViewSettings = [];
+		
+		foreach( $ViewTypes as $ViewType )
+		{
+			$ViewEnabled = $Settings->get( 'views', $ViewType );
+			if( $ViewEnabled !== null )
+			{
+				$ViewSettings[$ViewType] = $ViewEnabled === 'true' || $ViewEnabled === '1';
+			}
+		}
+		
+		if( !empty( $ViewSettings ) )
+		{
+			$CacheSettings['views'] = $ViewSettings;
+		}
+		
+		return new self( $CacheSettings );
+	}
+}

src/Mvc/Cache/Exceptions/CacheException.php

@@ -0,0 +1,48 @@
+<?php
+namespace Neuron\Mvc\Cache\Exceptions;
+
+class CacheException extends \Exception
+{
+	/**
+	 * Create exception for unable to write
+	 *
+	 * @param string $Path
+	 * @return self
+	 */
+	public static function unableToWrite( string $Path ): self
+	{
+		return new self( "Unable to write cache file: $Path" );
+	}
+
+	/**
+	 * Create exception for invalid key
+	 *
+	 * @param string $Key
+	 * @return self
+	 */
+	public static function invalidKey( string $Key ): self
+	{
+		return new self( "Invalid cache key: $Key" );
+	}
+
+	/**
+	 * Create exception for storage not configured
+	 *
+	 * @return self
+	 */
+	public static function storageNotConfigured(): self
+	{
+		return new self( "Cache storage is not properly configured" );
+	}
+
+	/**
+	 * Create exception for unable to create directory
+	 *
+	 * @param string $Path
+	 * @return self
+	 */
+	public static function unableToCreateDirectory( string $Path ): self
+	{
+		return new self( "Unable to create cache directory: $Path" );
+	}
+}