PHP 상수: define()과 const 차이, 매직 상수

상수는 스크립트가 실행되는 동안 절대 바뀌지 않는 값에 붙인 이름입니다. const MAX_USERS = 100;이나 define('MAX_USERS', 100);로 선언하고, $ 없이 이름만으로 사용합니다.

<?php
const SITE_NAME = "Coffee Corner";
define("MAX_ITEMS", 5);

echo SITE_NAME, "\n";
echo "You can order up to " . MAX_ITEMS . " items\n";

$price = 3.5;
const TAX_RATE = 0.2;
echo "Total: ", $price * (1 + TAX_RATE), "\n";

관례상 상수 이름은 UPPER_SNAKE_CASE입니다. 상수는 전역이므로, 파일 맨 위에서 선언한 상수는 global 없이 모든 함수 안에서 보입니다.

define()과 const

둘 다 상수를 만들지만 동작 시점이 다릅니다. const는 PHP가 파일을 컴파일할 때 처리되고, define()은 다른 함수 호출처럼 실행됩니다.

<?php
// const accepts expressions made of literals and other constants
const SECONDS_PER_DAY = 24 * 60 * 60;
const GREETING = "Hello, " . "world";

// define() can run conditionally and take a computed name
$env = "dev";
if ($env === "dev") {
    define("DEBUG", true);
}
foreach (["RED" => "#f00", "GREEN" => "#0f0"] as $name => $hex) {
    define("COLOR_" . $name, $hex);
}

echo SECONDS_PER_DAY, "\n";
echo GREETING, "\n";
var_dump(DEBUG);
echo COLOR_GREEN, "\n";

더 짧고 컴파일 시점에 확인되므로 기본으로는 const를 쓰세요. 상수가 조건이나 계산된 이름에 따라 달라질 때는 define()을 쓰세요.

상수는 바꿀 수 없다

상수에 대입하면 구문 에러입니다.

<?php
const LIMIT = 10;
LIMIT = 20;

PHP Parse error:  syntax error, unexpected token "=" in /home/index.php on line 3

같은 상수를 두 번 정의하는 것은 에러가 아니지만, PHP는 경고를 출력하고 첫 번째 값을 유지합니다.

<?php
define("LIMIT", 10);
define("LIMIT", 20);
echo LIMIT; // 10

Warning: Constant LIMIT already defined in /home/index.php on line 3

값이 이미 설정되었을 수 있다면(예: 여러 번 로드되는 설정 파일) 먼저 defined()로 확인하세요.

<?php
if (!defined("APP_ENV")) {
    define("APP_ENV", "production");
}
if (!defined("APP_ENV")) {
    define("APP_ENV", "testing");   // skipped
}
echo APP_ENV, "\n";

var_dump(defined("APP_ENV"));
var_dump(defined("NOT_THERE"));

// Read a constant whose name is in a string
$name = "APP_ENV";
echo constant($name), "\n";

상수 배열

상수에 배열을 담을 수 있습니다. NAME[key]로 읽고, 반복하고, 전달할 수 있지만 수정할 수는 없습니다.

<?php
const WEEKDAYS = ["Mon", "Tue", "Wed", "Thu", "Fri"];
define("HTTP_CODES", [200 => "OK", 404 => "Not Found", 500 => "Server Error"]);

echo WEEKDAYS[0], "\n";
echo count(WEEKDAYS), " weekdays\n";
echo HTTP_CODES[404], "\n";

foreach (HTTP_CODES as $code => $text) {
    echo "$code $text\n";
}

클래스 상수

클래스 안에서 const는 클래스에 속한 상수를 선언합니다. 밖에서는 ClassName::NAME으로, 안에서는 self::NAME이나 static::NAME으로 읽습니다. 클래스 상수는 가시성을 가질 수 있고, final일 수 있으며, PHP 8.3부터는 타입을 선언할 수 있습니다.

<?php
class Order
{
    public const STATUS_NEW = "new";
    public const STATUS_PAID = "paid";
    private const MAX_LINES = 50;
    final public const string CURRENCY = "EUR";   // typed, PHP 8.3

    public function __construct(public string $status = self::STATUS_NEW) {}

    public function canAddLine(int $lines): bool
    {
        return $lines < self::MAX_LINES;
    }
}

$order = new Order();
echo $order->status, "\n";
echo Order::STATUS_PAID, "\n";
echo Order::CURRENCY, "\n";
var_dump($order->canAddLine(10));

// Dynamic access by name
$which = "STATUS_PAID";
echo constant("Order::$which"), "\n";

STATUS_NEW, STATUS_PAID처럼 관련된 클래스 상수 묶음은 enum으로 쓰는 편이 나은 경우가 많습니다. enum은 잘못된 값이 전달되는 것도 막아 줍니다.

매직 상수: LINE, FILE, DIR 등

매직 상수는 나타나는 위치에 따라 값이 바뀝니다. 컴파일 시점에 채워집니다.

<?php
namespace App\Billing;

class Invoice
{
    public function describe(): string
    {
        return "class: " . __CLASS__ . "\n"
            . "method: " . __METHOD__ . "\n"
            . "function: " . __FUNCTION__ . "\n";
    }
}

echo (new Invoice())->describe();
echo "namespace: ", __NAMESPACE__, "\n";
echo "line: ", __LINE__, "\n";
echo "file: ", basename(__FILE__), "\n";
echo "dir is a directory: ", var_export(is_dir(__DIR__), true), "\n";

가장 많이 쓰는 것은 현재 파일의 디렉터리인 __DIR__입니다. 이것으로 include 경로를 만들면 스크립트를 어느 디렉터리에서 시작했든 동작합니다: require __DIR__ . '/config.php';. 전체 패턴은 include와 require를 보세요.

알아 두면 좋은 내장 상수

PHP는 자체 상수를 많이 정의합니다. 다음은 늘 등장하는 것들입니다.

<?php
echo "PHP_VERSION:   ", PHP_VERSION, "\n";
echo "PHP_INT_MAX:   ", PHP_INT_MAX, "\n";
echo "PHP_INT_SIZE:  ", PHP_INT_SIZE, " bytes\n";
echo "PHP_FLOAT_EPSILON: ", PHP_FLOAT_EPSILON, "\n";
echo "M_PI:          ", M_PI, "\n";
echo "PHP_OS_FAMILY: ", PHP_OS_FAMILY, "\n";
echo "E_ALL:         ", E_ALL, "\n";
echo "PHP_EOL is a newline: ", var_export(PHP_EOL === "\n", true), PHP_EOL;

PHP_EOL은 PHP가 실행되는 시스템의 줄 끝 문자입니다(Linux와 macOS는 "\n", Windows는 "\r\n"). 파일과 터미널에 쓰는 텍스트용이며, HTML 출력에서는 줄바꿈이 보이지 않으므로 <br>을 쓰세요.