RedBeanPHP 4
The Power ORM

Meta data

Beans contain meta data. For instance, the type of the bean is stored in the meta data. To obtain the type of a bean:

    $bean->getMeta'type' );

You can also store your own meta data in a bean:

    $bean->setMeta'''secret' );

this data will not get stored in the database.


Some meta data is accessible using convenience method. For instance, if you would like to know whether a bean has been changed since it got retrieved from the database use the tainted() method.



$bean->getMeta'tainted' );

Note that a bean is marked as tainted if a list gets accessed. You can also set the tainted flag yourself.


To determine if a certain property has changed:

    $book R::load'book'$id );
$book->hasChanged'title' ); //returns FALSE
$book->title 'New title';
$book->hasChanged'title' ); //returns TRUE

These properties will be marked as changed even if you do a R::store(), if you would like to clear the history after every store use:

    OODB::autoClearHistoryAfterStoreTRUE );

To manually clear the history of a bean:


To get the old value of the property:

    $book->old'title' );

The behaviour of hasChanged sometimes suprises people, for instance take a look at the following code:

    $employee R::load'employee'$id );
var_dump$employee->hasChanged'organisation' ) ); //FALSE
var_dump$employee->hasChanged'organisation_id' ) ); //FALSE
$employee->organisation $newOrganisation;
var_dump$employee->hasChanged'organisation' ) ); //TRUE
var_dump$employee->hasChanged'organisation_id' ) ); //FALSE

The reason for this behaviour is that organisation_id will not be updated automatically until you call R::store(). Until, then the property has not been changed.

List Changed (4.2+)

To determine whether a list has been changed (beans have been added or deleted):

    $author->hasListChanged'ownBook' );

This method will return TRUE if some elements of the array have been removed or added. Note that this method does not check the state of the beans themselves. It's just about the list.

Testing Equality

To test whether two beans have the same type and primary key ID:

    $bean->equals$otherBean );


To determine if a bean is empty, or only contains empty values (everything that qualifies as empty() in PHP) use:


Copy meta data

You can copy meta data from another bean like this:

    $bean->copyMetaFrom$otherBean );


RedBeanPHP Easy ORM for PHP © 2015 () and the RedBeanPHP community () - Licensed New BSD/GPLv2 - RedBeanPHP Archives