define

(PHP 4, PHP 5, PHP 7)

define名前を指定して定数を定義する

説明

define ( string $name , mixed $value [, bool $case_insensitive = false ] ) : bool

実行時に、名前を指定して定数を定義します。

パラメータ

name

定数の名前。

value

定数の値。PHP 5 では、value は スカラー値 (integerfloatstringboolean あるいは NULL) でなければいけません。PHP 7 では配列を使うこともできます。

警告

リソース型の定数を定義することもできますが、 推奨できません。予期せぬ振る舞いをする可能性があります。

case_insensitive

TRUE を指定すると、定数は大文字小文字を区別しないようになります。 デフォルトでは大文字小文字を区別します。つまり CONSTANTConstant は別の値を表すわけです。

注意:

大文字小文字を区別しないときは、定数は小文字で格納されます。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

変更履歴

バージョン 説明
7.0.0 array が使えるようになりました。

例1 定数の定義

<?php
define
("CONSTANT""Hello world.");
echo 
CONSTANT// "Hello world." を出力します
echo Constant// "Constant" を出力し、警告が発生します

define("GREETING""Hello you."true);
echo 
GREETING// "Hello you." を出力します
echo Greeting// "Hello you." を出力します

// PHP 7 以降で動作します
define('ANIMALS', array(
    
'dog',
    
'cat',
    
'bird'
));
echo 
ANIMALS[1]; // "cat" を出力します

?>

参考

  • defined() - 指定した名前の定数が存在するかどうかを調べる
  • constant() - 定数の値を返す
  • 定数の節