CakeEntity
The ActiveRecord
for CakePHP
@basuke
https://github.com/kanshin/CakeEntity

• @basuke
• Mac / iPhone / Newton
• PHP : 10+ years

http://www.kanshin.com/ 2001
AssistOn http://www.assiston.co.jp/ 2004
https://tabidachi.ana.co.jp/ 2006

CakeEntity
• CakePHP
• Active Record Model
•
• GitHub
• https://github.com/kanshin/CakeEntity
• CakePHP 1.3, PHP 5.2 >

CakeEntity
•
• CakePHP 1.3.11 1.3.12 up
• Smarty Cake
• CakeSmarty
•

Active Record
ActiveRecord is "an object that wraps a row in a
database table or view, encapsulates database
access and adds domain logic on that data".
Fowler, 2003
http://www.martinfowler.com/books.html

Active Record

CakeEntity
find
$post = $this->Post->entity(); //
$post->content = "Hello world!";
$post->save(); //

CakeEntity
• array() [ ]
•
•
•
•

Prepare

first things first
entity
app/plugins/entity/
or
plugins/entity/

EntityModel extends
App::import('Model', 'Entity.EntityModel');
class Post extends EntityModel {
...
}

Find

'entity' => true
$this->Post->find('all', array(
'conditions' => ...
'order' => ...
'entity' => true,
));

������������
$result = [
{id: 1, title:"title1", author_id:"123", ... }
{id: 2, title:"title2", content:"...", }
...
];
// paginate()

// Post -> belongsTo -> Author
$this->Post->find('all', array(
'conditions' => ...
'contain' => array('Author'),
'entity' => true,
));

$result = [
{title:"title1", author: {id:3,
name:"Basuke"}, ... }
{title:"title2", author:null, ... }
...
];
//

hasMany
// Post -> hasMany -> Image
$this->Post->find('all', array(
'conditions' => ...
'contain' => array('Image'),
'entity' => true,
));

$result = [
{title:"title1", images: [ {path:"..."},
{path:"..."}] }
{title:"title2", images: [{path:"..."}, ...] }
...
];
// w

load

$post = $this->Post->find('first', array(
'conditions' => array('id'=>$id),
'entity' => true,
));
or
$post = $this->Post->entityById($id);

instantiation

$post = $this->Post->entity();
$post->title = “Hello”;
•
$post = new PostEntity();

Save

$post->title = "Hello world";
$post->content = file_get_content(...);
if ($post->save()) {
$this->isCool();
}

Entity
Entity
EntityModle Entity

Entity + Entity
entityClass()

protected function entityClassForData($data) {
switch ($data[‘type’]) {
case ‘hyper’:
return ‘HyperPostEntity’;
default:
return ‘PlainPostEntity’;
}
}

isHidden(), publish()

• $post->property_name
• $post[‘property_name’]
• $post->some_method()
• $post[‘some_method’]
•
• []

{Smarty}
• Smarty
{$post.property_name}
• ()
•
•

public function allows() {
return array();
}
• allows()
• public

public $comments;
public function comments() {
$Comment = $this->getModel()->Comment;
return $Comment->find(array(
...
));
}
• $post[‘comments’]

CakePHP 2.0 w
Many to Many

w
README.md

Thanks
http://d.hatena.ne.jp/basuke/