【CakePHP1.3 】Controller的方法
Controller的方法
尽管本小节会介绍Cake模型中大多数频繁使用的方法，但也请记住 http://api.cake.org 可以获得完整的API参考。
与你的view进行交互
set
string $var
mixed $value
这个方法是你的view从controller得到数据的主要方法。你可以用它传递任何数据：单一变量值，整个数组，等等。一但调用了set()，相应的变量就可以在view里访问到了：在controller里调用set(‘color’, ‘blue’)使得变量$color在view里变得可用了。
validateErrors
返回在一次不成功的保存中生成的错误个数。
validate
根据一个model预定义的有效性规则验证该model的数据。关于数据验证的的更多内容，请参见第11章。
render
string $action
string $layout
string $file
你也许不会经常使用这个方法，因为render方法是在controller action结束时自动被调用的，输出按action名字命令的view。同时，你也可以在controller逻辑里的任意位置调用来这个方法输出视图。
用户重定向
redirect
string $url
通过此方法告诉你的用户应该继续访问什么地方。这里传入的URL参数可以是一个Cake内部URL，也可以是一个完整的URL（http://...）。
flash
string $message
string $url
int $pause
该方法将在你的flash页面（该页面位于app/views/layouts/flash.thtml）上显示提示信息[$message]，停顿时间若干[$pause]秒，然后重定向用户到指定的Url[$url]。 Cake的redirect()和flash()方法并不包含exit()的调用。如果你希望自己的应用程序在redirect()或flash()之后停止继续执行，你需要自己在这些方法之后立即调用exit()。你也可能想要return()而不是exit()，依你的具体情况而定（例如，你需要执行某些回调）。
controller中的回调函数
Cake的controller特别提供了许多回调方法，你可以用它们在一些重要的controller方法之前或者之后插入一些逻辑。如果要利用这些功能，请在你的controller中用这里描述的参数和返回值定义这些方法。
beforeFilter
在每个controller action调用前执行。它是一个检查当前sessoin状态和检查用户角色的好地方。
afterFilter
在每个controller action调用后执行。
beforeRender
在controller逻辑之后，并且在输出视图之前被调用。
其他有用的方法
尽管这些方法是Cake的Object类的一部分，他们在controller里仍然可用。
requestAction
string $url
array $options
这个方法可以在任意位置调用某个controller的action并且返回render后的视图。$url是一个Cake URL（/controllername/actionname/params）。如果$extra（译注：该方法里并没有出现$extra参数，这里是不是应该为$options?）数组包含’return’，这个action的AutoRender将会自动被设置为true。 你可以用requestAction从另一个controller action获取数据，也可以从另一个controller获取整个输出后的视图。
首先，从一个controller获取数据是很简单的。你只需在需要数据的地方使用requestAction方法。
// Here is our simple controller:
class UsersController extends AppController
{
function getUserList()
{
$this->User->findAll();
}
} 设想我们需要创建一个简单的表格来显示系统里的用户。我们不用在另一个controller里重复编码，而只需要用requestAction()来调用UsersController::getUserList()就能得到用户数据。
class ProductsController extends AppController
{
function showUserProducts()
{
$this->set('users', $this->requestAction('/users/getUserList'));
// Now the $users variable in the view will have the data from
// UsersController::getUserList().
}
}
如果在你的程序里，有一个频繁使用而又非静态的html元素（element），你也许会想使用requestAction()来将它插入到任意view里边。实际上我们不只是想要从UsersController::getUserList获取数据，还想要在另一个controller里边render这个action的view（这个view也许已包含了表格）。这样的方式可以避免重复编写view的代码。
class ProgramsController extends AppController
{
function viewAll()
{
$this->set('userTable', $this->requestAction('/users/getUserList', array('return')));
// Now, we can echo out $userTable in this action's view to
// see the rendered view that is also available at /users/getUserList.
}
}
请注意这里用requestAction()调用的action用的是一个空的布局（layout）－这样的话你就不必担心布局与布局之间嵌套带来的麻烦了。
在使用AJAX的情况下，当在一个AJAX调用之前或调用中间想从一个view生成一个html元素，requestAction()方法也是很有用的。
log
string $message
int $type = LOG_ERROR
你可以使用这个方法来记录web应用程序里发生的不同事件。所有生成的log可以在Cake的/tmp目录下找到。
如果$type的值为PHP常量LOG_DEBUG，消息将作为debug信息被写入log。对于其他任何值，消息作为error信息被写入log。
// Inside a controller, you can use log() to write entries:
$this->log('Mayday! Mayday!');
//Log entry: 06-03-28 08:06:22 Error: Mayday! Mayday!
$this->log("Look like {$_SESSION['user']} just logged in.", LOG_DEBUG);
//Log entry: 06-03-28 08:06:22 Debug: Looks like Bobby just logged in.
postConditions
array $data
一个你可以用其将传入的$this->data格式化成model条件数组（conditions array）的方法。
例如，你有一个人员搜索表单：
// app/views/people/search.thtml:
提交包含这个元素的表单将会产生以下$this->data数组：
Array
(
[Person] => Array
(
[last_name] => Anderson
)
)
在这里，我们就可以用postConditions()来格式化这些数据以便于在model里使用：
// app/controllers/people_controller.php:
$conditions = $this->postConditions($this->data);
// Yields an array looking like this:
Array
(
[Person.last_name] => Anderson
)
// Which can be used in model find operations:
$this->Person->findAll($conditions);