common_functions

CodeIgniter为其操作使用了一些全局定义的函数，并随时为您提供。这些不需要加载任何库或帮助程序。

is_php($version)

参数：	$ version（string） - 版本号
返回：	如果正在运行的PHP版本至少为指定的版本，则为TRUE;否则为TRUE
返回类型：	布尔

• $ version（string） - 版本号

返回：如果运行的PHP版本至少是指定的版本，则返回TRUE;否则返回FALSE

Return type:  bool

确定正在使用的PHP版本是否大于提供的版本号。

例：

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

如果安装的PHP版本等于或大于提供的版本号，则返回boolean TRUE。如果安装的PHP版本低于提供的版本号，则返回FALSE。

is_really_writable($file)

参数：	$文件（字符串） - 文件路径
返回：	如果路径是可写的，则为TRUE，否则为FALSE
返回类型：	布尔

• $文件（字符串） - 文件路径

返回：如果路径可写则返回TRUE，否则返回FALSE

Return type:  bool

当只有标记了只读属性时，如果操作系统报告为PHP为FALSE，则当您无法写入文件时，is_writable（）会在Windows服务器上返回TRUE。

此函数通过首先尝试写入文件来确定文件是否实际可写。一般只在信息可能不可靠的平台上推荐。

例：

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

注意

config_item($key)

参数：	$ key（string） - 配置项目键
返回：	配置键值或NULL，如果未找到
返回类型：	杂

• $ key（string） - 配置项目键

返回：配置键值或NULL，如果未找到

Return type:  mixed

The [Config Library](../libraries/config) is the preferred way of accessing configuration information, however `config_item()` can be used to retrieve single keys. See [Config Library](../libraries/config) documentation for more information.

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

参数：	$ code（int） - HTTP响应状态码$ text（string） - 用状态码设置的自定义消息
返回类型：	空虚

• $ code（int） - HTTP响应状态码
• $ text（string） - 用状态码设置的自定义消息

Return type:  void

允许您手动设置服务器状态标题。例：

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

请参阅此处以获取标题的完整列表。

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

参数：	$ str（string） - 输入字符串$ url_encoded（bool） - 是否删除URL编码的字符
返回：	消毒的字符串
返回类型：	串

• $ str（string） - 输入字符串
• $ url_encoded（bool） - 是否删除URL编码的字符

Returns:  Sanitized string

Return type:  string

此功能可防止在ASCII字符之间插入空字符，如Java \ 0script。

例：

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

html_escape($var)

参数：	$ var（mixed） - 要转义的变量（字符串或数组）
返回：	HTML转义字符串（s）
返回类型：	杂

• $ var（mixed） - 要转义的变量（字符串或数组）

Returns:  HTML escaped string(s)

Return type:  mixed

This function acts as an alias for PHP’s native `htmlspecialchars()` function, with the advantage of being able to accept an array of strings.

它对防止跨站点脚本（XSS）很有用。

get_mimes()

返回：	文件类型的关联数组
返回类型：	排列

is_https()

返回：	如果当前使用HTTP-over-SSL，则为TRUE，否则为FALSE
返回类型：	布尔

is_cli()

返回：	如果当前在CLI下运行则为TRUE，否则为FALSE
返回类型：	布尔

function_usable($function_name)

参数：	$ function_name（string） - 函数名称
返回：	如果可以使用该功能，则为TRUE，否则为FALSE
返回类型：	布尔

• $ function_name（string） - 函数名称

Returns:  TRUE if the function can be used, FALSE if not

Return type:  bool

Returns TRUE if a function exists and is usable, FALSE otherwise.

这个函数运行一个function_exists()检查，如果Suhosin extension <http://www.hardened-php.net/suhosin/>加载，检查它是否不禁用被检查的函数。

如果您想检查诸如eval()和的功能的可用性，这是非常有用的exec()，这些功能是危险的，并且可能在具有高度限制性安全策略的服务器上被禁用。

注意

由于Suhosin终止了脚本执行，所以引入了这个函数，但事实证明这是一个错误。有一段时间（版本0.9.34）已经有一个修复程序可用，但不幸的是尚未发布。