Вот небольшой пример определения модели в CakePHP:

<?php

class Ingredient extends AppModel {
    var $name = 'Ingredient';
}

?>

1. <?php
2. class Ingredient extends AppModel {
3. var $name = 'Ingredient';
4. }
5. ?>

Эти простое объявление модели Ingredient дает возможность пользоваться всем функционалом, который необходим для создания или удаления данных. Эти волшебные методы наследуются от модели CakePHP. Модель Ingredient расширяем модель приложения AppModel, которая в свою очередь расширяет внутренний класс модели CakePHP.

Этот промежуточный класс AppModel по умолчанию пуст и живет здесь /cake/ по умолчанию. Переопределение этого класса дает вам возможность определить методы, которые будут доступны всем моделям вашего приложения. Для этого вам нужно создать свой файл app_model.php в корне /app/ folder. Создавая проект при помощи Bake, этот файл будет автоматически создан.

Создавать PHP файл вашей модели нужно в директории /app/models/ или во вложенных директориях /app/models. CakePHP найдет все модели автоматически. По соглашению, имя файла должно быть такое же как имя класса(для нашео примера ingredient.php).

CakePHP динамически создает модель объекта, если даже он не найдет файл в /app/models. Это также значит, что если случайно вы неправильно обозвали файл(например Ingredient.php или ingredients.php) CakePHP будет использовать AppModel, а не ваш неправильно обозванный класс. Если вы попробуете вызвать пользовательский метод своей модели, то вы получите SQL ошибку, так как CakePHP не нашел вашей модели.

Посмотрите также Поведения для подробной информации о том как применить одинаковую логику в нескольких моделях.

Атрибут $name обязателен для PHP4 и неважен для PHP5.

Когда ваша модель определена, доступ к нем можно получить из With your model defined, it can be accessed from within your Контроллера. CakePHP автоматически сделает модель доступной когда ее имя совпадет с именем контроллера. Например, контроллер IngredientsController автоматически инициализирует модель Ingredient и добавит ее в контроллер как$this->Ingredient.

<?php

class IngredientsController extends AppController {
    function index() {
        //вытянуть все ингредиенты и передать их в отображение:
        $ingredients = $this->Ingredient->find('all');
        $this->set('ingredients', $ingredients);
    }
}

?>

1. <?php
2. class IngredientsController extends AppController {
3. function index() {
4. //вытянуть все ингредиенты и передать их в отображение:
5. $ingredients = $this->Ingredient->find('all');
6. $this->set('ingredients', $ingredients);
7. }
8. }
9. ?>

Связанные модели доступны из основной модели. В следующем примере модель Recipe связана с моделью Ingredient.

$this->Recipe->Ingredient->find('all');

1. $this->Recipe->Ingredient->find('all');

Как вы уже знаете, в Контроллере мы можете подключить множество моделей и иметь доступ к ним прямо из контроллера. В следующем примере обе модели Recipe и User доступны из текущего контроллера.

<?php
class RecipeController extends AppController {
    var $uses = array('Recipe', 'User');
    function index() {
       $this->Recipe->find('all');
       $this->User->find('all');
    }
}
?>

1. <?php
2. class RecipeController extends AppController {
3. var $uses = array('Recipe', 'User');
4. function index() {
5. $this->Recipe->find('all');
6. $this->User->find('all');
7. }
8. }
9. ?>

Если вы не добавили модель используя $uses, тогда вам для ее использования необходимо сперва импортировать, а потом уже использовать в контроллере.

<?php
class RecipeController extends AppController {
    var $uses = array('Recipe');
    function index() {
       $this->Recipe->find('all');

       App::import('Model', 'User');
       $user = new User();
       $user->find('all');
    }
}
?>

1. <?php
2. class RecipeController extends AppController {
3. var $uses = array('Recipe');
4. function index() {
5. $this->Recipe->find('all');
6. App::import('Model', 'User');
7. $user = new User();
8. $user->find('all');
9. }
10. }
11. ?>