v2.2 LTS
Masonite Essentials
Masonite 1.3 to 1.4

Masonite 1.4 brings several new features and a few new files. This is a very simple upgrade and most of the changes were done in the pip package of Masonite. The upgrade from 1.3 to 1.4 should take less than 10 minutes

This requirement file has the masonite>=1.3,<=1.3.99 requirement. This should be changed to masonite>=1.4,<=1.4.99. You should also run pip install --upgrade -r requirements.txt to upgrade the Masonite pip package.

There is now a new cache folder under bootstrap/cache which will be used to store any cached files you use with the caching feature. Simply create a new bootstrap/cache folder and optionally put a .gitignore file in it so your source control will pick it up.

Masonite 1.4 brings a new config/cache.py and config/broadcast.py files. These files can be found on the GitHub page and can be copied and pasted into your project. Take a look at the new config/cache.py file and the config/broadcast.py file. Just copy and paste those configuration files into your project.

Masonite comes with a lot of out of the box functionality and nearly all of it is optional but Masonite 1.4 ships with three new providers. Most Service Providers are not ran on every request and therefore does not add significant overhead to each request. To add these 3 new Service Providers simple add these to the bottom of the list of framework providers:
PROVIDERS = [
# Framework Providers
...
'masonite.providers.HelpersProvider.HelpersProvider',
'masonite.providers.QueueProvider.QueueProvider',
# 3 New Providers in Masonite 1.4
'masonite.providers.BroadcastProvider.BroadcastProvider',
'masonite.providers.CacheProvider.CacheProvider',
'masonite.providers.CsrfProvider.CsrfProvider',
# Third Party Providers
# Application Providers
'app.providers.UserModelProvider.UserModelProvider',
'app.providers.MiddlewareProvider.MiddlewareProvider',
]
Note however that if you add the CsrfProvider then you will also need the CSRF middleware which is new in Masonite 1.4. Read the section below to add the middleware

Masonite 1.4 adds CSRF protection. So anywhere there is any POST form request, you will need to add the {{ csrf_field }} to it. For example:
<form action="/dashboard" method="POST">
{{ csrf_field }}
<input type="text" name="first_name">
</form>
This type of protection prevents cross site forgery. In order to activate this feature, we also need to add the CSRF middleware. Copy and paste the middleware into your project under the app/http/middleware/CsrfMiddleware.py file.
Lastly, put that middleware into the HTTP_MIDDLEWARE list inside config/middleware.py like so:
HTTP_MIDDLEWARE = [
'app.http.middleware.LoadUserMiddleware.LoadUserMiddleware',
'app.http.middleware.CsrfMiddleware.CsrfMiddleware',
]

There has been a slight change in the constants used in the config/database.py file. Mainly just for consistency and coding standards. Your file may have some slight changes but this change is optional. If you do make this change, be sure to change any places in your code where you have used the Orator Query Builder. For example any place you may have:
from config import database
database.db.table(...)
should now be:
from config import database
database.DB.table(...)
with this change
Export as PDF
Copy link
On this page
Introduction
Requirements.txt File
New Cache Folder
New Cache and Broadcast Configuration
3 New Service Providers
CSRF and CSRF Middleware
Changes to Database Configuration