Общие функции

CodeIgniter использует несколько функций для своей работы, которые определены глобально и доступны в любой момент. Для их использования не требуется загружать какие-либо библиотеки или вспомогательные функции.

is_php($version)

Параметры:	$version (string) – Номер версии
Возвращаемое значение:	TRUE, если текущая версия PHP соответствует или выше указанной, или FALSE, если нет
Тип возвращаемого значения:	bool

Определяет, является ли используемая версия PHP большей, чем указанный номер версии.

Пример:

if (is_php('5.3'))
{
        $str = quoted_printable_encode($str);
}

Возвращает boolean значение TRUE, если установленная версия PHP равна или больше указанного номера версии. Возвращает FALSE, если установленная версия PHP меньше указанного номера версии.

is_really_writable($file)

Параметры:	$file (string) – Путь к файлу
Возвращаемое значение:	TRUE, если путь доступен для записи, FALSE – если нет
Тип возвращаемого значения:	bool

Для серверов Windows функция is_writable() возвращает TRUE, когда невозможно записать в файл, так как ОС сообщает PHP FALSE только в том случае, если установлен атрибут «только для чтения».

Эта функция определяет, действительно ли файл доступен для записи, попытавшись сначала записать в него. Как правило, рекомендуется только на платформах, где эта информация может быть ненадежной.

Пример:

if (is_really_writable('file.txt'))
{
        echo "I could write to this if I wanted to";
}
else
{
        echo "File is not writable";
}

Примечание

См. также ошибку PHP #54709 для получения дополнительной информации.

config_item($key)

Параметры:	$key (string) – Ключ элемента конфигурации
Возвращаемое значение:	Значение ключа конфигурации или NULL, если ключ не найден
Тип возвращаемого значения:	mixed

Библиотека Config Library является предпочтительным способом доступа к информации о конфигурации, однако config_item() может использоваться для извлечения отдельных ключей. См. документацию по Config Library для получения дополнительной информации.

set_status_header($code[, $text = ''])

Параметры:	$code (int) – Код HTTP ответа $text (string) – Пользовательское сообщение для установки с кодом состояния
Тип возвращаемого значения:	void

Позволяет вручную установить заголовок статуса сервера. Пример:

set_status_header(401);
// Sets the header as:  Unauthorized

См. здесь полный список заголовков.

remove_invisible_characters($str[, $url_encoded = TRUE])

Параметры:	$str (string) – Входная строка $url_encoded (bool) – Удалять ли также символы, закодированные в URL
Возвращаемое значение:	Обработанная строка
Тип возвращаемого значения:	string

Эта функция предотвращает вставку нулевых символов между ASCII-символами, например, Java\0script.

Пример:

remove_invisible_characters('Java\\0script');
// Returns: 'Javascript'

html_escape($var)

Параметры:	$var (mixed) – Переменная для экранирования (строка или массив)
Возвращаемое значение:	Экранированная HTML строка(и)
Тип возвращаемого значения:	mixed

Эта функция является псевдонимом для встроенной PHP-функции htmlspecialchars(), с преимуществом возможности принимать массив строк.

Это полезно для предотвращения межсайтовых сценариев (XSS).

get_mimes()

Возвращаемое значение:	Ассоциативный массив типов файлов
Тип возвращаемого значения:	array

Эта функция возвращает ссылку на массив MIMEs из application/config/mimes.php.

is_https()

Возвращаемое значение:	TRUE, если используется HTTP-over-SSL, FALSE – если нет
Тип возвращаемого значения:	bool

Возвращает TRUE, если используется безопасное (HTTPS) соединение, и FALSE в противном случае (включая не HTTP-запросы).

is_cli()

Возвращаемое значение:	TRUE, если приложение запускается через командную строку, FALSE – если нет
Тип возвращаемого значения:	bool

Возвращает TRUE, если приложение запущено через командную строку, и FALSE – если нет.

Примечание

Эта функция проверяет, является ли значение PHP_SAPI равным ‘cli’, или константа STDIN определена.

function_usable($function_name)

Параметры:	$function_name (string) – Имя функции
Возвращаемое значение:	TRUE, если функция может быть использована, FALSE – если нет
Тип возвращаемого значения:	bool

Возвращает TRUE, если функция существует и может быть использована, FALSE – в противном случае.

Эта функция выполняет проверку function_exists() и, если библиотека Suhosin extension <http://www.hardened-php.net/suhosin/> загружена, проверяет, не отключает ли она проверяемую функцию.

Это полезно, если вы хотите проверить доступность функций, таких как eval() и exec(), которые опасны и могут быть отключены на серверах с очень строгими политиками безопасности.

Примечание

Эта функция была введена, потому что Suhosin завершал выполнение скрипта, но это оказалось ошибкой. Исправление доступно некоторое время (версия 0.9.34), но, к сожалению, ещё не выпущено.