共通関数

CodeIgniter はその動作のために少しの関数を使用しており、 それはグローバルに定義され、どこでも使えます。 ライブラリやヘルパーをロードする必要はありません。

is_php($version)
Parameters:
  • $version (string) – バージョン番号
Returns:

実行している PHP のバージョンが指定のもの以上なら TRUE 、そうでないなら FALSE

Return type:

bool

使用している PHP のバージョンが与えられたバージョン番号よりも 大きいかどうかを判定します。

Example:

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

インストールされている PHP のバージョンが与えられたバージョン番号と 等しいかそれ以上なら真偽値の TRUE を返します。インストールされている PHP のバージョンが与えられたバージョン番号よりも低い場合には FALSE を返します。

is_really_writable($file)
Parameters:
  • $file (string) – ファイルパス
Returns:

パスが書き込み可能な場合は TRUE 、そうでない場合は FALSE

Return type:

bool

is_writable() は Windows サーバー上で TRUE を返し、 OS のレポートとして PHP に読み取り専用属性がマークされていて 本当に書き込めない場合にのみ FALSE を返します。

この関数は最初に実際にファイルに書き込もうとすることによって、 書き込み可能であるかどうかを判定します。一般的に、 情報を信頼できないプラットフォーム上でのみおすすめします。

例:

if (is_really_writable('file.txt'))
{
        echo "書き込もうと思えば書き込めます";
}
else
{
        echo "ファイルは書き込めません";
}

Note

より詳しくは PHP のバグ #54709 も参照してください。

config_item($key)
Parameters:
  • $key (string) – 設定項目キー
Returns:

設定キーの値。見つからない場合はNULL

Return type:

mixed

設定ライブラリ は設定情報にアクセスするために推奨される方法ですが、 単一のキーを取得するためには config_item() を使用することもできます。詳細については 設定ライブラリ マニュアルを参照してください。

set_status_header($code[, $text = ''])
Parameters:
  • $code (int) – HTTP Reponse ステータスコード
  • $text (string) – ステータスコードを設定する際のカスタムメッセージ
Return type:

void

サーバステータスヘッダを手動で設定することを可能にします。例:

set_status_header(401);
// ヘッダを設定します:  Unauthorized

ヘッダの完全なリストについては ここを参照してください

remove_invisible_characters($str[, $url_encoded = TRUE])
Parameters:
  • $str (string) – 入力文字列
  • $url_encoded (bool) – URL エンコードされた文字を削除するかどうか
Returns:

サニタイズされた文字列

Return type:

string

この機能は、Java\0scriptのように、 ASCII 文字の間に NULL 文字を挿入しないようにします。

例:

remove_invisible_characters('Java\\0script');
// 返り値: 'Javascript'
html_escape($var)
Parameters:
  • $var (mixed) – エスケープする変数 (文字列または配列)
Returns:

HTML エスケープされた文字列 (または文字列の配列)

Return type:

mixed

この関数は PHP ネイティブの htmlspecialchars() 関数の別名として機能するほか、文字列の配列を処理できるという利点があります。

これはクロスサイトスクリプティング (XSS) の予防に有用です。

get_mimes()
Returns:ファイルタイプの連想配列
Return type:array

この関数は application/config/mimes.php から MIME の配列への 参照 を返します。

is_https()
Returns:現在 HTTP over SSL を使用している場合は TRUE 、そうでないなら FALSE
Return type:bool

セキュア接続 (HTTPS) を使用していれば TRUE を返し、他の場合には FALSE を返します (非 HTTP 要求を含みます) 。

is_cli()
Returns:現在 CLI で実行されている場合は TRUE 、そうでない場合は FALSE
Return type:bool

アプリケーションがコマンドラインから実行している場合は TRUE を返し、そうでないなら FALSE を返します。

Note

この関数は、 PHP_SAPI 値が「 cli 」であるかどうかと、 STDIN 定数が定義されているかどうかの両方をチェックします。

function_usable($function_name)
Parameters:
  • $function_name (string) – 関数名
Returns:

関数を使用することができる場合は TRUE 、そうでない場合は FALSE

Return type:

bool

関数が存在し使用可能であれば TRUE を、そうでなければ FALSE を返します。

この関数は function_exists() を確認し、また、 Suhosin extension <http://www.hardened-php.net/suhosin/> がロードされていれば 関数が無効化されていないかどうかをチェックします。

これは eval()exec() など、危険であり、制限の厳しいセキュリティポリシーを持つサーバ上で 無効にされうる関数の可用性をチェックする場合に便利です。

Note

Suhosinはスクリプトの実行を中断させますが、 これはバグであることが判明したため、この機能が導入されました。 修正プログラムはすでに用意されましたが (バージョン0.9.34) 、 残念ながらまだリリースされていません。