PHP Sabitler: define() ile const ve Sihirli Sabitler

Sabit, betik çalışırken hiç değişmeyen bir değere verilen addır. const MAX_USERS = 100; veya define('MAX_USERS', 100); ile tanımlayın, sonra $ olmadan yalın adını kullanın.

<?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";

Gelenek olarak sabit adları UPPER_SNAKE_CASE ile yazılır. Sabitler globaldir: bir dosyanın başında tanımlanan bir sabit, global olmadan her fonksiyonun içinde görünür.

define() ile const

İkisi de bir sabit oluşturur, ama farklı zamanlarda çalışırlar. const, PHP dosyayı derlerken çözümlenir; define() ise diğer fonksiyon çağrıları gibi çalışır.

<?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";

Varsayılan olarak const kullanın, çünkü daha kısadır ve derleme zamanında kontrol edilir. Sabit bir koşula veya hesaplanan bir ada bağlı olduğunda define() kullanın.

Sabitler değiştirilemez

Bir sabite atama yapmak bir ayrıştırma hatasıdır:

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

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

Aynı sabiti iki kez tanımlamak bir hata değildir, ama PHP bir uyarı yazdırır ve ilk değeri korur:

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

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

Bir değer zaten atanmış olabiliyorsa (örneğin birden fazla kez yüklenen bir yapılandırma dosyasında), önce defined() ile kontrol edin:

<?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";

Sabit diziler

Bir sabit bir dizi tutabilir. Onu NAME[key] ile okuyabilir, üzerinde döngü kurabilir ve bir yerden bir yere geçirebilirsiniz, ama değiştiremezsiniz.

<?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";
}

Sınıf sabitleri

Bir sınıfın içinde const, sınıfa ait bir sabit tanımlar. Dışarıdan ClassName::NAME, içeriden self::NAME veya static::NAME ile okuyun. Sınıf sabitlerinin görünürlüğü olabilir, final olabilirler ve PHP 8.3'ten beri bir tür bildirebilirler.

<?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 ve STATUS_PAID gibi birbiriyle ilişkili sınıf sabitlerinden oluşan bir grup çoğu zaman bir enum olarak daha iyi yazılır; enum geçersiz değerlerin dolaşmasını da engeller.

Sihirli sabitler: LINE, FILE, DIR ve dahası

Sihirli sabitlerin değeri göründükleri yere göre değişir. Derleme zamanında doldurulurlar.

<?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";

En çok kullanılanı, mevcut dosyanın dizini olan __DIR__ sabitidir. include yollarını ondan oluşturmak, betik hangi dizinden başlatılırsa başlatılsın onların çalışmasını sağlar: require __DIR__ . '/config.php';. Kalıbın tamamı için include ve require sayfasına bakın.

Bilinmesi gereken yerleşik sabitler

PHP'nin kendi tanımladığı birçok sabit vardır. Bunlar sürekli karşınıza çıkar:

<?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'nin çalıştığı sistemin satır sonudur (Linux ve macOS'ta "\n", Windows'ta "\r\n"). Dosyalara ve terminale yazılan metin içindir; HTML çıktısında yeni satır görünmez, bu yüzden orada <br> kullanın.