This document is for a version of CakePHP that is no longer supported. Please upgrade to a newer release!
Contents¶
Preface
- CakePHP at a Glance
- Quick Start Guide
- 3.x Migration Guide
- 3.10 Migration Guide
- 3.9 Migration Guide
- 3.8 Migration Guide
- 3.7 Migration Guide
- 3.6 Migration Guide
- 3.5 Migration Guide
- 3.4 Migration Guide
- 3.3 Migration Guide
- 3.2 Migration Guide
- 3.1 Migration Guide
- 3.0 Migration Guide
- 3.0 Migration Guide
- Requirements
- Upgrade Tool
- Application Directory Layout
- CakePHP should be installed with Composer
- Namespaces
- Removed Constants
- Configuration
- New ORM
- Basics
- Debugging
- Object settings/configuration
- Cache
- Core
- Console
- Shell / Task
- Event
- Log
- Routing
- Network
- Sessions
- Network\Http
- Network\Email
- Controller
- Controller\Components
- Model
- TestSuite
- View
- View\Helper
- I18n
- L10n
- Testing
- Utility
- New ORM Upgrade Guide
- 3.0 Migration Guide
- Tutorials & Examples
- Contributing
- Documentation
- Tickets
- Code
- Coding Standards
- Backwards Compatibility Guide
Getting Started
- Installation
- Configuration
- Configuring your Application
- Environment Variables
- Additional Class Paths
- Inflection Configuration
- Configure Class
- Reading and writing configuration files
- Bootstrapping CakePHP
- Disabling Generic Tables
- Application
- Routing
Router- Quick Tour
- Connecting Routes
- Route Elements
- Reserved Route Elements
- Configuring Route Options
- Passing Parameters to Action
- Using Named Routes
- Prefix Routing
- Creating Links to Prefix Routes
- Plugin Routing
- Creating Links to Plugin Routes
- SEO-Friendly Routing
- Matching Specific HTTP Methods
- Matching Specific Hostnames
- Routing File Extensions
- Connecting Scoped Middleware
- RESTful Routing
- Passed Arguments
- Generating URLs
- Redirect Routing
- Entity Routing
- Custom Route Classes
- Creating Persistent URL Parameters
- Handling Named Parameters in URLs
- Request & Response Objects
- Request
ServerRequest- Request Parameters
- Query String Parameters
- Request Body Data
- File Uploads
- PUT, PATCH or DELETE Data
- Environment Variables (from $_SERVER and $_ENV)
- XML or JSON Data
- Path Information
- Checking Request Conditions
- Session Data
- Host and Domain Name
- Reading the HTTP Method
- Restricting Which HTTP method an Action Accepts
- Reading HTTP Headers
- Trusting Proxy Headers
- Checking Accept Headers
- Cookies
- Response
- Setting Cookies
- Setting Cross Origin Request Headers (CORS)
- Common Mistakes with Immutable Responses
- Cookie Collections
- Request
- Middleware
- Controllers
Controller- The App Controller
- Request Flow
- Controller Actions
- Interacting with Views
- Redirecting to Other Pages
- Loading Additional Models
- Paginating a Model
- Configuring Components to Load
- Configuring Helpers to Load
- Request Life-cycle Callbacks
- More on Controllers
- The Pages Controller
- Components
- AuthComponent
AuthComponent- Suggested Reading Before Continuing
- Authentication
- Choosing an Authentication Type
- Configuring Authentication Handlers
- Customizing Find Query
- Identifying Users and Logging Them In
- Redirecting Users After Login
- Creating Stateless Authentication Systems
- Using Basic Authentication
- Using Digest Authentication
- Creating Custom Authentication Objects
- Using Custom Authentication Objects
- Handling Unauthenticated Requests
- Displaying Auth Related Flash Messages
- Hashing Passwords
- Creating Custom Password Hasher Classes
- Changing Hashing Algorithms
- Manually Logging Users In
- Accessing the Logged In User
- Logging Users Out
- Deciding When to run Authentication
- Authorization
- Configuration options
- Testing Actions Protected By AuthComponent
- Cookie
- Cross Site Request Forgery
- Flash
- Security
- Pagination
- Request Handling
- Configuring Components
- Using Components
- Creating a Component
- Component Callbacks
- AuthComponent
- Views
View- The App View
- View Templates
- Using View Blocks
- Layouts
- Elements
- View Events
- Creating Your Own View Classes
- More About Views
- View Cells
- Themes
- JSON and XML views
- Helpers
- Breadcrumbs
- Flash
- Form
FormHelper- Starting a Form
- Creating Form Controls
- Generating Specific Types of Controls
- Creating Input Elements
- Creating Text Inputs
- Creating Password Inputs
- Creating Hidden Inputs
- Creating Textareas
- Creating Select, Checkbox and Radio Controls
- Creating File Inputs
- Creating Date & Time Related Controls
- Common Options for Date & Time Controls
- Options for Date-Related Controls
- Options for Time-Related Controls
- Creating DateTime Controls
- Creating Date Controls
- Creating Time Controls
- Creating Year Controls
- Creating Month Controls
- Creating Day Controls
- Creating Hour Controls
- Creating Minute Controls
- Creating Meridian Controls
- Creating Labels
- Displaying and Checking Errors
- Creating Buttons and Submit Elements
- Closing the Form
- Creating Standalone Buttons and POST Links
- Customizing the Templates FormHelper Uses
- Generating Entire Forms
- Creating Inputs for Associated Data
- Adding Custom Widgets
- Working with SecurityComponent
- Html
HtmlHelper- Inserting Well-Formatted Elements
- Creating Charset Tags
- Linking to CSS Files
- Creating CSS Programatically
- Creating meta Tags
- Creating DOCTYPE
- Linking to Images
- Creating Links
- Linking to Videos and Audio Files
- Linking to Javascript Files
- Creating Inline Javascript Blocks
- Creating Nested Lists
- Creating Table Headings
- Creating Table Cells
- Changing the Tags Output by HtmlHelper
- Creating Breadcrumb Trails with HtmlHelper
- Number
- Paginator
PaginatorHelper- PaginatorHelper Templates
- Creating Sort Links
- Creating Page Number Links
- Creating Jump Links
- Creating Header Link Tags
- Checking the Pagination State
- Creating a Page Counter
- Generating Pagination URLs
- Creating a Limit Selectbox Control
- Configuring Pagination Options
- Example Usage
- Paginating Multiple Results
- Rss
- Session
- Text
- Time
- Url
- Configuring Helpers
- Using Helpers
- Callback Methods
- Creating Helpers
- Helper Class
- Database Access & ORM
- Quick Example
- More Information
- Database Basics
- Query Builder
- Table Objects
- Basic Usage
- Lifecycle Callbacks
- Behaviors
- Configuring Connections
- Using the TableLocator
- Entities
- Retrieving Data & Results Sets
Table- Debugging Queries and ResultSets
- Getting a Single Entity by Primary Key
- Using Finders to Load Data
- Getting the First Result
- Getting a Count of Results
- Finding Key/Value Pairs
- Finding Threaded Data
- Custom Finder Methods
- Dynamic Finders
- Retrieving Associated Data
- Eager Loading Associations Via Contain
- Filtering by Associated Data Via Matching And Joins
- Changing Fetching Strategies
- Lazy Loading Associations
- Working with Result Sets
- Modifying Results with Map/Reduce
- Validating Data
- Saving Data
- A Glance Over Saving Data
- Converting Request Data into Entities
- Saving Entities
- Strict Saving
- Find or Create an Entity
- Saving Multiple Entities
- Bulk Updates
- Deleting Data
- Associations - Linking Tables Together
- Behaviors
- Using Behaviors
- Core Behaviors
- Creating a Behavior
- Transforming Request Data into Entity Properties
- Removing Loaded Behaviors
- Accessing Loaded Behaviors
- Schema System
- Schema Cache Shell
Using CakePHP
- Caching
- Console Tools, Shells & Tasks
- The CakePHP Console
- Console Applications
- Renaming Commands
- Commands
- CakePHP Provided Commands
- Cache Shell
- I18N Shell
- Completion Shell
- Plugin Shell
- Routes Shell
- Schema Cache Shell
- Server Shell
- Upgrade Shell
- Shells
- Interactive Console (REPL)
- Routing in the Console Environment
- Debugging
- Deployment
- Error & Exception Handling
- Error & Exception Configuration
- Changing Exception Handling
- Customize Error Templates
- Customize the ErrorController
- Change the ExceptionRenderer
- Creating your Own Error Handler
- Creating your own Application Exceptions
- Built in Exceptions for CakePHP
- HTTP Exceptions
- Using HTTP Exceptions in your Controllers
- Other Built In Exceptions
MissingViewExceptionMissingTemplateExceptionMissingLayoutExceptionMissingHelperExceptionMissingElementExceptionMissingCellExceptionMissingCellViewExceptionMissingComponentExceptionMissingActionExceptionPrivateActionExceptionConsoleExceptionMissingTaskExceptionMissingShellExceptionMissingShellMethodExceptionMissingConnectionExceptionMissingDriverExceptionMissingExtensionExceptionMissingTableExceptionMissingEntityExceptionMissingBehaviorExceptionPersistenceFailedExceptionRecordNotFoundExceptionMissingControllerExceptionMissingRouteExceptionMissingDispatcherFilterExceptionException
- Events System
- Internationalization & Localization
- Logging
- Modelless Forms
- Pagination
- Plugins
- Installing a Plugin With Composer
- Manually Installing a Plugin
- Loading a Plugin
- Plugin Hook Configuration
- Using Plugin Classes
- Creating Your Own Plugins
- Plugin Objects
- Plugin Routes
- Plugin Controllers
- Plugin Models
- Plugin Templates
- Plugin Assets
- Components, Helpers and Behaviors
- Commands
- Testing your Plugin
- Publishing your Plugin
- Plugin Map File
- Manage Your Plugins using Mixer
- REST
- Security
- Sessions
- Testing
- Installing PHPUnit
- Test Database Setup
- Checking the Test Setup
- Test Case Conventions
- Creating Your First Test Case
- Running Tests
- Test Case Lifecycle Callbacks
- Fixtures
- Testing Table Classes
- Controller Integration Testing
- Setting up the Request
- Testing Actions That Require Authentication
- Testing Stateless Authentication and APIs
- Testing Actions Protected by CsrfComponent or SecurityComponent
- Integration Testing PSR-7 Middleware
- Testing with Encrypted Cookies
- Testing Flash Messages
- Testing a JSON Responding Controller
- Disabling Error Handling Middleware in Tests
- Assertion methods
- Comparing test results to a file
- Console Integration Testing
- Testing Views
- Testing Components
- Testing Helpers
- Testing Events
- Testing Email
- Creating Test Suites
- Creating Tests for Plugins
- Generating Tests with Bake
- Integration with Jenkins
- Validation
Utility Classes
- App Class
- Collections
Collection- Quick Example
- List of Methods
- Iterating
- Filtering
- Aggregation
- Sorting
- Working with Tree Data
- Other Methods
- Folder & File
- Basic Usage
- Folder API
FolderFolder::$pathFolder::$sortFolder::$modeFolder::addPathElementFolder::cd()Folder::chmod()Folder::copy()Folder::correctSlashForFolder::create()Folder::delete()Folder::dirsize()Folder::errors()Folder::find()Folder::findRecursive()Folder::inCakePath()Folder::inPath()Folder::isAbsoluteFolder::isSlashTermFolder::isWindowsPathFolder::messages()Folder::move()Folder::normalizeFullPathFolder::pwd()Folder::read()Folder::realpath()Folder::slashTermFolder::tree()
- File API
FileFile::$FolderFile::$nameFile::$infoFile::$handleFile::$lockFile::$pathFile::append()File::close()File::copy()File::create()File::delete()File::executable()File::exists()File::ext()File::Folder()File::group()File::info()File::lastAccess()File::lastChange()File::md5()File::name()File::offset()File::open()File::owner()File::perms()File::prepareFile::pwd()File::read()File::readable()File::safe()File::size()File::writable()File::write()File::mime()File::replaceText()
- Hash
Hash- Hash Path Syntax
- Expression Types
- Attribute Matching Types
Hash::getHash::extractHash::insertHash::removeHash::combineHash::formatHash::containsHash::checkHash::filterHash::flattenHash::expandHash::mergeHash::numericHash::dimensionsHash::maxDimensionsHash::mapHash::reduceHash::applyHash::sortHash::diffHash::mergeDiffHash::normalizeHash::nest
- Http Client
- Inflector
- Number
- Registry Objects
- Text
- Date & Time
- Xml
Plugins
Other
- Constants & Functions
- Appendices
- 3.x Migration Guide
- 3.x Migration Guide
- 3.10 Migration Guide
- 3.9 Migration Guide
- 3.8 Migration Guide
- 3.7 Migration Guide
- 3.6 Migration Guide
- 3.5 Migration Guide
- 3.4 Migration Guide
- 3.3 Migration Guide
- 3.2 Migration Guide
- 3.1 Migration Guide
- 3.0 Migration Guide
- 3.0 Migration Guide
- Requirements
- Upgrade Tool
- Application Directory Layout
- CakePHP should be installed with Composer
- Namespaces
- Removed Constants
- Configuration
- New ORM
- Basics
- Debugging
- Object settings/configuration
- Cache
- Core
- Console
- Shell / Task
- Event
- Log
- Routing
- Network
- Sessions
- Network\Http
- Network\Email
- Controller
- Controller\Components
- Model
- TestSuite
- View
- View\Helper
- I18n
- L10n
- Testing
- Utility
- New ORM Upgrade Guide
- 3.0 Migration Guide
- 3.x Migration Guide
- Forwards Compatibility Shimming
- General Information
- 3.x Migration Guide
Phinx