ini_get

funkcja

Zwraca bieżącą wartość dyrektywy php.ini jako string. Zwraca false, gdy dyrektywa nie istnieje.

ini_get(string $option): string|false

ini_get odczytuje wartość dowolnej dyrektywy konfiguracyjnej PHP — tej samej, którą można ustawić w php.ini, .htaccess lub przez ini_set. Wartość jest zawsze zwracana jako string, nawet jeśli dyrektywa przechowuje liczbę lub bool. Jeśli podana dyrektywa nie istnieje, funkcja zwraca false.

<?php
declare(strict_types=1);

var_dump(ini_get('display_errors'));     // string(1) "1"  lub  string(1) "0"
var_dump(ini_get('max_execution_time')); // string(2) "30"
var_dump(ini_get('date.timezone'));      // string(3) "UTC"  (lub inna strefa)

// Dyrektywa nie istnieje
var_dump(ini_get('nieistniejaca'));      // bool(false)

Uwagi dotyczące interpretacji wartości:

  • Wartości boolowskie: "1" = true, "" (pusty string) = false — PHP nie zwraca "true" ani "false".
  • Wartości z sufiksem rozmiaru (np. "128M") trzeba ręcznie przeliczać na bajty; ini_get zwraca string z sufiksem tak jak jest.
<?php
declare(strict_types=1);

// Sprawdź, czy wyświetlanie błędów jest włączone
if (ini_get('display_errors') === '1') {
    echo 'Tryb deweloperski: błędy są widoczne.';
} else {
    echo 'Tryb produkcyjny: błędy są ukryte.';
}

Do zmiany wartości w czasie działania skryptu używaj ini_set. Aby zobaczyć wszystkie dostępne dyrektywy, wywołaj phpinfo() lub ini_get_all().

📘 Naucz się w lekcji →