This is an old revision of the document!

belongsTo

This function is deprecated. Use ClassBelongsTo/TableBelongsTo/TableKeyBelongsTo instead.

Syntax

void ADODB_Active_Record::BelongsTo(
  string $relationName, 
  string $foreignKey, 
  optional string $parentPrimaryKey = 'id'
  )

Description

This function is the older way to define the parent of the current object.

Usage

In this example, we have a child table children, and a parent table person. We have a link children.person_id = persons.id. We create a child first, then link it to the parent:

class Child extends ADOdb_Active_Record{};
$ch = new Child('children',array('id'));
$ch->BelongsTo('person','person_id','id');  ## this can be simplified to $ch->BelongsTo('person')
                                            ## as foreign key defaults to $table.'_id' and
                                            ## parent pkey defaults to 'id'
$ch->Load('id=1');
$p = $ch->person;
if (!$p || $p->name_first != 'John') echo "Error loading belongsTo<br>";
else echo "OK loading BelongTo<br>";