# define

(PHP 4, PHP 5, PHP 7)

define — 定义一个常量

### 说明

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

在运行时定义一个常量。

### 参数

`name`

  常量名。

`value`

  常量的值；在 PHP 5 中，`value` 必须是标量( integer、 float、string、boolean、`NULL`）在 PHP 7 中还允许是个 array 的值。

  Warning

  常量还可以定义为 resource 类型，但并不推荐这样做，因为可能会有不可预知的行为发生。

`case_insensitive`

  如果设置为 `TRUE`，该常量则大小写不敏感。默认是大小写敏感的。比如， CONSTANT 和 Constant 代表了不同的值。

  > Note:

  > 大小写不敏感的常量以小写的方式储存。

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 更新日志

版本 | 说明
--- | ---
7.0.0 | 允许 array 的值。

### 范例

Example #1 定义常量

    <?php
    define("CONSTANT", "Hello world.");
    echo CONSTANT; // 输出 "Hello world."
    echo Constant; // 输出 "Constant" 并导致 Notice

    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() - 返回一个常量的值
- Constants这一节