Merge pull request #2 from Neuron-PHP/feature/variable-filters

Feature/variable filters

Author: ljonesfl

.version.json

@@ -2,6 +2,6 @@
   "strategy": "semver",
   "major": 0,
   "minor": 8,
-  "patch": 12,
+  "patch": 13,
   "build": 0
 }

src/Mvc/Controllers/Base.php

@@ -3,10 +3,10 @@
 namespace Neuron\Mvc\Controllers;
 
 use League\CommonMark\Exception\CommonMarkException;
-use Neuron\Application\IApplication;
 use Neuron\Core\Exceptions\BadRequestMethod;
+use Neuron\Data\Filter\Get;
+use Neuron\Data\Filter\Post;
 use Neuron\Data\Setting\SettingManager;
-use Neuron\Data\Setting\Source\ISettingSource;
 use Neuron\Mvc\Application;
 use Neuron\Mvc\Cache\CacheConfig;
 use Neuron\Mvc\Cache\Exceptions\CacheException;
@@ -884,4 +884,46 @@ public function __call( string $method, array $arguments ): ?string
 		// If no URL helper pattern matches, throw an exception
 		throw new \BadMethodCallException( "Method '$method' not found in " . static::class );
 	}
+
+	/**
+	 * Filter and retrieve a GET parameter.
+	 *
+	 * @param string $paramName The name of the GET parameter
+	 * @param mixed $default The default value if parameter is not present
+	 * @return mixed The filtered GET parameter value or default
+	 */
+	public function filterGet( string $paramName, mixed $default = null ) : mixed
+	{
+		$get = new Get();
+
+		return $get->filterScalar( $paramName ) ?? $default;
+	}
+
+	/**
+	 * Filter and retrieve a POST parameter.
+	 *
+	 * @param string $paramName The name of the POST parameter
+	 * @param mixed $default The default value if parameter is not present
+	 * @return mixed The filtered POST parameter value or default
+	 */
+	public function filterPost( string $paramName, mixed $default = null ) : mixed
+	{
+		$post = new Post();
+
+		return $post->filterScalar( $paramName ) ?? $default;
+	}
+
+	/**
+	 * Filter and retrieve a SERVER parameter.
+	 *
+	 * @param string $paramName The name of the SERVER parameter
+	 * @param mixed $default The default value if parameter is not present
+	 * @return mixed The filtered SERVER parameter value or default
+	 */
+	public function filterServer( string $paramName, mixed $default = null ): mixed
+	{
+		$server = new \Neuron\Data\Filter\Server();
+
+		return $server->filterScalar( $paramName ) ?? $default;
+	}
 }

versionlog.md

@@ -1,5 +1,14 @@
+## 0.8.13
+
 ## 0.8.12 2025-11-12
-* Added ViewDataProvider interface for injecting data into views globally.
+* Added ViewDataProvider for global view data injection
+  - Eliminates need for views to call Registry::getInstance()
+  - Supports both static values and lazy-evaluated callables
+  - Automatic injection into all views via Base::injectHelpers()
+  - Fluent API for configuration in initializers
+  - Comprehensive PHPUnit test coverage (19 tests)
+  - Template ViewDataInitializer in resources/app/Initializers/
+  - Full documentation in readme.md
 
 ## 0.8.11 2025-11-12
 * Renamed config.yaml to neuron.yaml