CakePHP - the rapid development php framework

中文手册 Version1.0 Collected by Clove

回到目录

Cake’s Global Constants and Functions Cake的全局常量及方法

Section 1 全局方法

这些都是Cake领域内全局可用的方法。它们中有很多是对PHP长名方法更便利的包装,但是也有一些方法(比如verdor()和uses())可以用来包含代码,或者执行其他有用的功能。如果你想有一个短小精悍的方法来做一些烦人的事情,这里就可以找到答案。

config

读取Cake的核心配置文件。如果成功,返回true。

uses
    string $lib1
    string $lib2

用来载入Cake的核心类库(位于cake/libs/)。你需要提供不包含扩展名’.php’的类库文件名。

vendor
    string $lib1
    string $lib2…

用来载入位于/vendors目录下的外部类库。你需要提供不包含扩展名’.php’的类库文件名。

debug
    mixed $var
    Boolean $showHtml = false

如果应用程序的DEBUG等级被设置为非零的数字,$var的值将被输出。如果$showHtml的值为true,将在浏览器上显示友好的数据信息。

a

将传入此包装方法(译注:wrapping function,可以将多个参数打包成单一的数组)的所有参数打包成一个单一数组,并返回这个数组。

aa

将传入此包装方法的所有参数打包成一个关联数组,并返回这个数组。

e
    string $text

对方法echo()的包装,使用起来更加方便。

low

对方法strtolower()的包装,使用起来更加方便。

up

对方法strtoupper()得包装,使用起来更加方便。

r
    string $search
    string $replace
    string $subject

对方法str_replace()得包装,使用起来更加方便。

pr
    mixed $data

一个方便的方法,它等同于:

只有当DEBUG被设置为非零时它才会输出信息。

am
    array $array1
    array $array2…

将所有参数数组合并,并返回得到的新数组。

env
    string $key

可以从任何可用的资源获取到一个环境变量的值。你可以把它看成$_SERVER或$_ENV的后备(某些情况下,这两个变量也许会被禁用)。

cache
    string $path
    string $expires
    string $target = ‘cache’

将$data里的数据(译注:原文中这里并没有出现$data参数,是否是原作者漏写了?)以缓存形式写入/app/tmp下由$path指定的目录中。由$expires指定的超时时间必须是一个有效的strtotime()字符串。缓存数据的$target(目标)可以为’cache’(缓存)或者’public’(公共数据)。

clearCache
    string $search
    string $path = ‘views’
    string $ext

用来删除缓存目录下的文件,或者说清空缓存目录下的内容。
如果$search是一个字符串,名字与之相匹配的缓存目录或文件会从缓存中被移除。$search也可以是一个数组,这个数组由需要清除的文件或目录的名字组成。如果为空,/app/tmp/cache/views下的所有文件都将被清除。 $path参数用来指定/tmp/cache的哪个目录将被清除。默认为’views’。 $ext参数用来指定你想清除的文件的扩展名。

stripslashes_deep
    array $array

递归地将数组所包含的数据里所有斜杠(’/’)去掉(译注:如果该数组里还包含数组元素,将自动递归地对这些数组调用这个方法)。

countdim
    array $array

以数字的形式返回数组$array的维度。

fileExistsInPath
    string $file

在当前路径下搜索指定的文件。如果找到该文件,返回其路径;否则返回false。

convertSlash
    string $string

将指定字符串里的反斜杠(’\’)转换成下划线(’_’),并且去掉的第一个和最后一个下划线。

Section 2 CakePHP内核定义的常量

Section 3 CakePHP的路径常量

Section 4 CakePHP 网站根目录(Webroot)配置的路径