feat(input): add float typed accessor

- Add InputData::float() for numeric input values
- Cover float strings, integers, defaults, nulls, and invalid values
- Document float access with matching decimal validation examples

Signed-off-by: memleakd <121398829+memleakd@users.noreply.github.com>

Author: memleakd

system/Input/InputData.php

@@ -96,6 +96,34 @@ public function integer(string $key, ?int $default = null): ?int
         throw $this->invalidType($key, 'integer');
     }
 
+    /**
+     * Returns an input field as a float.
+     *
+     * Supports dot-array syntax for nested input data.
+     */
+    public function float(string $key, ?float $default = null): ?float
+    {
+        $value = $this->get($key, $default);
+
+        if ($value === null || is_float($value)) {
+            return $value;
+        }
+
+        if (is_int($value)) {
+            return (float) $value;
+        }
+
+        if (is_string($value)) {
+            $float = filter_var($value, FILTER_VALIDATE_FLOAT, FILTER_NULL_ON_FAILURE);
+
+            if ($float !== null) {
+                return $float;
+            }
+        }
+
+        throw $this->invalidType($key, 'float');
+    }
+
     /**
      * Returns an input field as a boolean.
      *

tests/system/Input/InputDataTest.php

@@ -114,6 +114,37 @@ public function testIntegerThrowsForInvalidInputValue(): void
         $input->integer('page');
     }
 
+    public function testFloatReturnsInputFloat(): void
+    {
+        $input = new InputData(['price' => '15.50']);
+
+        $this->assertEqualsWithDelta(15.50, $input->float('price'), PHP_FLOAT_EPSILON);
+    }
+
+    public function testFloatReturnsInputIntegerAsFloat(): void
+    {
+        $input = new InputData(['price' => 15]);
+
+        $this->assertEqualsWithDelta(15.0, $input->float('price'), PHP_FLOAT_EPSILON);
+    }
+
+    public function testFloatReturnsDefaultForMissingInputField(): void
+    {
+        $input = new InputData([]);
+
+        $this->assertEqualsWithDelta(1.5, $input->float('price', 1.5), PHP_FLOAT_EPSILON);
+    }
+
+    public function testFloatThrowsForInvalidInputValue(): void
+    {
+        $input = new InputData(['price' => 'free']);
+
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('The input "price" value cannot be read as float.');
+
+        $input->float('price');
+    }
+
     public function testBooleanReturnsInputBoolean(): void
     {
         $input = new InputData(['active' => 'true']);
@@ -174,12 +205,14 @@ public function testTypedAccessorsReturnNullForNullInputFields(): void
         $input = new InputData([
             'title'  => null,
             'page'   => null,
+            'price'  => null,
             'active' => null,
             'tags'   => null,
         ]);
 
         $this->assertNull($input->string('title', 'Untitled'));
         $this->assertNull($input->integer('page', 1));
+        $this->assertNull($input->float('price', 1.5));
         $this->assertNull($input->boolean('active', false));
         $this->assertNull($input->array('tags', ['draft']));
     }

user_guide_src/source/incoming/form_requests/015.php

@@ -5,6 +5,7 @@
 $input = $request->validatedInput();
 
 $page        = $input->integer('page', 1);
+$rating      = $input->float('rating', 0.0);
 $active      = $input->boolean('active', false);
 $publishedAt = $input->date('published_at', 'Y-m-d');
 $status      = $input->enum('status', PostStatus::class, PostStatus::DRAFT);

user_guide_src/source/libraries/validation.rst

@@ -486,7 +486,7 @@ Typed Validated Input
 ``getValidatedInput()`` returns the same validated data as a
 ``CodeIgniter\Validation\ValidatedInput`` object. Use it after validation
 succeeds when you want to read common controller values as strings, integers,
-booleans, arrays, dates, or enums:
+floats, booleans, arrays, dates, or enums:
 
 .. versionadded:: 4.8.0
 
@@ -514,6 +514,8 @@ All methods support dot-array syntax for nested validated data.
   missing, it returns the default value or ``null``.
 * ``integer($key, $default = null)`` returns ``int|null``. If the field is
   missing, it returns the default value or ``null``.
+* ``float($key, $default = null)`` returns ``float|null``. If the field is
+  missing, it returns the default value or ``null``.
 * ``boolean($key, $default = null)`` returns ``bool|null``. If the field is
   missing, it returns the default value or ``null``.
 * ``array($key, $default = null)`` returns ``array|null``. If the field is
@@ -529,8 +531,8 @@ Fields that are present with a ``null`` value return ``null``. This lets you
 distinguish a missing optional field from a field that was validated as
 ``null``.
 
-Use validation rules such as ``integer``, ``valid_date``, ``in_list``, or a
-custom rule to ensure the value matches the type you plan to read. The
+Use validation rules such as ``integer``, ``decimal``, ``valid_date``,
+``in_list``, or a custom rule to ensure the value matches the type you plan to read. The
 ``date()`` method only parses the value; validation rules should enforce
 acceptable date formats and ranges. For strict calendar validation, add a rule
 such as ``valid_date[Y-m-d]``.

user_guide_src/source/libraries/validation/048.php

@@ -6,6 +6,7 @@
 $validation->setRules([
     'title'        => 'required|string',
     'page'         => 'permit_empty|integer',
+    'rating'       => 'permit_empty|decimal',
     'active'       => 'permit_empty|in_list[0,1,true,false,yes,no,on,off]',
     'tags'         => 'permit_empty|is_array',
     'published_at' => 'permit_empty|valid_date[Y-m-d]',
@@ -15,6 +16,7 @@
 $data = [
     'title'        => 'Hello World',
     'page'         => '2',
+    'rating'       => '4.5',
     'active'       => 'true',
     'tags'         => ['php', 'codeigniter'],
     'published_at' => '2026-05-04',
@@ -30,6 +32,7 @@
 
 $title       = $input->string('title');
 $page        = $input->integer('page', 1);
+$rating      = $input->float('rating', 0.0);
 $active      = $input->boolean('active', false);
 $tags        = $input->array('tags', []);
 $publishedAt = $input->date('published_at', 'Y-m-d');