# 公共函數
CodeIgniter 定義了一些全局的函數,你可以在任何地方使用它們,并且不需要加載任何 類庫或輔助函數。
>[info] ### is_php($version)
參數:
* **$version**?(string) -- Version number
返回:
TRUE if the running PHP version is at least the one specified or FALSE if not
返回類型:
bool
判斷當前運行的 PHP 版本是否高于或等于你提供的版本號。
例如:
~~~
if (is_php('5.3'))
{
$str = quoted_printable_encode($str);
}
~~~
如果當前運行的 PHP 版本等于或高于提供的版本號,該函數返回布爾值 TRUE ,反之則返回 FALSE 。
>[info] ### is_really_writable($file)
參數:
* **$file**?(string) -- File path
返回: TRUE if the path is writable, FALSE if not
返回類型: bool
在 Windows 服務器上只有當文件標志了只讀屬性時,PHP 的?is_writable()?函數才返回 FALSE , 其他情況都是返回 TRUE ,即使文件不是真的可寫也返回 TRUE 。
這個函數首先嘗試寫入該文件,以此來判斷該文件是不是真的可寫。通常只在?is_writable()?函數 返回的結果不準確的平臺下才推薦使用該函數。
例如:
~~~
if (is_really_writable('file.txt'))
{
echo "I could write to this if I wanted to";
}
else
{
echo "File is not writable";
}
~~~
注解
更多信息,參看?[PHP bug #54709](https://bugs.php.net/bug.php?id=54709)?。
>[info] ### config_item($key)
參數:
* **$key**?(string) -- Config item key
返回:
Configuration key value or NULL if not found
返回類型:
mixed
訪問配置信息最好的方式是使用?[配置類](http://codeigniter.org.cn/user_guide/libraries/config.html)?,但是,你也可以通過?config_item()?函數來訪問單個配置項,更多信息,參看?[配置類](http://codeigniter.org.cn/user_guide/libraries/config.html)
>[info] ### set_status_header($code[,?$text = ''])
參數:
* **$code**?(int) -- HTTP Reponse status code
* **$text**?(string) -- A custom message to set with the status code
返回類型:
void
用于手動設置服務器的 HTTP 狀態碼,譬如:
~~~
set_status_header(401);
// Sets the header as: Unauthorized
~~~
[查看這里](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html)?有一份狀態碼的完整清單。
>[info] ### remove_invisible_characters($str[,?$url_encoded = TRUE])
參數:
* **$str**?(string) -- Input string
* **$url_encoded**?(bool) -- Whether to remove URL-encoded characters as well
返回:
Sanitized string
返回類型:
string
這個函數防止在 ASCII 字符串中插入空字符,例如:Java\0script 。
舉例:
~~~
remove_invisible_characters('Java\\0script');
// Returns: 'Javascript'
~~~
>[info] ### html_escape($var)
參數:
* **$var**?(mixed) -- Variable to escape (string or array)
返回:
HTML escaped string(s)
返回類型:
mixed
這個函數類似于 PHP 原生的?htmlspecialchars()?函數,只是它除了可以接受字符串參數外,還可以接受數組參數。
它在防止 XSS 攻擊時很有用。
>[info] ### get_mimes()
返回: An associative array of file types
返回類型: array
這個函數返回?application/config/mimes.php?文件中定義的 MIME 數組的?**引用**?。
>[info] ### is_https()
返回: TRUE if currently using HTTP-over-SSL, FALSE if not
返回類型: bool
該函數在使用 HTTPS 安全連接時返回 TRUE ,沒有使用 HTTPS(包括非 HTTP 的請求)則返回 FALSE 。
>[info] ### is_cli()
返回: TRUE if currently running under CLI, FALSE otherwise
返回類型: bool
當程序在命令行下運行時返回 TRUE ,反之返回 FALSE 。
> 注解
> 該函數會檢查?PHP_SAPI?的值是否是 'cli' ,或者是否定義了?STDIN?常量。
>[info] ### function_usable($function_name)
參數:
* **$function_name**?(string) -- Function name
返回:
TRUE if the function can be used, FALSE if not
返回類型:
bool
檢查一個函數是否可用,可用返回 TRUE ,否則返回 FALSE 。
該函數直接調用?function_exists()?函數,并檢查當前是否加載了?Suhosin 擴展 ?,如果加載了 Suhosin ,檢查函數有沒有被它禁用。
這個函數在你需要檢查某些函數的可用性時非常有用,例如?eval()?和?exec()?函數是非常危險的,可能會由于服務器的安全策略被禁用。
> 注解
> 之所以引入這個函數,是由于 Suhosin 的某個 bug 可能會終止腳本的執行, 雖然這個 bug 已經被修復了(版本 0.9.34),但可惜的是還沒發布。
- 歡迎使用 CodeIgniter
- 安裝說明
- 下載 CodeIgniter
- 安裝說明
- 從老版本升級
- 疑難解答
- CodeIgniter 概覽
- CodeIgniter 將從這里開始
- CodeIgniter 是什么?
- 支持特性
- 應用程序流程圖
- 模型-視圖-控制器
- 設計與架構目標
- 教程 - 內容提要
- 加載靜態內容
- 讀取新聞條目
- 創建新聞條目
- 結束語
- 常規主題
- CodeIgniter URL
- 控制器
- 保留名稱
- 視圖
- 模型
- 輔助函數
- 使用 CodeIgniter 類庫
- 創建類庫
- 使用 CodeIgniter 驅動器
- 創建驅動器
- 創建核心系統類
- 創建附屬類
- 鉤子 - 擴展框架核心
- 自動加載資源
- 公共函數
- 兼容性函數
- URI 路由
- 錯誤處理
- 網頁緩存
- 程序分析
- 以 CLI 方式運行
- 管理你的應用程序
- 處理多環境
- 在視圖文件中使用 PHP 替代語法
- 安全
- PHP 開發規范
- 類庫參考
- 基準測試類
- 緩存驅動器
- 日歷類
- 購物車類
- 配置類
- Email 類
- 加密類
- 加密類(新版)
- 文件上傳類
- 表單驗證類
- FTP 類
- 圖像處理類
- 輸入類
- Javascript 類
- 語言類
- 加載器類
- 遷移類
- 輸出類
- 分頁類
- 模板解析類
- 安全類
- Session 類
- HTML 表格類
- 引用通告類
- 排版類
- 單元測試類
- URI 類
- 用戶代理類
- XML-RPC 與 XML-RPC 服務器類
- Zip 編碼類
- 數據庫參考
- 數據庫快速入門: 示例代碼
- 數據庫配置
- 連接你的數據庫
- 查詢
- 生成查詢結果
- 查詢輔助函數
- 查詢構造器類
- 事務
- 數據庫元數據
- 自定義函數調用
- 數據庫緩存類
- 數據庫工廠類
- 數據庫工具類
- 數據庫驅動器參考
- 輔助函數參考
- 數組輔助函數
- 驗證碼輔助函數
- Cookie 輔助函數
- 日期輔助函數
- 目錄輔助函數
- 下載輔助函數
- 郵件輔助函數
- 文件輔助函數
- 表單輔助函數
- HTML 輔助函數
- 語言輔助函數
- Inflector 輔助函數
- 數字輔助函數
- 路徑輔助函數
- 安全輔助函數
- 表情輔助函數
- 字符串輔助函數
- 文本輔助函數
- 排版輔助函數
- URL 輔助函數
- XML 輔助函數
- 向 CodeIgniter 貢獻你的力量