DataMapper ORM v1.8.0

[eluser]WanWizard[/eluser]
DataMapper ORM 1.8.0

Download the Latest Version Here

View the change log and the upgrade process
Having issues? Please look through the Troubleshooting Guide & FAQs
View the Complete Manual
Search the Manual
(Due to the server's caching configuration, you may need to forcibly refresh your browser to see the changes in the manual.)

DataMapper (DM) is an Object-Relational Mapper that builds on ActiveRecord. Data is loaded from database tables into objects, and relationships can be managed through simple, easy-to-read functions.

DataMapper ORM adds several important features to DM(Z), further enhancing it's usage, usually without requiring any code changes.

To install DataMapper ORM over DMZ, the (fairly simple) upgrade process is described here.

DataMapper offers these features:
• Everything is an object!
• Easy to setup, easy to use.
• Custom Validation on object properties.
• Lazy Loading (related objects are only loaded upon access).
• Relations and their integrity are automatically managed for you.
• One to One, One to Many, and Many to Many relations fully supported.
• Select data in the style of Active Record (with or without Method Chaining).

You can learn much more from the manual.

----------

Version 1.8.0:
* New Features
o Added a new extension which allows you to use Datamapper for nested set tree management.
o Added dutch language file.
o Added a new extension which allows you to use Datamapper for nested set tree management.
o It is now possible to define model relations, and update the model production cache, at runtime.
o Updated the select() method to accept an array of column names next to a comma delimited string, like CodeIgniters Activerecord does.
o The updated column can now be modified manually. The save method will save the update even if the updated timestamp is the only modified field.
o The column name is now used as key of the error->all array, which allows you to reference the column name when iterating over the errors.
o Added (experimental) support for reciprocal many-to-many relationships. See Advanced Relationships.
o Added the option to define the name of the relationship table in an advanced relationship definition.
o Added the option to run $object->{query}_related using a Datamapper object as $value. In case the object contains multiple values, the query will be transformed to a 'where_in' query using the id's in the objects resultset.
o >Added the option to run $object->{query}_related using an array of id's. If the array contains multiple values, the query will be transformed to a 'where_in' query using the id's in the objects resultset.
* Bug Fixes
o Fixed problem with get_iterated when using PHP 5.3+ which doesn't do an implicit type conversion from array to object, causing an isset() to fail.
o Fixed PHP fatal error when loading a model when using CI 2.0 packages or Modular CI, and a package or module is missing a models directory.
o Fixed incorrect SQL count and SQL error on get_paged and get_paged_iterated when paging through a related table, linked to the parent using a relationship table, and including a where clause on a parent column.
o Fixed race condition that could case a fatal error due to recursion when deleting ITFK's.
* Other Changes
o All language files have been converted to UTF-8.
o Replaced hardcoded check for the MY_ prefix with the 'subclass_prefix' config value when autoloading classes.
o When using include_join_fields, the id field of the relationship table is included as well.
o Added some info about the post_model_init method to the documentation.
o The manual now makes it clear that there are several reasons for a save to fail and gives some examples of what to check.

Make sure to check out the changelog — you won't want to skip this update!

----------

Bug reports and feature requests:

Please use the issue register / bug tracker on bitbucket to report new bugs or for new feature requests. If you do, please include in your description is link to the thread on this forum discussing the issue (if possible), so I have a link between the two and can keep track of all issues.

----------

Older Discussions: Version 1.7.1, Version 1.6.2, Version 1.5.4, Version 1.5.3 and older.

Thanks goes to Overzealous, for all he has achieved with DMZ. And to stensi, for providing such an amazing code base to work on.