DataMapper ORM

Upgrading Instructions

Upgrading requires replacing a few files, and sometimes updating your configuration. You can upgrade from a previous version of Datamapper ORM, from DMZ, or the original DataMapper.

All versions

Then look below for additional, specific changes for each version.

Upgrading from a previous version of DataMapper ORM

You can determine which version of Datamapper ORM you are using by looking at the top of application/libraries/datamapper.php

From 1.8.1 to 1.8.2

From 1.8.0 to 1.8.1

Upgrading from Datamapper DMZ "OverZealous" Edition

From 1.7.1 to 1.8.0

From 1.7.0 to 1.7.1

From 1.6.2 to 1.7.0


From 1.6.1 to 1.6.2

From 1.6.0 to 1.6.1

From 1.5.4 to 1.6.0


From 1.5.3 to 1.5.4


From 1.5.2 to 1.5.3


From 1.5.1 to 1.5.2


From 1.4.x to 1.5.1


Older Upgrades

You can find upgrade instructions for older versions by downloading a previous version of DataMapper. Version 1.6.2 contains all of the upgrades through 1.6.2.


Upgrading from the original DataMapper

If you are upgrading from the original DataMapper, these are the steps you should take.

  1. Update your application/config/datamapper.php file, as there are a few new items.
  2. Overwrite application/libraries/datamapper.php.
  3. Overwrite application/language/english/datamapper.php.
  4. Optionally, upload the application/datamapper directory to your CodeIgniter application folder, to enable the use of extensions.
  5. Look over the upgrade information above, to see if you are using any hacks or tricks that may be broken by Datamapper ORM's new features.
  6. After reading through this manual, you may want to adopt many of the new features throughout your code!