Upgrade Fusebox 4.x to Fusebox 5.x

Upgrading from Fusebox 4.x to Fusebox 5.x is hands down the easiest upgrade in fusebox history. In the past (specifically Fusebox 3 to 4) one of the most difficult issues to overcome in upgrading the fusebox framework was the migration to xml circuit file syntax. Fusebox 4 to 5 is backwards compatible, so those concerns are no longer.

Where to Get started

If you are upgrading from Fusebox 4 to 5, you will want to follow the same steps as described within the Fusebox 5 Installation instructions.

Since you are already familiar with Fusebox, this should be pretty comfortable territory for you, as the major difference is just with the core files themselves. In Fusebox 4, the core files were located in your www root folder, including the fusebox core file code as follows:

After following the Fusebox 5 Installation instructions for the Core files, this will be the only line of code you will need to change to get your Fusebox 4 code files up and running with the Fusebox 5 core files.

Application.cfc vs Application.cfm

If you are NOT using Application.cfc, you will invoke the Fusebox 5 core files as follows, replacing your old fusebox include statement in your index.cfm file:

If you are using Application.cfc, you can extend the Fusebox core file cfc as follows:

If you have downloaded the skeleton Fusebox application files, and are using the traditional version xml code base, be sure to check this out if you are using Application.cfc. This set of files will invoke the fusebox core files twice, once via Application.cfc and the second time in your index.cfm file.

As noted in the index.cfm comments: