许可
CakePHP 的许可是基于 MIT license 的。这意味着你能够在保持版权声明完整的前提下自由的修改、分发和重发布其源码。 你也可以在商业或封闭源代码的应用程序中包含 CakePHP。
下载 CakePHP
有两种主要途径用来获得 CakePHP 的最新副本。你可以从主站下载（有三种格式：zip/tar.gz/tar.bz2), 或者从 git 仓库中检出代码。
要想下载最新的主版本，访问主站 并且点击 “Download Now” 链接。
全部当前版本都寄存在 上。Github 收藏了全部的 CakePHP，并且还包含了许多的 CakePHP 的插件。 有效的 CakePHP 版本在 。
另外，你也可以获取最新的带有全部 bug 修正的每分钟提交的源代码。 这可以访问 仓库并克隆副本:
-
git clone git://github.com/cakephp/cakephp.git
访问权限
CakePHP 的一些不同操作需要使用 app/tmp 目录：模块描述、视图缓存和 session 信息等。
因此，你需要确定 web 服务器用户拥有 cake 安装目录下的 app/tmp 目录和它的全部子目录的写权限。
设置
CakePHP 可以极其简单地布署在 web 服务器的文档根目录中，也可以以你所期望的方式灵活复杂地进行布署。 这一节将覆盖 CakePHP 的三种主要安装类型： 开发、产品和高级。
-
开发：最容易进行。应用程序的 URLs 包括 CakePHP 的安装目录名，安全级别低。
-
产品：包括配置 web 服务器的文档根目录的能力、整洁的 URL，非常安全。
-
高级: 带有许多配置，允许你将 CakePHP 的关键目录放在文件系统的不同位置，可以在多个 CakePHP 应用程序间共享同一个 CakePHP 内核库文件夹。
开发模式
开发安装是设置 Cake 的最快方法。 本例将帮助你安装一个 CakePHP 应用程序，并使其在 地址上生效。 我们假定你的文档根目录是在 /var/www/html 。
将 Cake 压缩文件的内容解压到 /var/www/html。现在在文档根目录中有了一个以下载的版本为后缀命名的文件夹（例如 cake_2.0.0）。 将这个文件夹改名为 cake_2_0. 你的开发安装在文件系统看起来结构就像下面这样：
-
/var/www/html
-
cake_2_0/
-
app/
-
lib/
-
vendors/
-
plugins/
-
.htaccess
-
index.php
-
README
如果 web 服务器配置正确，现在就可以通过 访问你的 Cake 应用程序了。
在多个应用程序中使用同一份 CakePHP
如果你开发几个应用程序，常常会感觉需要在它们之间共享一份 CakePHP 核心副本。有几个办法能达到这个目的。最简单的是使用 PHP 的 include_path。 首先，克隆 CakePHP 到一个目录。本示例中，我们使用 ~/projects :
-
git clone git://github.com/cakephp/cakephp.git ~/projects/cakephp
这会把 CakePHP 克隆至 ~/projects 目录。如果不想使用 git，你可以下载 zip 包，其余的步骤是相同的。 接下来，你需要找到并编辑你的 php.ini 文件。 在 *nix 系统中，常常会是 /etc/php.ini，可以使用 php -i 查找 ‘载入的配置文件’。 一旦你找到正确的 ini 文件，编辑 include_path 选项，使其包含 ~/projects/cakephp/lib。 例如：
-
include_path = .:/home/mark/projects/cakephp/lib:/usr/local/php/lib/php
然后，启动 web 服务，在 phpinfo() 中能够看到这些修改的结果.
注意：
如果使用 windows 系统，包含路径的分隔符就是 ;（半角分号），而不是 :（半角冒号）。
完成了 include_path 设置，应用程序就能够自动找到 CakePHP。
产品
产品安装是配置 Cake 的更灵活的方法。 这种方式允许整个域作为 CakePHP 应用程序。 本示例将帮助你在文件系统的任意位置安装 Cake，并且使其在 生效。 需要注意的是，这种安装可能需要改变 Apache web 服务器的 DocumentRoot 。
将 Cake 压缩包的内容解压到你选择的目录。在本救命中，我们假定你选择将 Cake 安装到 /cake_install。 你的产品安装的文件夹结构类似下面这样：
-
/cake_install/
-
app/
-
webroot/ （这是 Apache 的DocumentRoot 指令设置的目录）
-
lib/
-
vendors/
-
plugins/
-
.htaccess
-
index.php
-
README
程序员需要将 Apache 域名的 DocumentRoot 指向到安装目录：
-
DocumentRoot /cake_install
如果 web 服务器配置正确，将可以在 访问你的 Cake 应用程序。
高级安装和典型的服务器配置
某些情况下你可能希望把 CakePHP 目录放在文件系统的不同位置。这可能是由共享主机限制或者你想让你的几个应用共用一个 Cake 库引起的。这一节描述如何跨文件系统分布 CakePHP 目录。
首先，要了解 CakePHP 应用程序有三个主要的组成部分：
-
核心 CakePHP 库，在/lib/Cake。
-
应用程序代码，在/app。
-
应用程序的 web 根目录，在/app/webroot。
这些目录的每一个都可以放在文件系统的任何位置，webroot有点特殊，它需要能被 web 服务器用户访问。也可以把 webroot 放在 app 文件夹之外，前提你告诉了 Cake 你把它放在哪儿了。
对于配置 CakePHP 安装，需要改变如下文件：
-
/app/webroot/index.php
-
/app/webroot/test.php （如果你使用“测试”特性）
有三个需要编辑的常量：ROOT、APP_DIR 和 CAKE_CORE_INCLUDE_PATH。
-
ROOT 需要设置为包含你的 app 文件夹的目录的路径。
-
APP_DIR 需要设置为 app 文件夹的（基本）名（译者注：不是路径，而是文件夹名称）。
-
CAKE_CORE_INCLUDE_PATH 需要设置为 CakePHP 库文件夹的路径。
让我们通过一个例子来运行，以使你明白高级安装在实践中看起来是什么样子。假设我想要把 CakePHP 设置成像下面这样工作：
-
CakePHP 的核心库被放在 /usr/lib/cake。
-
应用程序的 webroot 目录是在 /var/www/mysite/。
-
应用程序的 app 目录是在 /home/me/myapp。
对于这种类型的安装，需要编辑 webroot/index.php （在本实例中，内容添加在 /var/www/mysite/index.php的结尾），看上去就像下面这样：
-
<?php
-
// /app/webroot/index.php （节选，注释已经删除）
-
-
if (!defined('ROOT')) {
-
define('ROOT', DS.'home'.DS.'me');
-
}
-
-
if (!defined('APP_DIR')) {
-
define ('APP_DIR', 'myapp');
-
}
-
-
if (!defined('CAKE_CORE_INCLUDE_PATH')) {
-
define('CAKE_CORE_INCLUDE_PATH', DS.'usr'.DS.'lib');
-
}
推荐使用常量 DS 代替斜线作为路径的分隔符号。这可以防止因使用了错误的分隔符造成的那些文件找不到的问题，并且使代码的可移植性更高。
Apache 和 mod_rewrite（以及 .htaccess）
当 CakePHP 被构建成基于 mod_rewrite 工作时（通常都是这样），我们注意到一些用户努力地去做一切能使他们的系统更好的运行的事情。
有几件你可能需要尝试的会使运行良好的事。首先看看你的 httpd.conf （确定你编辑的是系统的 httpd.conf，而不是用户的或特定站点的）。
-
确定 .htaccess 被允许覆盖，并且正确的 DocumentRoot 的 AllowOverride 被设置为 All。你应该看到如下的内容：
-
# Each directory to which Apache has access can be configured with respect
-
# to which services and features are allowed and/or disabled in that
-
# directory (and its subdirectories).
-
#
-
# First, we configure the "default" to be a very restrictive set of
-
# features.
-
#
-
<Directory />
-
Options FollowSymLinks
-
AllowOverride All
-
# Order deny,allow
-
# Deny from all
-
</Directory>
-
确定已经正确地加载了 mod_rewrite。你应该看到如下的内容：
-
LoadModule rewrite_module libexec/apache2/mod_rewrite.so
在很多系统里，这些默认是被注释掉的（行的起始是一个 #），这时你只需要删除起始的 # 符号。
修改完成后，重启 Apache 并确定设置已经生效。
检测你的 .htaccess 是不是真的在正确的目录中。
在拷贝过程可能会发生这样一种情况，因为某些操作系统隐藏了以 . 开头的文件，以致看不到它的拷贝副本。确定你的 CakePHP 副本来自本站的 Downloads 一节指定的站点或 Git 仓库，并已经被正确地解压（通过检查 .htaccess 文件）。
-
Cake 根目录（需要拷贝到你的文档，重定向每件事物到 Cake app）：
-
<IfModule mod_rewrite.c>
-
RewriteEngine on
-
RewriteRule ^$ app/webroot/ [L]
-
RewriteRule (.*) app/webroot/$1 [L]
-
</IfModule>
-
Cake app 目录（拷贝到应用程序的顶级目录）
-
<IfModule mod_rewrite.c>
-
RewriteEngine on
-
RewriteRule ^$ webroot/ [L]
-
RewriteRule (.*) webroot/$1 [L]
-
</IfModule>
-
Cake webroot 目录（拷贝到应用程序的 webroot 目录）
-
<IfModule mod_rewrite.c>
-
RewriteEngine On
-
RewriteCond %{REQUEST_FILENAME} !-d
-
RewriteCond %{REQUEST_FILENAME} !-f
-
RewriteRule ^(.*)$ index.php/$1 [QSA,L]
-
</IfModule>
对于更多的主机服务（GoDaddy，1and1），你的 web 服务器实际上使用了用户目录来服务，并且已经应用了 mod_rewrite。如果你把 CakePHP 安装在用户目录中（~username/cakephp/）或其它已经应用了 mod_rewrite 的 URL 结构，你需要在 CakePHP 所用的 .htaccess（/.htaccess，/app/.htaccess， /app/webroot/.htaccess） 中添加 RewriteBase 语句。
也能把 RewriteEngine 指令添加到同一节，例如 webroot 中的 .htaccess 文件可能像这样：
-
<IfModule mod_rewrite.c>
-
RewriteEngine On
-
RewriteBase /path/to/cake/app
-
RewriteCond %{REQUEST_FILENAME} !-d
-
RewriteCond %{REQUEST_FILENAME} !-f
-
RewriteRule ^(.*)$ index.php/$1 [QSA,L]
-
</IfModule>
修改的具体情况依赖于实际的设置，还可以包含与 CakePHP 无关的其它内容。更多信息请参考 Apache 在线文档。
漂亮的 URLs 和 Lighttpd
虽然 Lighttpd 包含 rewrite 模块，但是它不同于 Apache 的 mod_rewrite。为了在使用 Lighty 获取“漂亮的 URLs”，你有两个选择。一是使用 mod_rewrite，二是通过使用 LUA 脚本和 mod_magnet。
使用 mod_rewrite：获得“漂亮的 URLs”的最快的方法是在 Lighty 的配置中添加如下脚本。再编辑一下URL，就应该没问题了。需要注意的是当 CakePHP 安装在子文件夹时这种方法无效。
-
$HTTP["host"] =~ "^(www\.)?example.com$" {
-
url.rewrite-once = (
-
# if the request is for css|files etc, do not pass on to Cake
-
"^/(css|files|img|js)/(.*)" => "/$1/$2",
-
"^([^\?]*)(\?(.+))?$" => "/index.php/$1&$3",
-
)
-
evhost.path-pattern = "/home/%2-%1/www/www/%4/app/webroot/"
-
}
使用 mod_magnet：和 CakePHP、Lighttpd 一起使用“漂亮的 URLs”，在 /etc/lighttpd/cake中放置如下 LUA 脚本。
-
-- little helper function
-
function file_exists(path)
-
local attr = lighty.stat(path)
-
if (attr) then
-
return true
-
else
-
return false
-
end
-
end
-
function removePrefix(str, prefix)
-
return str:sub(1,#prefix+1) == prefix.."/" and str:sub(#prefix+2)
-
end
-
-
-- prefix without the trailing slash
-
local prefix = ''
-
-
-- the magic ;)
-
if (not file_exists(lighty.env["physical.path"])) then
-
-- file still missing. pass it to the fastcgi backend
-
request_uri = removePrefix(lighty.env["uri.path"], prefix)
-
if request_uri then
-
lighty.env["uri.path"] = prefix .. "/index.php"
-
local uriquery = lighty.env["uri.query"] or ""
-
lighty.env["uri.query"] = uriquery .. (uriquery ~= "" and "&" or "") .. "url=" .. request_uri
-
lighty.env["physical.rel-path"] = lighty.env["uri.path"]
-
lighty.env["request.orig-uri"] = lighty.env["request.uri"]
-
lighty.env["physical.path"] = lighty.env["physical.doc-root"] .. lighty.env["physical.rel-path"]
-
end
-
end
-
-- fallthrough will put it back into the lighty request loop
-
-- that means we get the 304 handling for free. ;)
注意：
如果要在子文件夹中运行 CakePHP 安装，要在上面的脚本中设置 prefix = ‘subdirectory_name’。
然后通知 Lighttpd 你的虚拟主机是什么：
-
$HTTP["host"] =~ "example.com" {
-
server.error-handler-404 = "/index.php"
-
-
magnet.attract-physical-path-to = ( "/etc/lighttpd/cake.lua" )
-
-
server.document-root = "/var/www/cake-1.2/app/webroot/"
-
-
# Think about getting vim tmp files out of the way too
-
url.access-deny = (
-
"~", ".inc", ".sh", "sql", ".sql", ".tpl.php",
-
".xtmpl", "Entries", "Repository", "Root",
-
".ctp", "empty"
-
)
-
}
漂亮的 URLs 和 nginx
像Lighttpd 一样，nginx 也是一个占用更少系统资源的流行的服务器。其缺点是不像 Apache 和 Lighttpd 那样使用 .htaccess，它必须在可用站点的配置中建立重写的 URLs。依赖于你的设置，你必须要修改这些内容，至少，PHP 要作为 FastCGI 实例来运行。
-
server {
-
listen 80;
-
server_name www.example.com;
-
rewrite ^(.*) http://example.com$1 permanent;
-
}
-
-
server {
-
listen 80;
-
server_name example.com;
-
-
access_log /var/www/example.com/log/access.log;
-
error_log /var/www/example.com/log/error.log;
-
-
location / {
-
root /var/www/example.com/public/app/webroot/;
-
index index.php index.html index.htm;
-
try_files $uri $uri/ /index.php?$uri&$args;
-
}
-
-
location ~ .*\.php$ {
-
include /etc/nginx/fcgi.conf;
-
fastcgi_pass 127.0.0.1:10005;
-
fastcgi_index index.php;
-
fastcgi_param SCRIPT_FILENAME /var/www/example.com/public/app/webroot$fastcgi_script_name;
-
}
-
}
基于IIS7 的 URL 重写（Windows 主机）
IIS7原生是不支持 .htaccess的。一些插件可以添加这种支持，也可以用 CakePHP 自带的 rewrite 向 IIS 导入 htaccess 规则。步骤如下：
使用 Microsoft’s Web Platform Installer （微软 web 平台安装器）安装 URL Rewrite 模块。
在 CakePHP 文件夹建立一个文件，命名为 web.config。
使用记事本或其它 xml 安全的编辑器，将如下代码拷贝到 web.config：
-
<?xml version="1.0" encoding="UTF-8"?>
-
<configuration>
-
<system.webServer>
-
<rewrite>
-
<rules>
-
<rule name="Imported Rule 1" stopProcessing="true">
-
<match url="^(.*)$" ignoreCase="false" />
-
<conditions logicalGrouping="MatchAll">
-
<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
-
<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
-
</conditions>
-
<action type="Rewrite" url="index.php?url={R:1}" appendQueryString="true" />
-
-
</rule>
-
-
<rule name="Imported Rule 2" stopProcessing="true">
-
<match url="^$" ignoreCase="false" />
-
<action type="Rewrite" url="/" />
-
</rule>
-
<rule name="Imported Rule 3" stopProcessing="true">
-
<match url="(.*)" ignoreCase="false" />
-
<action type="Rewrite" url="/{R:1}" />
-
</rule>
-
<rule name="Imported Rule 4" stopProcessing="true">
-
<match url="^(.*)$" ignoreCase="false" />
-
<conditions logicalGrouping="MatchAll">
-
<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
-
<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
-
</conditions>
-
<action type="Rewrite" url="index.php/{R:1}" appendQueryString="true" />
-
</rule>
-
</rules>
-
</rewrite>
-
</system.webServer>
-
</configuration>
也可以使用 IIS Rewrite 模块的导入功能从 CakePHP 的根目录、/app/ 及 /app/webroot目录中的 .htaccess 直接导入规则——虽然一些 IIS 的编辑必须要得到这些工作。使用这种方式导入规则，IIS 将自动建立 web.config 文件。
一旦带有正确的对 IIS 友好的 rewrite 规则的 web.config 文件，CakePHP 的链接、js、css 和路由都会正确的工作。
开火
好了，让我们看看 CakePHP 实战。依赖于所用的设置，将浏览器指向 或者 cake_install/。此时，将会看到 CakePHP 的默认页面，和一条有关当前数据库连接状态的消息。
恭喜！你已经完成了 建立第一个 CakePHP 应用程序的 课程。
没能正常工作？如果你看到了关于时区错误的信息，取消 app/Config/core.php 中如下这一行的注释
-
<?php
-
/**
-
* 取消这一行的注释，修正服务器 timezone，以便纠正
-
* 所有的日期和时间相关的错误。
-
*/
-
date_default_timezone_set('UTC');
