Основное взаимосогласие или принятие определенных практик или позиций: По соглашению, север находится вверху большинства карт.
Практика или процедура широко проглядываемая в группе, особенно для облегчения социального взаимодействия проще: соглашение о рукопожатии.
Широко-используемое и принятое устройство или техника, как драма, литература, или рисование: театральное соглашение об отходах в сторону (чтобы прошептать что-то).
Соглашение в Cake это то, что творит чудеса, прочтите automagic. Не стоит упоминать даже о популяризации соглашения на конфигурацию, Cake увеличивает вашу продуктивность до пугающего уровня без потерь в гибкости. Соглашения в cake действительно просты и интуитивно понятны. Они были извлечены у лучших практиков хороших веб-разработчиков, которые использовались годами на поле веб-разработки.
Имена файлов
Имена файлов подчеркнуты. Как основное правило, если у вас есть класс My Nifty Class?, тогда в Cake, этот файл должен быть назван my_nifty_class.php.
Так что если вы найдете snippet вы автоматически узнаете что:
Если это имя контроллера Kisses And Hugs Controller?, то имя его файла kisses_and_hugs_controller.php
Если это имя модели Option Value?, тогда имя файла будет option_value.php
Если это имя компонента My Handy Component? тогда имя его файла должно быть my_handy.php
Если это имя хелпера Best Helper Ever?, тогда имя файла должно быть best_helper_ever.php
Модели
Имена классов моделей число единичное.
Имя класса модели пишется с большой буквы для однословной модели, и КаждоеСловоИмениМодели с большой в много-словном названии. (Примеры: Человек, Обезьяна, СтекляннаяДверь, РеальноСмешнаяШтука)
Соединенные таблицы методом многие-к-многим должны быть названы: по-алфавиту_первая_таблица_множественное_число_по-алфавиту_вторая_таблица_множественное_число например: tags_users
Имена файлов моделей используют нижний регистр и подчеркивание. (Примеры: person.php, monkey.php, glass_door.php, line_item.php, really_nifty_thing.php)
Таблицы базы данных, относящиеся к моделям также используют нижний регистр и подчеркивание – но они в множественном числе. (Примеры: people, monkeys, glass_doors, line_items, really_nifty_things)
Соглашение о присвоении имен Cake PHP? стремиться упростить написание кода и сделать его более читабельным. Если вы сможете добиться этого своим способом, замените наш.
Имя модели: Установите var $name в определение вашей модели.
Таблицы базы данных, относящиеся к моделям: установите var $useTable в определение вашей модели.
Контроллеры
Имена классов контроллеров в множественном числе.
Схема названий контроллеров та же что и моделей, только в конце добавляется окончание 'Controller'. (Примеры: People Controller?, Monkeys Controller?, Glass Doors Controller?, Line Items Controller?, Really Nifty Things Controller?)
Имена файлов также как и у моделей, только с окончанием '_controller'. Так что если у вас есть Posts Controller?, то имя его файла должно быть posts_controller.php (Примеры: people_controller.php, monkeys_controller.php, glass_doors_controller.php, line_items_controller.php, really_nifty_things_controller.php)
Для защищенной видимости, именам действий контроллера должны передовать '-'.
Для приватной видимости, именам действий контроллера должны передовать '--'.
Отображения
Отображения называются как действие, которое они отображают.
Имя файла отображения такое же как имя действия, в нижнем регистре. (Примеры: People Controller?::worldPeace() ожидает отображения /app/views/people/world_peace.thtml; Monkeys Controller?::banana() ожидает отображения /app/views/monkeys/banana.thtml.)
Вы можете заставить действие рендерить определенное отображение вызвав $this->render('name_of_view_file_without_dot_thtml'); в конце действия.
Хелперы
Имя класса хелперов – каждое слово в имени с большой буквы, окончание “Helper”, имя файла с подчеркиванием. (Примеры: class My Helper Helper? это хелпер /app/views/helpers/my_helper.php.)
Включается в контроллере масивом $helpers=array('Html','MyHelper'); в отображении доступен с $myHelper->method().
Компоненты
Имя класса компонента такое же как у хелперов, но окончание “Component”, имя файла с подчеркиванием. (Пример: класс My Component Component? расширяет объект в /app/controllers/components/my_component.php.)
Включается в контроллер с $components =array('MyComponent'); в контроллере доступен с $this->My Component?->method().
Вендоры
Вендоры не следуют никакому соглашению по очевидным причинам: они третьестепенные части кода, у Cake нет контроля над ними.
