Merge branch 'release/0.9.3'

Author: ljonesfl

.version.json

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

composer.json

@@ -15,6 +15,7 @@
       "ext-json": "*",
       "neuron-php/application": "0.8.*",
       "neuron-php/routing": "0.8.*",
+      "neuron-php/data": "^0.8.6",
       "neuron-php/dto": "^0.0.7",
       "league/commonmark": "^2.6",
       "neuron-php/cli": "0.8.*",

src/Mvc/Controllers/Base.php

@@ -778,34 +778,38 @@ protected static function registerDelete( Application $app, string $controller,
 
 	/**
 	 * Generate a relative URL for a named route.
-	 * 
+	 *
 	 * @param string $routeName The name of the route
 	 * @param array $parameters Parameters to substitute in the route path
-	 * @return string|null The generated relative URL or null if route not found
+	 * @param string|null $fallback Fallback URL if route not found
+	 * @return string|null The generated relative URL, fallback if provided, or null if route not found
 	 */
-	protected function urlFor( string $routeName, array $parameters = [] ): ?string
+	protected function urlFor( string $routeName, array $parameters = [], ?string $fallback = null ): ?string
 	{
 		if( !isset( $this->_router ) || !method_exists( $this->_router, 'generateUrl' ) )
 		{
-			return null;
+			return $fallback;
 		}
-		return $this->_router->generateUrl( $routeName, $parameters, false );
+		$url = $this->_router->generateUrl( $routeName, $parameters, false );
+		return $url ?? $fallback;
 	}
 
 	/**
 	 * Generate an absolute URL for a named route.
-	 * 
+	 *
 	 * @param string $routeName The name of the route
 	 * @param array $parameters Parameters to substitute in the route path
-	 * @return string|null The generated absolute URL or null if route not found
+	 * @param string|null $fallback Fallback URL if route not found
+	 * @return string|null The generated absolute URL, fallback if provided, or null if route not found
 	 */
-	protected function urlForAbsolute( string $routeName, array $parameters = [] ): ?string
+	protected function urlForAbsolute( string $routeName, array $parameters = [], ?string $fallback = null ): ?string
 	{
 		if( !isset( $this->_router ) || !method_exists( $this->_router, 'generateUrl' ) )
 		{
-			return null;
+			return $fallback;
 		}
-		return $this->_router->generateUrl( $routeName, $parameters, true );
+		$url = $this->_router->generateUrl( $routeName, $parameters, true );
+		return $url ?? $fallback;
 	}
 
 	/**

src/Mvc/Requests/Request.php

@@ -27,23 +27,13 @@ class Request
 	private array $_routeParameters = [];
 	private array $_errors = [];
 	private DefaultIpResolver $_ipResolver;
-	private Cookie $_cookie;
-	private Get $_get;
-	private Post $_post;
-	private Server $_server;
-	private Session $_session;
 
 	/**
 	 * Request constructor.
 	 */
 	public function __construct()
 	{
 		$this->_ipResolver = new DefaultIpResolver();
-		$this->_cookie = new Cookie();
-		$this->_get = new Get();
-		$this->_post = new Post();
-		$this->_server = new Server();
-		$this->_session = new Session();
 	}
 
 	/**
@@ -94,7 +84,7 @@ public function getClientIp(): string
 	 */
 	public function get( string $key, mixed $default = null ): mixed
 	{
-		return $this->_get->filterScalar( $key, $default );
+		return Get::filterScalar( $key, $default );
 	}
 
 	/**
@@ -105,7 +95,7 @@ public function get( string $key, mixed $default = null ): mixed
 	 */
 	public function post( string $key, mixed $default = null ): mixed
 	{
-		return $this->_post->filterScalar( $key, $default );
+		return Post::filterScalar( $key, $default );
 	}
 
 	/**
@@ -116,7 +106,7 @@ public function post( string $key, mixed $default = null ): mixed
 	 */
 	public function server( string $key, mixed $default = null ): mixed
 	{
-		return $this->_server->filterScalar( $key, $default );
+		return Server::filterScalar( $key, $default );
 	}
 
 	/**
@@ -127,7 +117,7 @@ public function server( string $key, mixed $default = null ): mixed
 	 */
 	public function session( string $key, mixed $default = null ): mixed
 	{
-		return $this->_session->filterScalar( $key, $default );
+		return Session::filterScalar( $key, $default );
 	}
 
 	/**
@@ -138,7 +128,7 @@ public function session( string $key, mixed $default = null ): mixed
 	 */
 	public function cookie( string $key, mixed $default = null ): mixed
 	{
-		return $this->_cookie->filterScalar( $key, $default );
+		return Cookie::filterScalar( $key, $default );
 	}
 
 	/**

versionlog.md

@@ -1,3 +1,11 @@
+## 0.9.5 2025-11-15
+* Enhanced `urlFor()` and `urlForAbsolute()` methods to accept optional fallback parameter
+* Methods now return fallback URL when route is not found, instead of null
+* This eliminates need for null coalescing operator at every call site
+
+## 0.9.4 2025-11-15
+* Added missing dependency on neuron-php/data (^0.8.6) which is required by Request class filter methods
+
 ## 0.9.3 2025-11-15
 * **Breaking Change**: Integrated DTO component for request validation
   - Replaced Parameter class with DTO-based validation system
@@ -163,7 +171,7 @@
 
 ## 0.6.28 2025-11-04
 ## 0.6.27 2025-11-08
-## 0.6.26
+## 0.6.26 2025-11-15
 ## 0.6.25
 ## 0.6.24 2025-01-08
 * Added markdown support to the view.