• CakePHP manual 中文翻译2

    第三章 安装CakePHP

    1，Requirements

    你必须有一个服务器，具备程序和库来运行CakePHP

    1.1 服务器的要求

    1.HTTP服务端（比如Apache），下面的选项要打开：sessions, mod_rewrite(虽然不是必须但是建议有)

    2.PHP 4.3.2或者更高版本，CakePHP在PHP4和5下都能很好工作

    3.数据库引擎（现在已经支持MySQL，PostgreSQL and a wrapper for ADODB）

    2.安装CakePHP

    2.1 得到最新的稳定版本

    www.cakephp.org 点击Downloads>Release

    2.2 解压缩

    放置到根目录，解压缩，有两种安装方式，开发方式安装使得你可以容易的在一个域名下面察看许多CakePHP程序，产品安装方式使得一个域名下面只有一个程序

    3. 建立CakePHP

    第一种方法在开发环境下比较合适，但是并不安全。第二种方法更安全可以安装在最终产品的环境下

    3.1 开发方式安装

    为了开发，我们可以将整个Cake的安装目录放到特殊的DocumentRoot下，如下：

    1. /wwwroot/
    2.     /cake
    3.         /.htaccess
    4.         /app/
    5.         /cake/
    6.         /index.php
    7.         /tmp/
    8.         /vendors

    这种安装wwwroot当作整个网站的目录，所以你的URL如下显示
    www.example.com/cake/index.php

    如果你使用了mod_rewrite, 你的URLs会变成下面的这种形式
    http://www.example.com/cake/controller_name/action_name/param1/param2 pattern

    3.2 产品方式安装

    为了实现产品方式的安装，你必须用于修改服务器上网站根目录的权限，修改根目录，使得整个域像只有一个CakePHP程序

    安装后的程序结构如下

    1. ../path_to_cake_install/
    2.     /.htaccess
    3.     /app/
    4.         /config/
    5.         /conftrollers
    6.         /index.php
    7.         /models
    8.         /plugins
    9.         /views
    10.         /webroot <-- This should be your new DocumentRoot
    11.     /cake/
    12.     /index.php
    13.     /tmp/
    14.     /vendors

    例3.1 建议的httpd.conf

    1. DocumentRoot /path_to_cake/app/webroot

    在这种配置下，webroot就当作了网站的根目录，你的URL就可能像下面这样
    http://www.example.com/

    如果你使用了mod_rewrite，你的URL就会类似于下面的
    http://www.example.com/controller_name/action_name/param1/param2 pattern

    一些共享主机的用户可能没有权限通过修改http.conf来改变DocumnentRoot来指向他们的产品安装。在这种情况下，用户可以安装下面的方式，修改CakePHP的结构。Cake安装在 /path_to_cake_install，文件目录（不可以修改）指向/public_html

    1. /path_to_cake_install
    2.     /app
    3.     /cake
    4.     /index.php
    5.     /models
    6.     /plugins
    7.     /views
    8.     /webroot
    9. /public_html (= contents of /app/webroot)
    10.     /.htaccess
    11.     /css   
    12.     /css.php        
    13.     /favicon.ico    
    14.     /files          
    15.     /img            
    16.     /index.php      
    17.     /js

    实际上，你将Cake的/app/webroot文件夹的内容拷贝到你已经存在的DocumentRoot。为了告诉Cake你的webroot文件在哪里，将下面几行田间到你DocumentRoot文件夹下面的index.php中（针对上面的例子就是/public_html/index.php）

    1. define('ROOT', BASE_DIR.'/path_to_cake_install');
    2. define ('APP_DIR', 'app');
    3. define ('WEBROOT_DIR', '/public_html');

    4. 配置Apache和mod_rewrite

    当CakePHP没有mod_rewrite支持时候，我们发现许多用户由于不能完美运行他们的系统而苦恼。下面是一些可能需要尝试并且使之正确运行的事情：

    ● 确定 .htaccess的override是允许的：在你的httpd.conf中，你需要有一段代码，在你的服务器上每个目录。确定AllowOverride对当前的目录设置成为All

    ● 确定你修改的是系统的httpd.conf，而不是用户或者特定站点的httpd.conf

    ● 在某些情况下，你可能得到一份缺少 .htaccess文件的CakePHP,这可能是因为某些系统把 .开头的文件当作隐藏文件就不拷贝。确定你拷贝的文件来中包含.htaccess

    ● 确定你正确上传mod_rewrite。你可以查看一下 httpd.conf中类似于LoadModule rewrite_module libexec/httpd/mod_rewrite.so 和AddModulemod_rewrite.c

    5. 确定CakePHP正确工作

    现在，我们实际查看一下。根据你选择不同的安装方式，你应该将你的浏览器的URL指向 http://www.example.com或者http://www.example.com/cake.这时，你会看到CakePHP的默认目录，以及一条数据库连接状态的消息。

    恭喜！你现在已经可以创建你的第一个基于Cake的程序了。如果你现在什么都没有看到或者受到一条错误信息，可以到http://wiki.cakephp.org或者#cakephp on irc.freenode.net寻找更多的帮助。

    第四章 配置

    1. 数据库配置

    app/config/database.php文件是数据库配置文件。默认安装后并没有database.php文件，所以你需要拷贝database.php.default到database.php. 之后，你可以看到如下：

    1. 例4.1
    2. var $default = array('driver'   => 'mysql',
    3.                      'connect'  => 'mysql_pconnect',
    4.                      'host'     => 'localhost',
    5.                      'login'    => 'user',
    6.                      'password' => 'password',
    7.                      'database' => 'project_name' );

    根据你的数据库连接信息替换上面的配置

    CakePHP支持下面的数据库驱动

    mysql
    postgres
    sqlite
    pear-drivername (so you might enter pear-mysql, for example)
    adodb-drivername

    $default 连接中的connect key允许你设置是否需要持久连接数据库，请仔细阅读database.php.default文件中的注释，以配置你的数据库连接类型。

    你的数据库中的表也应该遵循下面的命名规则：

    ● cake使用的表名(Table name)应该有英文的复数形式组成，比如users, authors, articles. 注意，对应的model是单数形式

    ● 所有的表 都必须有一个主键叫做 id

    ● 如果你需要关联tables，使用外键比如 article_id 。表的名字是单数，必须是小写,比如id

    ● 另外，最好遵从下面的命名规则以便更方便的使用某些功能

    Include a ‘created’ 列

    Include a ‘modified’列

    你也可能注意到了database.php文件中有一个$test的连接，填上这个配置（或者添加其他类似的配置文件），在你使用的时候将下面的代码

    添加到你的一个models中

    1. var $useDbConfig = 'test';

    2. 全局配置

    CakePHP的全局配置可以在/app/config/core.php找到。尽管我们确实不喜欢配置文件，但是配置确实很难做。在这个文件中你可以修改一些，每一项设置都可以在core.php的注释中找到。

    DEBUG: 设置这个变量不同的值可以帮助你在运行文件的时候debug你的程序。江这个值设成不同的非0值，可以使得Cake打印出SQL语句并且阻止程序下一步进行(原文：Specifiying this setting to a non-zero value will force Cake to print out SQL statements and stop flash messages from forwarding.)

    CAKE_SESSION_COOKIE:在你的Cake应用中，这个变量可以设置成为保存用户session的cookie名字

    CAKE_SECURITY:这个变量不同的值达标不同的sessions检查等级。Cake创建新的session,删除旧的session都基于这个变量。下面是可能的值：

    high: session十分钟后失效

    medium: session 二十分钟后失效

    low: session 三十分钟后失效

    CAKE_SESSION_SAVE: 设置如何保存session。下面是可能的值

    cake: 保存在tmp/目录下

    php: 根据php.ini中的设置保存

    database: 被保存到默认（现在还没有实现，以后继续完善）

    3.路径设置

    ‘Routing’是类似于mod_rewrite的 pared-down pure-PHP(机制)，可以帮助将URL影射到 controller/action/params. Cake 添加这个可以帮助我们更好的实现URL转化并使得我们可以脱离mod_rewrite的要求。然而使用mod_rewrite，使得我们的address bar显得更加整洁。

    Routes是映射URLs到特定的controllers和actions的独立规则。Routes被配置在app/config/routes.php文件中，设置形式如下：

    1. 例4.2 Route Pattern
    2. <?php
    3. $Route->connect (
    4.     'URL',
    5.     array('controller'=>'controllername',
    6.     'action'=>'actionname', 'firstparam')
    7. );
    8. ?>

    在这里

    URL是Cake的URL你想要映射的（URL is the Cake URL you wish to map）

    controllername 是你想要调用的controller的名字

    actionname 是你想要调用controller的action的名字

    firstparam是特定的action的第一个参数

    下面的这个例子将/blog下面的所有URL连接到了BlogController. 默认的action是BlogController::index()

    例4.3 Route Example

    1. <?php
    2. $Route->connect ('/blog/:action/*', array('controller'=>'Blog', 'action'=>'index'));
    3. ?>

    一个URL 比如 /blog/history/05/june 处理如下：

    1. 例4.4 Route Handing in a Controller
    2. <?php
    3. class BlogController extends AppController
    4. {
    5. function history ($year, $month=null)
    6.      {
    7.            //..display appropriate content
    8.      }
    9. }
    10. ?>

    URL中的’history’被匹配到 Blog route中的:action.( The ‘history’ from the URL was matched by :action from the Blog’s route.) URL中被*匹配的元素被传递到活动的controller的处理方法，这里是$year和$month。比如这个URL /blog/history/05, 仅仅传递一个参数05给history()

    接下来的例子是默认的CakePHP route，指向 PagesController::display(‘home’).其中home是一个view，位于/app/views/pages/home.thtml

    1. 例4.5 Setting the Default Route
    2. <?php
    3. $Route->connect ('/*', array('controller'=>'Pages', 'action'=>'display', 'home'));
    4. ?>
  • 相关阅读:
    如何加速JavaScript 代码
    以Kafka Connect作为实时数据集成平台的基础架构有什么优势？
    Java多线程开发系列之一：走进多线程
    java运行环境和运行机制
    C#先序遍历2叉树（非递归）
    Java 之 List<T> 接口的实现：ArrayList
    string.split() 解读---------->从java 和C#的角度剖析
    究竟什么是语法糖呢
    Eclipse 恢复删除的文件
    Notepad++自动刷新文本
  • 原文地址：https://www.cnblogs.com/kuyuecs/p/1330430.html
Copyright © 2020-2023  润新知