FAQ is the collection of discussions on common problems & solutions
Feel free to add any useful discussions or solutions.

Once the Cookbook is finished, we may not need this page.
Last Updated: 2008-04-23

Good docs on CakePHP?

• [new]CakePHP Cookbook [Generate Live PDF Version (copy and paste link to avoid remote linking block)] [Saved PDF version] [Highly recommended]
• CakePHP 1.2 docs[Highly recommended]
• Unofficial CakePHP forum - with good discussions
• CakePHP IRC chat logs
• CakePHP Super Feed [rss]
• CakePHP Presentations

Security Notes

• [New]Conditions facility permits unintended queries to be executed (Widely used/advertised find() usage could result in security exploit) Discussion/solution[Highly recommended]
• Form fiddling/forgery security threat and solution (Another solution is to use Security component) [Highly recommended]
• Router::parseExtensions(); - Important security note

Core hacks for bugs(?)

Note: Possibly wait till core devs work on it.

• [New]Conditions facility permits unintended queries to be executed (Widely used/advertised find() usage could result in security exploit) Discussion/solution[Highly recommended]
• Small but annoying bug in save() in model.php: won't allow for old/simple HABTM syntax

What is the difference between 1.1 and 1.2?

• OCPHP presentation [pdf]
• new features in CakePHP 1.2
• https://trac.cakephp.org/changeset/4981
• New CakePHP Releases (1.2.0.5875 pre-beta)

How to have Multi-record input in one form?

Note: This seems to be fixed now

• isMultiRecord?

Problem:
CakePHP standard is to have the form fields name to be like data[Model][field]
This works fine when you want to edit a single record with the edit page /edit/\\46lt;id\\46gt;

But, if we want to edit more than one record in a single page, you'd need to set the field names like data[Model[id]][field] But, the current form helper seems to be unusable now for HABTM associations.

• Multiple Records in one View
• The mikee Method
• Ticket #3044 (new Enhancement) Multi-Record forms: multiple records for a model in one single form Patch that helps the form helper to be usable like $form-\\46gt;input("Model.".$id.".field");

Feel free to update if you know any better options/solutions.

How handle Ajax redirection? / How to handle Ajax form?

• cakephp 1.2 form

How to use validation in 1.2?

• CakePHP Cookbook
• All About Validation in CakePHP 1.2 Note: Though this is the best available resource on validation, it still uses deprecated validation constants; valid usage is still not documented
• Multiple rules of validation per field in CakePHP 1.2 (But, it might be more manageable to have error message defined in model than at view via form helper)
  Also, possibly check the better version from Ian Farr
  
• User type (admin, user) based validation by grigri
• [new] model validation - how do you handle different rules for different forms? (action-based validation; check the whole thread)

How to handle tricky HasAndBelongsToMany situations?

• Filtering HABTM associations using columns in both models
• filtering HABTM data (once more)
• Filtering HABTM data - Find content by tag name (workaround?)
• Saving HABTM with cake
• 
  
• new "With" Associations in a HABTM Note: But, it looks like that with is unnecessary with the current svn version. Still it's not clear how to add/edit extra data with HABTM. Feel free to update if you know any better options/solutions. Still requires a clear and concise tutorial.
• Modelizing HABTM join tables in CakePHP 1.2: with and auto-with models
• ternary model
• Google Search "self habtm"
• One-to-many and one-to-one relationships between the same two tables...
• Mi Blog - Blog of Andy Dawson, HABTM expert
• Paginate HABTM results
  • How to paginate HABTM results?
  • Pagination of data from a HABTM relationship
  • Paginating HABTM associations by nate
  • Problem with Paginate HABTM and hasMany results., paginate() omit hasMany relation - from francky06l

How to display more views/blocks in a single page?

• renderElement- Preferred
• requestAction

Related discussions:

• Creating Reusable Elements with requestAction - Bakery article by gwoo. Highly recommended.
• how manage more than one operation in the same view
• incorporating many views
• multiple controllers on 1 page
• include another model's view
• Mini Controllers - modular page design
• Snook Elemental content

Performance Issues with requestAction:

• Message from discussion CakePHP processing order
• Layers of Cake[pdf]
  

How to add webservice support?

• how to use parseExtensions
• Router::parseExtensions(); - Important security note

How to use MediaView? (How to handle file downloads?)

• Snippets for MediaView usage - Note: still session locking (session_write_close) issue seems to be there

How to add theme support?

• How to Add Theme Support?

What is behavior?

Helpers are for Views, Components are for Controllers, and Behaviors are for Models. Behaviors meant to change the behavior of models or enhance the models

• [new]Behaviors in CakePHP 1.2 - Making your models behave - Presentation by Mariano Iglesias [pdf]
• More about Behaviors ?
• More about Behaviors ?
• List of Behaviors (keep this list in alphabetic order):
  
  
  • Acl - Using AclBehavior in CakePHP 1.2
  • Bindable - Control your model bindings by limiting the returned models on find operations and change model binding settings on the fly.
  • Containable - Specifying what assocs to return
  • counterCache or counter_cache - http://bin.cakephp.org/saved/2247[better] - counterCache or counter_cache Behavior [original] - To update (increase/decrease) the count of children in parent table whenever the child table changes. Also, check bododo's comments
    counterCache - CounterCache in CakePHP 1.2 beta - Native support
  • Geocoded - Geocoding in CakePHP
  • List - This behavior allows for easy creation of list structures in your CakePHP application.
  • Sluggable - Sluggable Behavior - To have search engine friendly URI (small title in URI instead of id as in Digg.com)
  • SoftDeletable - SoftDeletable Behavior - automatically soft delete records for certain models, letting them be undeletable.
  • Translate - See below under "How to add i18n support?"
  • TranslateIt - TranslateItBehavior - extends TranslateBehavior
  • MyTranslate - source - discussion
  • Tree - Tree Behavior :: Basic Usage :: Using cakephp 1.2.x.x_06.12.2007Hierarchical data database (Note: Not an ideal solution for some cases)
  • Upload - Generic Upload Behavior article . source and sample application with image manipulation (thumbs, dynamic resize of images). Previous Version
    
  • Version - Version Behavior - Presentation [pdf]. source [svn] - To have easy versioning of model changes to provide history of changes
    Related:
    • WhoDunnitBehavior
    • History Tracking
    • AuditBehavior
• More Behaviors: Bakery: Articles in Behavior Category or Bakery: Articles tagged with behavior

How to add i18n support?

• p28n, the top to bottom persistent internationalization tutorial
• How do I use i18n and l10n in CakePHP 1.2?
• Trouble with the translate function "__()"
• i18n: static language references with __("My lang key", true) in models and controllersHack by fixing core, Hack without fixing core (better, if you want to extract translate strings)

Translate behavior also could be used for multi-language support.

• Translate.php
• Translate behavior usage example[zip] - by poLK (Doesn't seem to be complete, throwing couple of errors. Seems the DB structure is incomplete)
• i18n translation in db tables - how to do this like Symfony?
• i18n translation in db tables - how to do this like Symfony?
• TranslateItBehaviour - TranslateItBehavior - extends TranslateBehavior
• MyTranslateBehaviour - source - discussion
  

How to use ACL/Auth? How to handle authorization/authentication?

• Native
  • AclBehavior
    • Using AclBehavior in CakePHP 1.2
  • AuthComponent
    • [new]TUTORIAL: Auth component (Cake 1.2), Set authorization according to role
    • Setting Up User Groups With ACL/Auth in CakePHP 1.2
    • Using AuthComponent and ACL in CakePHP 1.2
    • How to use ACL in 1.2.x
    • Auth component + Cake 1.2
    • Good info on using Auth component.
• Others
  • othAuth
    • Configuring the othAuth Component for Cake 1.2 pre-Beta
  • Authake
    
  • User & group management, registration, authentication, and regex ACL (Cake 1.2)
    

How to use Cake Test suite? / How to use Unit test?

• CakePHP Unit Testing - Presentation [pdf]
• Testing Models with CakePHP 1.2 test suite

How to create external/shell script? / How to create script for Cron?

• External tasks in CakePHP

How to define model associations?

• Ruby on Rails Data Model Relationships Diagram
• Cake Stencil (cheat sheet)[zip]
• Understanding CakePHP Associations
• dbdesigner2cake
• Cake 1.2 Pre-Beta Self-Referential Model Problem? - Though posted for problem, it has clear model definition for self-referential category model (divided into Parent Category and Child Category depending upon the parent_id in categories table)
• findall on 3 models chained with belongsto

How to reduce the number of automagic queries? How to use finderQuery? (Improve query performance)

• How to use the 'finderQuery' attribute of your model definitions

How to add paginate support for custom queries?

• Cake php 1.2 pagination with custom query
• Filter items by category
• Pagination with complex query (again)

How to retain search param in paging?

• [new]Pagination with Filter/Search Box
• how to pass criteria to pagination object?
• 1.2 Pagination forgetting conditions?
• Keep current url params with paginator links
  

How to access component in view?

• Can i get $webroot for a vendor library? - Note that it's a hack
  

How to use more than one DB connections (master/slave)?

• Replication load balancing support?
• Multiple Databases

How to use Set::extract() and what is this "{n}.Model.field" notation?

• Cake 1.2’s Set class eats nested arrays for breakfast!
• Can someone please explain to me what {n} is?
  

When will CakePHP become PHP5/6 only?

• In version 2.0: https://trac.cakephp.org/milestone/2.0.0.x

Why do I get a blank page?

• Empty/blank page response

How scalable is CakePHP?

• Who Is Responsible For Scaling?
  

What is a good Editor/IDE to use for CakePHP?

• Search: What editor do you use for CakePHP

Number displayed under flash messages

• Don't use echo - Tarique

Editor's Pick:

• CakePHP for Railers
• Associations without foreignKey?
• SOLVED: Cake with Sub Domains on Dreamhost
• Is it possible to use components in helper?
• Techniques for implementing multiple UIs (ie HTML, Ajax, Flash) for the same actions.
• Including php file with normal variables.
• One Install, Multiple Apps
• Individual Radio Buttons In 1.2
• Custom fields using Controller-\\46gt;paginate() in 1.2
• CakePHP SMF integration
• updated breadcrumb example?
• Cake 1.2 FormHelper Examples
• Organizing your code with folders
• New router goodies - Reverse routing

Interesting projects/source code

• AydCodegen - a visual tool for mvc baking - Web-based baking tool
• dbdesigner2cake
• svn source for bakery
• Drag and drop using Ext JS with the CakePHP Tree Behavior
• Great Commission LMS - with install scripts
• quarkcms source (Note, some parts are outdated with recent CakePHP version)
• Bakesale

History (Reverse chronological)

Until GG provide diff, please add some note about your version

• Pagination with Filter/Search Box, Version behavior related stuffs, action-based validation, CakePHP super feed, bakesale, dbdesigner2cake
• Grammar and other cleanup by previous editors
• Added note to copy and paste link for generating cookbook live pdf as the site blocks remote linking
• Reverse routing, quarkcms source
• External/shell script (say for cron)
• Security note on find(), __() usage on model (better hack), Version behavior, unit test presentation, other CakeFest presentations, web-based baking tool, Hierarchical data database link for TreeBehavior
• After huge struggle removed spam
• Samuel's saved PDF Cookbook
• On the fly PDF version for Cookbook
• Removed the deleted all in one cookbook zip, link for behavior, cakestencil and Ajax redirection question
• Security notes, link to all in one page cookbook zip, One-to-many and one-to-one discussion, core hacks
• Adding "what is this "{n}.Model.field" notation?"
• Adding Authake in ACL/Others section
• Cleaned up todos, removed old new markers, added Interesting projects/source codes, cookbook link
• Snippets for MediaView
• New stuffs to be added under todo in Editors' Pick
• Added Tree Behavior :: Basic Usage
• Included titles for Editor's Pick URL
• Self-referential model example, self HABTM discussions, othAuth fix for Cake 1.2 pre-Beta
• Added Snook Elemental Content
• One more link for Multiple database
• Minor re-ordering. More highlight to the new CakePHP 1.2 (temp) docs
• New link/note on __()
• More HABTM links
• Moved some of editors pick to proper sections, reordered sections, moved topics that need contributions/solutions to the top, added notice
• New editor pick links
• Updated to newer Upload behavior
• Link to OCPHP presentation
• ACL/Auth link to Brian Dailey's
• Updated to better Upload behavior link
• Set to Tarique's version (higher)