5
CHAPTER 1
Migrating Applications from ColdFusion 5
This chapter describes migration and known compatibility issues between ColdFusion Server 5
and later versions, including ColdFusion MX 6.1 and ColdFusion MX 7 (referred to in this
chapter as ColdFusion MX).
Contents
Migrating to ColdFusion MX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Planning your migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Using the Configuration and Settings Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Using the ColdFusion Code Compatibility Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Database operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Localization and character handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Other changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Tag and function examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Migrating to ColdFusion MX
When you migrate your existing ColdFusion Server 5 applications to ColdFusion MX, you might
encounter a few incompatibilities between ColdFusion 5 and ColdFusion MX. Macromedia
strongly encourages you to develop a migration plan for porting existing ColdFusion 5
applications to ColdFusion MX. For more information, see
“Planning your migration” on page 6
.
Whether you encounter incompatibilities depends on the features of ColdFusion and the CFML
elements that your existing applications use. This guide lists known incompatibilities and suggests
possible fixes. Also, you can use the Code Compatibility Analyzer to facilitate locating and fixing
incompatible code; for more information, see
“Using the ColdFusion Code Compatibility
Analyzer” on page 10
.
Note:
This guide provides migration and incompatibility information for customers moving from
ColdFusion 5 to ColdFusion MX. Most of this information also applies to ColdFusion 4.5, so
references to ColdFusion 5 also applies to ColdFusion 4.5. For information about earlier versions of
ColdFusion, see the Support section of the Macromedia website (
www.macromedia.com/support
).