一个好老好老的老程序员了。
全部博文（915）
分类： Python/Ruby
2011-08-12 14:56:13
注意：如果默认主页看上去更像图 2，则说明 mod_rewrite 并没有按照 CakePHP 所需的方式运行。第一次使用 CakePHP 的用户有时可能会遇到这个问题。
以下是一些需要确认的东西。
.htaccess 文件应当已出现在 CakePHP 安装目录中。在大多数 *nix 系统中，此文件都是默认隐藏的。如果没有该文件，请检查下载的源文件或从 CakePHP.org 获得最新更新。通过访问安装目录并运行 cat .htaccess，确认该文件是否存在且有效。这将显示该文件的内容，其内容应当类似于清单 6。
|
|
确保为 Web 服务器启用 mod_rewrite。对于 Apache，httpd.conf 文件中应当会出现两个不同的行。在 LoadModule 列表中，您应当会看到下面一行（或极为类似）：LoadModule rewrite_module libexec/mod_rewrite.so。在 AddModule 列表中，您应当会看到这一行（或极为类似）：AddModule mod_rewrite.c。
如果您在 httpd.conf 文件中找不到这两行，则 mod_rewrite 未启用。请查阅服务器文档以获得如何解决此问题的详细信息。
确保将 Web 服务器配置为允许 .htaccess 覆盖。对于 Apache，每个目录都应在 httpd.conf 文件中定义。这些定义可能因为安装的不同看上去有所不同，但应当仍会在定义中看到 AllowOverride All 一行。定义可能类似于清单 7。
|
|
有关 .htaccess 覆盖的更多信息，请参阅服务器文档。
既然已经安装了 CakePHP，并已与 Web 服务器关联了起来，就需要把 CakePHP 引入数据库。本节介绍如何设置数据库配置和检验 CakePHP 是否接受这个数据库。Tor 需要一个位置来保存其用户和产品数据。然后要创建一个 users 表，该表用于构建 Tor 的登录和注册部分。
设置数据库配置十分简单，但在开始之前，要确保数据库服务器处于运行状态，确保已经为应用程序创建了数据库，并确保拥有一个用户的用户名和密码（这个用户具有对数据库进行操作的权限）。
首先，复制 app/config/database.php.default 文件并将其保存为 app/config/database.php。这样做是为了保留一个原始模板的拷贝。在您喜欢的文本编辑器中打开该文件并查找以下部分（它应当非常接近该文件的底部），如清单 8 所示。
| var $default = array( 'driver' => 'mysql', 'persistent' => false, 'host' => 'localhost', 'login' => 'user', 'password' => 'password', 'database' => 'database_name', 'prefix' => '' ); |
根据自己的情况修改以下信息：
driver 此字段可以是 mysql、mysqli、postgres、sqlite、mssql、db2, oracle、adodb 或 pear-drivername。本教程假定它是 mysql。 persistent 此字段告诉 CakePHP 是否应当使用持久的数据库连接。有效值是 true 或 false。本教程假定它是 false。 host 这是数据库服务器的主机名，比如 localhost 或 mysql.yourdomain。 login 这是用于数据库登录的用户名，比如 dbuser。 password 这是用于数据库登录的密码，比如 secretsecret。 database 这是希望使用的数据库的名称，比如 cakedev。 prefix 前缀是一个字符串，比如 cp_，它是 CakePHP 执行的任何数据库调用的表名前缀。如果数据库由多个应用程序共享，而又要保证在两个或多个应用程序需要使用具有相同名称的表时（比如 users）表不会相互覆盖，那么就有必要使用前缀。请不要忘记保存文件。
可以在 database.php 中指定任意数目的数据库配置，只要这些数据库配置具有不同的名称。可以指定应用程序应当在模型中使用哪个数据库配置。
关于数据库和 CakePHP 的一些注意事项：
返回到用于检验初始安装的 URL。应当会看到 CakePHP 默认主页已经改为显示数据库配置的状态（见图 3）。
如果默认主页指出数据库配置文件不存在，则您可能将其放在了错误的位置或者其名称不正确。确保数据库配置文件为 app/config/database.php。如果默认主页指出 CakePHP 无法连接数据库，那么确认输入的连接信息是否有效，然后重试。
现在，CakePHP、Web 服务器和数据库都关联到一起了。开始动手实践吧！Tor 需要一个 users 表。
这个表将包含识别用户和与用户交互所需的基本信息。简单的用户名和密码字段可能就够了，但其他信息也可能有用，例如电子邮件地址（用于发送密码重置请求）、名字和姓氏（用于个性化服务）以及最后一次登录的日期（用于帮助跟踪不活动的帐户）。您可能希望用户名和电子邮件字段是唯一的。另外，不要忘记主键 ID 字段。创建表的 SQL 可能类似于清单 9。
| CREATE TABLE 'users' ( 'id' INT( 10 ) NOT NULL AUTO_INCREMENT PRIMARY KEY , 'username' VARCHAR( 40 ) NOT NULL , 'password' VARCHAR( 40 ) NOT NULL , 'email' VARCHAR( 255 ) NOT NULL , 'first_name' VARCHAR( 40 ) NOT NULL , 'last_name' VARCHAR( 40 ) NOT NULL , UNIQUE ( 'username' ,, 'email' ) ) ENGINE= MYISAM ; |
注意，username、password、first_name 和 last_name 字段最多包含 40 个字符。在 user 模型中将强制要求不超过这个字符长度。在本例中，40 个字符的最大长度完全是任意设定的。
MVC 设计
通常，在这个阶段会根据应用程序所需的功能着手编写代码。一个登录页面、一个数据库、注册表单 —— 搞定！多么简单！通常也就是这么简单。除非您希望更改外观、改变与数据库交互的方法、更改检验规则或在根本上更改应用程序的某些重要方面时，事情才会开始变得复杂起来。
CakePHP 的设计目的是尽可能轻松地编写应用程序，同时提供可以长期维护的应用程序。本教程将告诉您怎样使用 MVC 设计模式构建 Tor。CakePHP 将向您展示这个过程会是多么轻松。您自己会体会到使用 CakePHP 的意义。
MVC 设计模式将应用程序分为三个不同的层，分别是数据处理、UI 和逻辑。Design Patterns: Elements of Reusable Object-Oriented Software 一书（也称为 “Gang Of Four”）首次介绍了 MVC。全面讨论设计模式和 MVC 超出了本教程的范围，但它对了解这三个部分的含义是很有帮助的 —— 尤其是在 CakePHP 领域中。
用户、产品、价格、消息 —— 从本质上看，它们都仅仅是数据。确保数据是您所需要的，让数据进入数据库，然后再从数据库中取出数据。很有必要将 Tor 的所有数据处理功能都放在一个位置。这就是模型的作用。
模型主要考虑的是处理数据。从数据库中获取数据、将数据插入数据库、检验数据 —— 所有这些操作都是在模型内进行的。
一个单独的模型通常用于访问数据库中特定的表。通常，如果表名是模型名称的复数形式，则模型将与这个数据库表相关联。例如，product 模型在默认情况下将与 products 表相关联。用户定义的所有模型都将扩展 CakePHP AppModel 类。
在为 Tor 创建了 users 表后，需要一个 user 模型与该表进行交互。user 模型将保存用户数据，替您从表中取回数据，并检验用户数据是否是可接受的格式。目前，这个模型可以是一个存根。它应当作为 app/models/user.php 创建，内容可能类似于清单 10。
请注意 var $name = 'User'; 行。在 $name 中指定模型的名称是公认的最佳实践。
如果不能显示数据，那么保存、获取和检验数据就没多大用处。通过将所有显示和表示代码放在同一个位置，可以方便地更改应用程序的外观和感觉，而无需修改与应用程序逻辑和数据相关的代码。
视图主要考虑的是格式化显示给用户的数据。视图用于表示所有 UI 结果，包括所有模板和 HTML。CakePHP 的视图文件是嵌入了 PHP 代码的常规 HTML 文件。
最后，视图就是一个页面模板。通常，视图都根据与之相关联的操作来命名。例如，display() 操作通常会有一个 display 视图。
返回到示例应用程序，我们已经创建一个 users 表和与此表进行交互的 user 模型。现在我们需要一些视图。用户需要注册帐户并登录到应用程序中。这将需要 register 视图和 login 视图。
用户需要先注册一个帐户，然后才能使用 Tor 应用程序。这将需要一个 register 视图，这个视图将向用户显示注册表单。您应当已经知道 Tor 需要哪些用户数据了。具体地说，需要收集用户名、密码、电子邮件地址、名字和姓氏。
register 视图应当被创建为 app/views/users/register.ctp，内容可能类似于清单 11。
切记，字段名要与数据库中的列名相同，遵循此原则在处理 users 控制器时会有用。在后面讨论 Cake 的更多信息和 Cake helper 的工作原理时，将完全重写这个页面，但是这个页面目前仅仅是常规的 HTML。
现在，数据处理全都包含在模型内，表示层全都包含在视图内，应用程序的其余部分将全都包含在控制器中。在控制器中，执行逻辑、决策、工作流及应用程序所涉及的其他操作。模型管理数据，视图显示数据，控制器执行其他所有操作。
控制器管理服务器请求。它接受用户输入（URL 请求、表单 POST、GET 请求等等），在必要时应用逻辑，在需要数据处理时调用模型，并通过适当的视图发送输出。
通常，一个控制器将管理一个模型的逻辑。控制器包含任意数目的函数（也称为操作）。在典型情况下，操作会应用逻辑并显示视图。用户定义的所有控制器都需要扩展 CakePHP AppController 类。
在 Tor 中，已创建了一个 users 表、一个与该表进行交互的 user 模型以及向用户显示注册表单和登录表单的视图。这些表单将提交到 users 控制器，分别调用 register 和 login 操作。users 控制器应当创建为 app/controllers/users_controller.php，最初的内容应当类似于清单 12。
现在已经有了一个控制器。但它还不做任何事情。在让它为您服务之前，必须先给它定义一些要执行的操作。
现在将深入探讨具体细节。用户已经填好了表单并将其提交给应用程序。稍后将介绍数据检验。现在，我们只将数据交给数据库，这需要将 register 操作添加到 users 控制器中（见清单 13）。
| params['form'])) { if ($this->User->save($this->params['form'])) { $this->flash('Your registration information was accepted.', '/users/register'); } else { $this->flash('There was a problem with your registration', '/users/register'); } } } } ?> |
register 操作先查看表单 ($this->params['form'])，检查它是否已提交。如果表单尚未提交，则不进行任何处理。当知道表单提交了数据之后，控制器将对 user 模型调用 save 方法（该模型是 AppModel 的扩展）。在默认情况下，save 方法将查找表名是模型名的复数的表。在这个示例中，它将查找与 user 模型相对应的 users 表。如果找到该表，则 save 方法将把传递的数组 ($this->params['form']) 转换为一个 INSERT 语句，这个语句使用数组键作为列名，使用数组值作为 INSERT 值。
带数据的表单被提交之后，控制器将调用 user 模型上的 save 方法，该方法是 AppModel 的扩展。默认情况下，save 方法将查找模型复数的表。在这里，它将查找与 user 模型对应的 users 表。如果找到该表，save 将把传递的 ($this->params['form']) 数组转换为 INSERT 语句，其中使用数组键作为列名，使用数组值作为 INSERT 值。在这里，$this->params['form'] 将类似于清单 14。
| Array ( [username] => zaphod [password] => secret [email] => beeblebrox@heartofgold.hhg [first_name] => zaphod [last_name] => beeblebrox ) |
save 方法将根据其余部分构建一个 INSERT 语句。这个语句将类似于清单 15。
| INSERT INTO users (username, password, email, first_name, last_name) VALUES ('zaphod', 'secret', 'beeblebrox@heartofgold.hhg', 'zaphod', 'beeblebrox') |
为什么要在 register 视图中使用数据库列名作为注册表单字段名，原因现在就很明显了。通过这样做，显著地简化了保存数据的过程。
接下来，如果数据成功地插入了，则 register 操作将调用 Flash 方法。Flash 向用户显示一条基本消息（在本例中，为一条成功或失败消息）和一个离开此消息的链接（在本例中，返回到 register 视图，因为尚未定义任何其他内容）。
现在已经有了一个与 users 表进行交互的 user 模型，一个用于显示注册表单的 register 视图，以及配有 register 操作的 users 控制器，可以实际看看应用程序的运行情况了。
所有组件都已整合到了一起。该让 Tor 活动起来了。打开浏览器。访问 装载 register 视图。您将看到类似图 4 的内容。
填写并提交表单。应当会看到成功消息（见图 5）。
如果查看数据库，应当会看到一条与表单提交相对应的记录，此过程使用明文密码（非常糟糕的做法，稍后解决这个问题）。尝试使用相同的信息重新填写表单。应当会看到失败消息（见图 6）。
如果使用的是支持 UNIQUE 字段约束的数据库，则注册将失败。在创建 users 表的过程中，用户名和电子邮件字段被定义为 UNIQUE ，这意味着这些字段的值不能重复。当数据库抛出这个错误时，CakePHP 会识别出该错误并显示错误。
helper
CakePHP 中的 helper 主要用于帮助提高视图的开发速度。HTML、Ajax、JavaScript 等等都有 helper。通过使用 helper，可以更轻松地插入要多次编写的 HTML 代码片段。
为了使用 helper，需要修改前面创建的 users_controller.php 文件。应该给控制器命名，并告诉它希望使用一些 helper（在这个示例中，是 HTML 和 Form helper）。编辑这个文件，添加 $name 和 $helpers 类变量（见清单 16）。
现在已经在控制器中包含了 helper，可以开始使用它们了。
Tor 的用户应当能够查看注册使用该应用程序的其他用户。CakePHP 有大量 helper 可用于帮助创建表。这些 helper 包括很多有用的功能，其中一些功能您可能不止一次编写过。为了演示此功能，将创建一个用于显示注册用户的视图。
首先，在 users 控制器中创建 knownusers 操作（见清单 17）。
| function knownusers() { $this->set('knownusers', $this->User->find( 'all', array( 'fields' => array('id','username', 'first_name', 'last_name'), 'order' => 'id DESC' ) )); } |
这将调用 user 模型中的内置函数 find。find 函数接受许多参数，比如匹配条件（在本例中，传递的是 all 而不是一些匹配条件）、要返回的字段数组（不需要所有用户信息，只需要希望所有人都看到的信息），以及一个排序字段和顺序（在本例中，用 id DESC 按 ID 降序排序）。还可以指定限制（返回的最大行数）、分页（如果要给数据分页）以及可用于指定返回与数据关联的模型的递归选项（例如，查询一个 groups 表和属于每个组的若干个用户）。
find 的输出被放入 knownusers 变量。现在就可以从视图访问数据了。
在文本编辑器中创建文件 app/views/users/knownusers.ctp。要查看 findAll 返回的数据，应该使用 var_dump 输出 knownusers 变量（见清单 18）。
|
|
访问位于 的视图。应当会看到一个用户数据数组，如图 7 所示。
如果只列出了一个用户，请返回到 ，然后多注册一些用户。最终的结果将会更令人印象深刻。
获得足够大的用户数组了吗？很好！现在就将它转换为一个表。使用清单 19 中的内容替换 knownusers.ctp 的内容。
|
|
第一个 helper 将从数据数组（本例中为用户的键列表）创建一组表标题。第二个 helper 将从数据数组（本例中为每个用户的值）创建一组包围在表行标记中的表单元格。
好的！保存它，然后访问 来查看结果（见图 8）。
通过使用 tableCells helper，不必再编写循环遍历用户数据数组的代码。这仅仅是通过 helper 更轻松地在 CakePHP 中使用 HTML 的一个示例。
构建不使用表单的 Web 应用程序就像给小鸡喂奶一样：极为复杂，而且基本上是白费工夫。良好的可维护的表单是任何良好的应用程序的基础。如果需要经常构建表单，自然会希望找到能更轻松地完成此过程的方法。
在生成表单时 helper 尤为有用。可以使用它们为输入字段生成 HTML，以及生成占位符来保存检验错误消息。使用 helper 为 Tor 生成表单字段和错误消息占位符，register 视图可能类似于清单 20。
|
Please fill out the form below to register an account. create('User', array('action' => 'register'));?> input('first_name'); echo $form->input('last_name'); echo $form->input('username'); echo $form->input('email'); echo $form->input('password'); ?> end('Register');?> |
如您所见，使用 CakePHP 的 helper 可以节省编写基本表单元素所需的大量时间。现在来看看如何更充分地利用 helper。
要想通过 helper 获得更多的收益，需要做两件事：更新 users 控制器并引入一小段数据检验。打开 controllers/users_controller.php，然后将 register 函数改为清单 21 所示的内容。
| function register() { if (!empty($this->data)) { if ($this->User->save($this->data)) { $this->Session->setFlash('Your registration information was accepted.'); } } } |
注意，出现 $this->params['form'] 的位置都已改为 $this->data。
现在，打开 user 模型并添加一小段数据检验（稍后详细说明）。现在，按照清单 22 修改 user 模型。
| array ( 'rule' => 'notEmpty', 'message' => 'This field cannot be left blank.' ), 'password' => array ( 'rule' => 'notEmpty', 'message' => 'This field cannot be left blank.' ), 'email' => array( 'rule' => 'email', 'message' => 'Please supply a valid email address.' ) ); } ?> |
简单解释一下，$validate 数组包含用于检验的条目，由键（表单字段名）和用于评估数据的正则表达式组成。没必要检验所有表单字段。在清单 20 中，last_name 和 first_name 是可选的。CakePHP 附带了若干个预定义的用于数据检验的正则表达式。notEmpty 规则仅用于确保字段不为空，而 email 规则用于检验字符串像不像电子邮件地址。还有许多其他预定义的检验规则。
现在来试着运行一下。尝试提交没有数据的表单，将一个或两个必填字段留空，提供无效的电子邮件地址（见图 9）。您看到了什么？
现在，再来尝试一次，这次缺少不同的数据（见图 10）。
应当注意的一件事是，CakePHP 会自动显示和关闭错误消息。还应当注意，CakePHP 会记住并填充表单字段的值，无需您执行任何操作。
这就是最大的收益。您不必做哪些操作呢？一方面，不必告诉表单字段重新填充来自 _POST 数组的信息。CakePHP 替您执行了此操作。不必检查每个字段以查找错误，并有条件地单独显示每个消息。CakePHP 替您执行了此操作。不必确保将标记设置为有效的 xhtml。CakePHP 也替您执行了此操作。
本教程只涉及了 helper 的皮毛。这个主题非常广泛，可以针对它撰写一个完整的教程。了解如何更好地使用 helper 将会帮助您进一步加快 CakePHP 开发。CakePHP 包含用于 Ajax（使用 prototype.js）、JavaScript、数字转换、文本处理、日期、时间等方面的 helper。要了解这些 helper 的更多信息，请查看手册（请参阅 参考资料）。
CakePHP 数据检验
通过引入基于正则表达式的基本用户检验，您现在应该已经简要了解了 CakePHP 数据检验。通过定义自己的正则表达式来执行数据检验，可以在 Tor 内练习进一步控制各个表单字段的成功/失败条件。
再来看一看 user 模型（见清单 23）。
| array ( 'rule' => 'notEmpty', 'message' => 'This field cannot be left blank.' ), 'password' => array ( 'rule' => 'notEmpty', 'message' => 'This field cannot be left blank.' ), 'email' => array( 'rule' => 'email', 'message' => 'Please supply a valid email address.' ) } ?> |
这是一个好的开始，但还不够。需要确保字段长度不超出限制并且这个用户名尚不存在。这需要定义自己的用于检验的正则表达式，并定义在保存用户前在 users 表中查找用户名的函数。
全面讨论正则表达式超出了本教程的范围。PHP Manual 包含 PHP 正则表达式的相关信息，在编写自己的数据检验正则表达式之前应当先参考一下（见 参考资料）。
基本上，正则表达式 是在对一个字符串与另一个字符串进行比较时使用的字符模式。例如，正则表达式中的字符 * 将匹配任意字符任意次数。如果不了解正则表达式，请不必担心。下面的示例应当能帮助您入门。
对于用户名和密码字段，需要确认提交的数据长度不超过 40 个字符。检验用户名和密码的长度不少于 6 个字符也会有帮助。此外，我们还将使用的字符限定为数字和字母。用于匹配长度在 6 至 40 个字符之间的字符串的正则表达式类似于 /^[a-z0-9]{6,40}$/i。从左至右阅读这个正则表达式：
因此，连在一起读，这个正则表达式的意思就是 “从字符串的开头开始，有至少 6 个但不超过 40 个字母或数字，然后字符串结束，并忽略大小写”。
要使用这个正则表达式（见清单 24），请将出现 notEmpty 的地方替换为用单引号包围的正则表达式（为了阻止 PHP 尝试解释任何特殊字符）。
| array ( 'rule' => '/^[a-z0-9]{6,40}$/i', 'message' => 'This field must have between 6 and 40 alphanumeric characters.' ), 'password' => array ( 'rule' => '/^[a-z0-9]{6,40}$/i', 'message' => 'This field must have between 6 and 40 alphanumeric characters.' ), 'email' => array( 'rule' => 'email', 'message' => 'Please supply a valid email address.' ) ); } ?> |
确保保存所有文件，返回到 ，然后尝试用一个具有 4 个字符的用户名注册用户。应当会看到类似图 11 的内容。
正则表达式可以实现许多功能，但不能执行检查用户名是否已注册之类的操作。
有时，无法仅仅查看数据就判断出它是否有效。例如，用户名可能在 6 至 40 个字符之间，但还必须检查数据库来查看这个用户名是否已被占用。CakePHP 提供了可将字段手动标记为无效的功能。看一看清单 清单 25 中的 beforeValidate 方法。这个方法应该添加到 user 模型中。
| function beforeValidate() { if (!$this->id) { if ($this->findByUsername($this->data['User']['username'])) { $this->invalidate('username_unique'); return false; } } return true; } |
这个方法告诉模型，在运行任何检验之前，应该检查提交的数据是否有 ID。如果没有 ID，就寻找用户名相同的其他用户。如果找到这样的用户，就将用户名字段标为无效，并跳过其他检验（返回 false）。通过将 register.ctp 视图中的用户名输入行改为清单 26 所示的代码，就可以启用这个功能。
| echo $form->input('username', array('after' => $form->error ('username_unique', 'The username is taken. Please try again.'))); |
这告诉 register 视图，在遇到错误消息 'username_unique'（在 beforeValidate 方法中设置）时应该做什么。
保存文件，然后尝试操作。首先，访问 以获取现有用户列表。然后访问 ，随后尝试创建一个具有相同用户名的用户。应当会看到以下内容，如图 12 所示。
良好的数据检验是创建任何安全应用程序的重要步骤。在构建 Tor 应用程序的过程中，要寻找改进数据检验的机会。不要害怕引入比本教程更多的数据检验。决不要假定用户会把所需的数据发送给您。检验一切内容。CakePHP 可以帮助您轻松完成。
补充功能
到目前为止，用户可以向应用程序注册并查看已经注册的其他用户。这个应用程序需要补充一些功能。使用迄今为止您学到的技巧，尝试补充更多功能。请查阅 第 2 部分 以获得以下内容的示例。
login 视图应当收集用户登录信息并将其提交给 users 控制器。users 控制器应当查看这个用户是否已在数据库中，并检验密码是否正确。如果用户已经正确地登录，则把用户名写入会话并把用户发送到 index 操作。
提示：
index 操作应当查看用户的名称是否已被写入会话。如果用户的名称已被写入会话，则将该信息从数据库中取出，并向用户显示一条定制的欢迎词。如果用户尚未登录，则让用户执行 login 操作。
logout 操作应当从会话中删除用户的用户名，并将用户转发到 login 操作。
修改 register 操作，把用户自动登录到系统中，并把用户转到 index 操作。修改 register 和 login 操作以使用散列的密码，而不是将密码作为明文保存到数据库中。
编程愉快！
os-php-cake1.source.zip