Oihana PHP System

getParamInt.php

Table of Contents

Functions

getParamInt()  : int|null
Retrieves a parameter from the HTTP request and ensures it is a int number.

Functions

getParamInt()

Retrieves a parameter from the HTTP request and ensures it is a int number.

getParamInt(ServerRequestInterface|null $request, string $name[, array<string|int, mixed> $args = [] ][, int|null $defaultValue = null ][, string $strategy = HttpParamStrategy::BOTH ][, bool $throwable = false ]) : int|null

This helper calls getParam() and converts the returned value to a int if set.

  • If the value is null or missing, the $defaultValue is returned.
  • If $throwable is true, a NotFoundException may be thrown by getParam().
Parameters
$request : ServerRequestInterface|null

The PSR-7 server request instance.

$name : string

The parameter name or dot-notated path.

$args : array<string|int, mixed> = []

Optional default values passed to getParam().

$defaultValue : int|null = null

Value returned if the parameter is missing or not set. Default is null.

$strategy : string = HttpParamStrategy::BOTH

Which source to search: HttpParamStrategy::BOTH|QUERY|BODY. Default is BOTH.

$throwable : bool = false

Whether to throw a NotFoundException if parameter is missing. Default false.

Tags
throws
NotFoundException

If $throwable is true and the parameter is not found.

example 
// Query string: ?age=19
$price = getParamInt($request, 'age', [], 0); // 19

// Body: ['age' => '5']
$discount = getParamInt($request, 'age', [], null); // 5

// Missing parameter, uses default
$tax = getParamInt($request, 'age', [], 1); // 1
author

Marc Alcaraz (ekameleon)

since
1.0.0
Return values
int|null —

The parameter value cast to int if present, otherwise $defaultValue or null.


        

        
    




    

    

                                

                

                            
    

        On this page

        
    


                

                            

            

    

        

            
Search results