Check it out at http://forum.phpburn.com

Using PhpBURN you can extend a MySQL model using a MSSQL model… how? Let me show you:

In system/config/model.php you can configure as many packages you want with lots of information such as host, database, username, password, dialect, etc…

So let’s use an example using two packages, the first one will be a MySQL package running in our localhost machine and the second one will be a MSSQL package running on 192.168.0.100.

$thisConfig = array(
		/**
		 * Database configuration ( Default )
		 *
		 * This configuration will be used by defaul when
		 * package configs are not setted up
		 */
		'dialect' => 'MySQL',
		'database' => 'mysqlBurnTest',
		'user' => 'phpburn',
		'password' => 'phpburn',
		'port' => '3306',
		'host' => 'localhost',

		/**
		 * Structure configuration
		 */
		'class_path' => SYS_MODEL_PATH,

		/**
		 * database-options changes according to the database used
		 * So if you want to know what options have each database please
		 * look at documentation in section Dialects
		 *
		 * OPTIONAL
		 */
		'database_options' => array(),

		/**
		 * options are general configs for the project
		 * See Configuration section at documentation for more information
		 *
		 * OPTIONAL
		 */
		'options' => array(),

			'packages' => array(
				'mysqlPackage',
                'mssqlPackage' => array(
					'dialec' => 'MSSQL',
                    'database' => 'mssqlBurnTest',
					'host' => 192.168.0.100,
					'username' => 'sa',
					'password' => 'phpburn' //note that i dont need to put here a data that is already configured on default configs ( above ) but i will set it anyway
                )
			)
);

Well now we have our database configured and all packages configureds let’s go to system/model/mysqlPackage/ and create our model PersonalData:

	class Personaldata extends PhpBURN_Core {
	public $_tablename = "PersonalData";
	public $_package = "mysqlPackage";

	  public $idPersonalData;
	  public $name;
	  public $lastName;
	  public $birthday;
	  public $createdAt;

	public function _mapping() {
	     $this->getMap()->addField( "idPersonalData","idPersonalData", "int", 11, array("primary" => 1, "not_null" => 1, "auto_increment" => 1) );
	     $this->getMap()->addField( "name","name", "varchar", 45, array("not_null" => 1) );
	     $this->getMap()->addField( "lastName","lastName", "varchar", 45, array("not_null" => 1) );
		 $this->getMap()->addField( "birthday","birthday", "datetime", null, array("not_null" => 1) );
	     $this->getMap()->addField( "createdAt","createdAt", "timestamp", null, array("not_null" => 1, "default_value" => 'CURRENT_TIMESTAMP') );
	}
}

Well, now we have all set for MySQL model, let’s extend it using a MSSQL model and persist all data transparently it means you will use two models at same time, connecting to different tables in different database in different hosts, etc….

Creating MSSQL Model Users at system/model/mssqlPackage/

	class Users extends PersonalData {
	public $_tablename = "Users";
	public $_package = "mssqlPackage";

	  public $idUsers;
	  public $login;
	  public $password;
	  public $idPersonalData;
	  public $createdAt;

	public function _mapping() {
	     $this->getMap()->addField( "idUsers","idUsers", "int", 11, array("primary" => 1, "not_null" => 1, "auto_increment" => 1) );
		 $this->getMap()->addField( "idPersonalData","idPersonalData", "int", 11, array("not_null" => 1) );
	     $this->getMap()->addField( "login","login", "varchar", 255, array("not_null" => 1) );
	     $this->getMap()->addField( "password","password", "varchar", 255, array("not_null" => 1) );
	     $this->getMap()->addField( "createdAt","createdAt", "datetime", null, array("not_null" => 1, "default_value" => 'NOW()') );

		 $this->getMap()->addParentField('idPersonalData'); //Here the magic happens
	}
}

Now if you just do:

$user = new Users();

$user->login = 'klederson';
$user->password = 'phpburn';
$user->name = 'Klederson';
$user->lastName = 'Bueno';
$user->birthday = '1986-05-17';

$user->save();

It will save in both tables, reference one to another and if you do a $user->get($pk); it will bring all information as you are working in one table. It can be pretty handy on Legacy systems or even in integration between different systems using different databases.

That’s all for now… Be happy

To work with reverse engineer is pretty easy, you just run reverse.php that is already in you generated application or create a script with this content:

################################
# Hooks
################################
define('SYS_USE_FIREPHP',true,true);

################################
# Including required files
################################
require_once('app/phpBurn.php');
require_once('config.php');

//Migrations tool
PhpBURN::load('Migrations.Reverse');

################################
# Starting application
################################
PhpBURN_Reverse::init();

PS: Many to many relationships should be written in the MySQL standars: ( Tablename_has_OtherTablename ) and than magic happens

Than you just run this script and all your configured packages and databases will be created ( don’t forget to chmod 777 your model folders ).

Let’s test it, more options and a graphical interface are comming soon.

Well folks, that is it for now, we are accepting contributions anyhow ( money, work, etc ).

PhpBURN group at Google Groups: http://groups.google.com/group/phpburn

First let’s see PhpBURN in action:

/*
	PhpBURN
*/
$user = new User();
$user->username = 'john';
$user->password = 'password';
$user->save();

$user->username = 'john';
$user->find();

echo $user->username; // prints 'john'

echo $user->find(); // echo '2''

while($user->fetch()) {
	echo $user->username;
}

/*
	DOCTRINE
*/
$user = new User();
$user->username = 'john';
$user->setPassword('password');
$user->save();

$userTable = Doctrine_Core::getTable('User');
$user = $userTable->findOneByUsername('john');

echo $user->username; // prints 'john'

$users = $userTable->retrieveAll();

echo $users->count(); // echo '2''
foreach ($users as $user)
{
  echo $user->username;
}

The goal here it’s to show that when you use PhpBURN you have already set all your needs like persistend methods and all “stuff” then you don’t need to keep setting facade methods, you just go using them.

First of all let’s see how to build a EXTENDABLE Model in PhpBURN:

class BaseUser extends PhpBURN_Core {
	public $_tablename = 'users';
	public $_package = 'phpburn';

	public function _mapping() {
		$this->getMap()->addField('id','id','int',4,array('primary' => true, 'autoincrement' => true));
		$this->getMap()->addField('username', 'username', 'varchar', 255, array());
		$this->getMap()->addField('password', 'password', 'varchar', 255, array());

		$this->getMap()->addRelationship('Groups',self::ONE_TO_MANY,'UserGroup','id','user_id');
	}
}

class User extends BaseUser {

}

/* You do Not need any more configuration because the PhpBURN works as ORM, DAO, ActiveRecord and DataMapper, you're all set

Now le’ts see it’s equivalent in Doctrine:

/**
 * This class has been auto-generated by the Doctrine ORM Framework
 */
abstract class BaseUser extends Doctrine_Record
{

  public function setTableDefinition()
  {
    $this->setTableName('user');
    $this->hasColumn('id', 'integer', 4, array('primary' => true, 'autoincrement' => true));
    $this->hasColumn('username', 'string', 255);
    $this->hasColumn('password', 'string', 255);
  }

  public function setUp()
  {
    $this->hasMany('Group as Groups', array('refClass' => 'UserGroup',
                                            'local' => 'user_id',
                                            'foreign' => 'group_id'));

    $this->hasMany('UserGroup', array('local' => 'id',
                                      'foreign' => 'user_id'));
  }

}

// Add custom methods to system/application/models/User.php

/**
 * This class has been auto-generated by the Doctrine ORM Framework
 */
class User extends BaseUser
{
  public function setPassword($password)
  {
    $this->password = md5($password);
  }
}

/**
 * This class has been auto-generated by the Doctrine ORM Framework
 */
class UserTable extends Doctrine_Table
{
  public function retrieveAll()
  {
    $query = new Doctrine_Query();
    $query->from('User u');
    $query->orderby('u.username ASC');

    return $query->execute();
  }
}

Both frameworks has Reverse Engineer and Foward Engineer to create Model and Database Tables.