belongsTo

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

Syntax

void 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'));
/*
* this can be simplified to $ch->BelongsTo('person')
* as foreign key defaults to $table.'_id' and
* parent pkey defaults to 'id'
*/
$ch->BelongsTo('person','person_id','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>";