グローバル定数およびグローバル関数¶
CakePHPを使った皆さんの日常のほとんどの業務ではコアクラスやメソッドを用いることになるでしょうが、ちょっとした役に立つ便利なグローバル関数もCakePHPにはたくさんあります。 この関数のほとんどはCakePHPのクラスと一緒に使うためのもの（モデルやコンポーネントクラスのローディングなど）ですが、他の多くは、配列や文字列の扱いを少し楽にしてくれるものです。
また、CakePHP のアプリケーションで利用可能な定数も同時におさえておきましょう。 これらの定数を用いることはよりスムースなアップグレードの助けになるだけでなく、CakePHPアプリケーション内の特定のファイルやディレクトリを指し示す便利なやり方でもあります。
グローバル関数¶
以下、CakePHPの使用可能なグローバル関数です。 その多くは、デバッグしたり内容を翻訳したりといった、機能的に他の CakePHP の単なる便利なラッパーになっています。
- __(string $string_id[, $formatArgs])¶
この関数は CakePHP のアプリケーションでのローカライズを担います。 $string_id で翻訳時のIDを定めます。 翻訳のために指定される文字列は、sprintf() 関数でのフォーマット文字列としてあつかわれます。 その文字列内のプレースホルダーを置き換えるための、追加の引数を供給できます:
__('You have %s unread messages', $number);
ノート
より詳しい情報は /core-libraries/internationalization-and-localization のセクションを確認して下さい。
- __c(string $msg, integer $category, mixed $args = null)¶
カテゴリは定義済みの名前をそのまま使うのではなく、数値で指定されなければなりません。それらの値は以下の通り:
- 0 - LC_ALL
- 1 - LC_COLLATE
- 2 - LC_CTYPE
- 3 - LC_MONETARY
- 4 - LC_NUMERIC
- 5 - LC_TIME
- 6 - LC_MESSAGES
- __d(string $domain, string $msg, mixed $args = null)¶
メッセージを一つ取得するために、現在のドメインを変更することが可能です。
プラグインを国際化するときに便利です: echo __d('PluginName', 'This is my plugin');
- __dc(string $domain, string $msg, integer $category, mixed $args = null)¶
メッセージを一つ取得するために、現在のドメインを変更することが可能です。 同時に、カテゴリを指定することも出来ます。
カテゴリは定義済みの名前をそのまま使うのではなく、数値で指定されなければなりません。 それらの値は以下の通り:
- 0 - LC_ALL
- 1 - LC_COLLATE
- 2 - LC_CTYPE
- 3 - LC_MONETARY
- 4 - LC_NUMERIC
- 5 - LC_TIME
- 6 - LC_MESSAGES
- __dcn(string $domain, string $singular, string $plural, integer $count, integer $category, mixed $args = null)¶
複数形のメッセージを一つ取得するために、現在のドメインを変更することが可能です。 同時に、カテゴリを指定することも出来ます。 $domain でドメインを指定し、$count の数を数え、 $singular と $plural に基いて複数形を正しく処理したメッセージを返します。
カテゴリは定義済みの名前をそのまま使うのではなく、数値で指定されなければなりません。 それらの値は以下の通り:
- 0 - LC_ALL
- 1 - LC_COLLATE
- 2 - LC_CTYPE
- 3 - LC_MONETARY
- 4 - LC_NUMERIC
- 5 - LC_TIME
- 6 - LC_MESSAGES
- __dn(string $domain, string $singular, string $plural, integer $count, mixed $args = null)¶
複数形のメッセージを一つ取得するために、現在のドメインを変更することが可能です。 $domain でドメインを指定し、$count の数を数え、 $singular と $plural に基いて複数形を正しく処理したメッセージを返します。
- __n(string $singular, string $plural, integer $count, mixed $args = null)¶
$count の数を数え、 $singular と $plural に基いて複数形を正しく処理したメッセージを返します。 幾つかの言語が、数に応じた複数形の形式を一つ以上持っています。
- am(array $one, $two, $three...)¶
パラメータとして渡されてすべての配列をマージして、その結果の配列を返します。
- config()¶
アプリケーション内の config フォルダから include_once 経由でファイルをロードするために使用することが出来ます。 この関数はインクルードする前にファイルの存在チェックを行い、ブール値を返します。 任意の数の引数を取ります。
例: config('some_file', 'myconfig');
- convertSlash(string $string)¶
文字列のスラッシュをアンダースコアに変換し、最初と最後のアンダースコアを削除します。 変換した文字列を返します。
- debug(mixed $var, boolean $showHtml = null, $showFrom = true)¶
アプリケーションの DEBUG レベルがゼロ以外の場合に $var が出力されます。 $showHTML が true あるいは null のままであればデータはブラウザ表示に相応しいように描画されます。 $showFrom が false にセットされない場合、それがコールされた行の情報を伴ってデバグ情報の出力が始まります。 デバッグ も参照して下さい
- env(string $key)¶
可能な限りの環境変数を取得します。仮に $_SERVER か $_ENV が使用不可の場合にはバックアップとして用いられます。
この関数はまた、PHP_SELF と DOCUMENT_ROOT を、非サポートのサーバー上でエミュレートします。 これは完全なエミュレーションラッパーなので、$_SERVER や getenv() の代わりに env() を常に用いることは、 （とりわけあなたがコードを配布する予定なら）とても良い考えです。
- fileExistsInPath(string $file)¶
渡されたファイルが、現在の PHP include_path の中にあるかどうかをチェックします。 ブール値の結果を返します。
- h(string $text, boolean $double = true, string $charset = null)¶
htmlspecialchars() の便利なラッパー。
- LogError(string $message)¶
Log::write() へのショートカット。
- pluginSplit(string $name, boolean $dotAppend = false, string $plugin = null)¶
ドット記法されたプラグイン名をプラグインとクラス名に分離します。 $name にドットが含まれない場合、インデクスが 0 の箇所は null になります。
一般にこんな具合に使われます list($plugin, $name) = pluginSplit('Users.User');
- pr(mixed $var)¶
出力を <pre> タグでラップする機能を追加した print_r() の便利なラッパー。
- sortByKey(array &$array, string $sortby, string $order = 'asc', integer $type = SORT_NUMERIC)¶
与えられた $array を $sortby キーによってソートします。
- stripslashes_deep(array $value)¶
与えられた $value から、再帰的にスラッシュを取り除きます。 変換された配列を返します。
コア定義定数¶
以下のほとんどの定数はあなたのアプリケーション内部のパスへの参照です。
- constant APP¶
アプリケーションディレクトリへのパス。
- constant APP_DIR¶
あなたのアプリケーションのディレクトリ名。app かも知れません。
- constant APPLIBS¶
アプリケーションの Lib ディレクトリへのパス。
- constant CACHE¶
キャッシュファイルディレクトリへのパス。 複数サーバーをセットアップした際のホスト間で共有できます。
- constant CAKE¶
cake ディレクトリへのパス。
- constant CAKE_CORE_INCLUDE_PATH¶
ルートの lib ディレクトリへのパス。
- constant CORE_PATH¶
ルートディレクトリへの、末尾にディレクトリスラッシュを付加したパス。
- constant CSS¶
public CSS ディレクトリへのパス。
- constant CSS_URL¶
CSS ファイル・ディレクトリへの Webパス。
バージョン 2.4 で撤廃: 代わりに設定値の App.cssBaseUrl を使用して下さい。
- constant DS¶
PHP の DIRECTORY_SEPARATOR (Linux の場合は / windows の場合は \) のショートカット。
- constant FULL_BASE_URL¶
https://example.com のような完全なURLプリフィクス。
バージョン 2.4 で撤廃: この定数は廃止されたので、代わりに Router::fullbaseUrl() を使用する必要があります。
- constant IMAGES¶
画像の公開ディレクトリへのパス。
- constant IMAGES_URL¶
画像の公開ディレクトリへのWebパス。
バージョン 2.4 で撤廃: 代わりに設定値の App.imageBaseUrl を使用して下さい。
- constant JS¶
JavaScript の公開ディレクトリへのパス。
- constant JS_URL¶
JavaScript の公開ディレクトリへのWebパス。
バージョン 2.4 で撤廃: 代わりに設定値の App.jsBaseUrl を使用して下さい。
- constant LOGS¶
ログディレクトリへのパス。
- constant ROOT¶
ルートディレクトリへのパス。
- constant TESTS¶
テストディレクトリへのパス。
- constant TMP¶
一時ファイルディレクトリへのパス。
- constant VENDORS¶
ベンダーディレクトリへのパス。
- constant WEBROOT_DIR¶
あなたのウェブルートディレクトリの名前。webroot かも知れません。
- constant WWW_ROOT¶
ウェブルートへのフルパス。