Request

The request and the response in Masonite work together to form a well formed response that a browser can read and render. The Request class is used to fetch any incoming cookies, headers, URL's, paths, request methods and other incoming data.
Cookies
Although both the request and response classes have headers and cookies, in most instances, when fetching cookies and headers, it should be fetched from the Request class. When setting headers and cookies it should be done on the response class.
To get cookies you can do so simply:
from masonite.request import Request
#..
​
def show(self, request: Request):
  request.cookie('Accepted-Cookies')
This will fetch the cookie from the incoming request headers.
You can also set cookies on the request:
from masonite.request import Request
#..
​
def show(self, request: Request):
  request.cookie('Accepted-Cookies', 'True')
Note that setting cookies on the request will NOT return the cookie as part of the response and therefore will NOT keep the cookie from request to request.
Headers
Although both the request and response classes have headers and cookies, in most instances, when fetching cookies and headers, it should be fetched from the Request class. When setting headers and cookies it should be done on the response class.
To get a request header you can do so simply:
from masonite.request import Request
#..
​
def show(self, request: Request):
  request.header('X-Custom')
You can also set a header on the request class:
from masonite.request import Request
#..
​
def show(self, request: Request):
  request.header('X-Custom', 'value')
Note that setting headers on the request will NOT return the header as part of the response.
Paths
You can get the current request URI:
from masonite.request import Request
#..
​
def show(self, request: Request):
  request.get_path() #== /dashboard/1
You can get the current request method:
from masonite.request import Request
#..
​
def show(self, request: Request):
  request.get_request_method() #== PUT
You can check if the current path contains a glob style schema:
from masonite.request import Request
#..
​
def show(self, request: Request):
  # URI: /dashboard/1/users
  request.contains("/dashboard/*/users") #== True
You can get the current subdomain from the host:
from masonite.request import Request
#..
​
def show(self, request: Request):
  # URI: work.example.com
  request.get_subdomain() #== work
You can get the current host:
from masonite.request import Request
#..
​
def show(self, request: Request):
  # URI: work.example.com
  request.get_host() #== example.com
Input
Input can be from any kind of request method. In Masonite, fetching the input is the same no matter which request method it is.
To fetch an input we can do:
from masonite.request import Request
#..
​
def show(self, request: Request):
  # GET /dashboard?user_id=1
  request.input('user_id') #== 1
If an input doesn't exist you can pass in a default:
from masonite.request import Request
#..
​
def show(self, request: Request):
  # GET /dashboard
  request.input('user_id', 5) #== 5
Route Params
Route parameters are parameters specified in a route and captured from the URL:
If you have a route like this:
Route.get('/dashboard/@user_id', '[email protected]')
You can get the value of the @user_id parameter like this:
from masonite.request import Request
#..
​
def show(self, request: Request):
  # GET /dashboard?user_id=1
  request.param('user_id') #== 1
User
As a convenient way to fetch the user, you can do so directly on the request class if a user is logged in:
from masonite.request import Request
#..
​
def show(self, request: Request):
  # GET /dashboard?user_id=1
  request.user() #== <app.User.User>
If the user is not authenticated then this will be set to None
IP Address
You can fetch the IP address (ipv4) from which the request has been made by adding the IpMiddleware to the HTTP middlewares of the project:
# Kernel.py
from masonite.middleware import IpMiddleware
​
class Kernel:
    http_middleware = [
      # ...
      IpMiddleware
    ]
Then you can use the ip() helper:
def show(self, request: Request):
    request.ip()
IP address is retrieved from various HTTP request headers in the following order:
HTTP_CLIENT_IP
HTTP_X_FORWARDED_FOR
HTTP_X_FORWARDED
HTTP_X_CLUSTER_CLIENT_IP
HTTP_FORWARDED_FOR
HTTP_FORWARDED
REMOTE_ADDR
The first non-private and non-reserved IP address found by resolving the different headers will be returned by the helper.
The headers used and their order can be customized by overriding the IpMiddleware and changing the headers attribute:
class CustomIpMiddleware(IpMiddleware):
    headers = [
      "HTTP_CLIENT_IP",
      "REMOTE_ADDR"
    ]

The Basics - Previous

Response

Next - The Basics

Static Files

Last modified 3mo ago

Export as PDF

Copy link

Outline