What's New in 3.3.0
The embedded CommandBox server have seen a number of nice enhancements to make it easier for you to use CommandBox for super easy local development.
The more people begin to use CommandBox for local development, the more interested they became in being able to run FusionReactor on their dev servers to help trouble shoot their code. That's why we created a CommandBox FusionReactor module. It's not part of the core, but can be installed in a single command and will attach FusionReactor's server monitor to every server you start. You'll need to have a FusionReactor license or sign up for a trial to use it.
install commandbox-fusionreactor
fr register "your FR license key"
server start
fr open
CommandBox allows you to create web aliases for the web server that are similar to virtual directories. The alias path is relative to the web root, but can point to any folder on the hard drive. Aliases can be used for static or CFM files. To configure aliases for your server, create an object under web called alises. The keys are the web-accessible virtual paths and the corresponding values are the relative or absolute path to the folder the alias points to.
Here's what your server.json might look like.
{
"web" : {
"aliases" : {
"/foo" : "../bar",
"/js" : "C:\static\shared\javascript"
}
}
}
Here's how to create aliases from the server set command:
server set web.aliases./foo = bar
You can customize the error page that CommandBox servers return. You can have a setting for each status code including a default error page to be used if no other setting applies.
Create an errorPages object inside the web object in your server.json where each key is the status code integer or the word default and the value is a relative (to the web root) path to be loaded for that status code.
This is what you server.json might look like:
{
"web" : {
"errorPages" : {
"404" : "/path/to/404.html",
"500" : "/path/to/500.html",
"default" : "/path/to/default.html"
}
}
}
You can set error pages via the server set command like this:
server set web.aliases.404=/missing.htm
You can customize these tray menus and add your own option for your convenience. To add a menu contribution to an individual server, add the following to your
server.json:{
"trayOptions":[
{
"label":"Foo",
"action":"openbrowser",
"url":"http://${Setting: runwar.host not found}:${Setting: runwar.port not found}/foobar.cfm",
"disabled":false,
"image":"/path/to/image.png"
}
]
}
We've updated to a new library that creates the tray icon for your running servers and the menu that appears when you right click. In addition to better support for some Linux distros, we've added some nice new icons to the menus.
Before any package script is run, CommandBox will look for another package script with the same name, but prefixed with pre. After any package script is run, CommandBox will look for another package script with the same name, but prefixed with Post. So if you have a package that contains 3 package scripts: foo, preFoo, and postFoo, they will run in this order.
- 1.preFoo
- 2.foo
- 3.postFoo
This works for built-in package script names as well as as doc package scripts. It also works on any level. In the example above, if you created a 4th package script called prePreFoo, it would run prior to preFoo.
If you use more than one ForgeBox login, perhaps a personal one and a company one, it can be a pain to keep logging in. It's also hard to remember the last user you logged in with. We've introduced two new commands to help with this. Run this to tell you who you are logged in as:
forgebox whoami
Run this to switch between users that you've previously logged in with:
forgebox use myUser
We've added a new "onRelease" interceptor and package script to help with the workflow of publishing packages. Here's a run down of the three key points when bumping a package version.
- preVersion - Announced before the new version is set using the bump command
- postVersion - Announced after the new version using the bump command but before the Git repo is tagged.
- onRelease - Announced after a new version is set using the bump command and after the Git repo is tagged.
Here is a typical package script work flow for working with a package that's hosted on GitHub and published to ForgeBox:
"scripts":{
"preVersion":"testbox run",
"postVersion":"package set location='gituser/repov#`package version`'",
"postPublish":"!git push --follow-tags"
}
Then when you want to publish a new version of your package, commit your changes to Git and run the following commands:
bump --minor
publish
Those two commands, in combination with your package scripts, would accomplish the following:
- 1.Run the package's test suite (a failure will abort the process)
- 2.Increase the minor version of the page
- 3.Tag the Git repo
- 4.Change the package's location property in box.json to point to the new tag
- 5.Commit the tag and new box.json
- 6.Publish the package to ForgeBox
- 7.Push the new box.json and Git tag
Announced while a package is being installed, after the package endpoint and installation directory has been resolved but before the actual installation occurs. This allows you to override things like the installation directory based on package type. Any values updated in the interceptData struct will override what the install command uses.
The Lucee version that the CLI runs on has been updated to be 4.5.3.020 which is also now the default engine to be used when you use the "server start" command and don't specify a cfengine. If you still want to start a web server on Lucee 4.5.2.018, then simply to this:
start cfengine=[email protected]+018
There are tons of little bug fixes in this version that you can view in our release notes.
- [COMMANDBOX-437] - appSkeleton in the coldbox create app wizard needs to comply to IDs instead of local disk
- [COMMANDBOX-465] - custom url rewrite location doesn't respect starting server by name in different location
- [COMMANDBOX-431] - Update the storage of the APIkey in the commandbox settings to include multiple keys
Last modified 1mo ago