CakePHP: Manual/Developing/Globals/Functions

Глобальные функции

Здесь представлены глобально доступные функции CakePHP. Многие из них – это удобные обертки для PHP функций с длинными названиями. Но, некоторые – (например vendor() и uses() ) могут быть использованы для включения кода или выполнения других полезных функций. Если вы постоянно ищете функцию для выполнения часто встречающейся задачи, вероятнее всего она здесь.


__

__(string $string_id, boolean $return = false)

Эта функция управляет локализацией в CakePHP приложениях. $string_id определяет ID для перевода, второй параметр позволяет вам иметь функцию, автоматически выводящую строку (поведение по умолчанию), или возвращающую ее для дальнейшей обработки (передавайте значение true для включения такого поведения).


a

a(mixed $one, $two, $three...)

Возвращает массив параметров, переданных функции.

print_r(a('foo', 'bar')); 

// результат:

array(

   [0] => 'foo',

   [1] => 'bar'

)


aa

aa(array $one, $two, $three...)

Используется для создания ассоциативных массивов, на основе переданных параметров.

echo aa('a','b'); 

// результат:

array(

    'a' => 'b'

)


am

am(array $one, $two, $three...)

Сливает все массивы, переданные в качестве параметров и возвращает новый массив.


config

Может быть использована для загрузки файлов из вашего config-каталога через include_once. Функция выполняет проверку на существование файла перед его включением и возвращает boolean. Также принимает несколько необязательных параметров.

Пример: config('some_file', 'myconfig');


convertSlash

convertSlash(string $string)

Преобразует слэши «/» в символы подчеркивания “_" и удаляет первый и последний символы подчеркивания в строке. Возвращает преобразованную строку.


countdim

countdim(array $array)

Возвращает размерность данного массива.


debug

debug(mixed $var, boolean $showHtml = false)

Если уровень DEBUG не равен нулю, то будет выводиться $var. Если $showHTML установлен в true, то данные будут визуализироваться в дружественном для браузеров виде.


e

e(mixed $data)

Удобная обертка для echo().


env

env(string $key)

Получает переменную окружения из доступных источников. Используется в качестве дубляжа, если $_SERVER или $_ENV отключены.

Эта функция также эмулирует PHP_SELF и DOCUMENT_ROOT на серверах, которые не поддерживают их. В действительности, хорошая идея – всегда использовать env() вместо $_SERVER или getenv() (особенно, если вы планируете распространять код).


fileExistsInPath

fileExistsInPath(string $file)

Проверяет находится ли данный файл в текущем include_path PHP. Возвращает boolean.


h

h(string $text, string $charset)

Удобная обертка для htmlspecialchars().


ife

ife($condition, $ifNotEmpty, $ifEmpty)

Используется для тернарных операций. Если $condition не пустое, то возвращается $ifNotEmpty, иначе возвращается $ifEmpty.


low

low(string $string)

Удобная обертка для strtolower().


path

paths()

Получает основные пути CakePHP в виде массива. Результирующий массив будет содержать массив путей с индексами: Models, Behaviors, Controllers, Components, Helpers.

Эта функция не доступна в RC2. Используйте Configure::corePaths()


pr

pr(mixed $var)

Удобная обертка для print_r(), с дополнительными обвертывающими результат тэгами <pre>.


r

r(string $search, string $replace, string $subject)

Удобная обертка для str_replace().


stripslashes_deep

stripslashes_deep(array $value)

Рекурсивно убирает экранирование из передаваемого $value. Возвращает измененный массив.


up

up(string $string)

Удобная обертка для strtoupper().


uses

uses(string $lib1, $lib2, $lib3...)

Используется для загрузки библиотек CakePHP (расположенных в cake/libs/). В качестве параметров принимает имена файлов библиотек без расширения '.php'.


<< Глобальные константы и функции | Константы, определенные в ядре >>