czwartek, 2020-12-03

Stałe predefiniowane w języku PHP

Predefiniowane stałe są tworzone bez ingerencji użytkownika przed wykonaniem skryptu. Część z nich jest ustawiana przez różne dołączone rozszerzenia. Mogą zależeć od środowiska uruchomieniowego, np. od systemu operacyjnego. W materiale zaprezentowano jedynie niewielką część stałych dostępnych w każdym środowisku niezależnie od rozszerzeń. Znajdziesz tutaj także przykłady wykorzystania wybranych stałych.

Wybrane stałe definiowane przez rdzeń PHP

Nazwa stałej	Opis	Przykładowa wartość
PHP_VERSION	oznaczenie wersji PHP	7.0.33
PHP_MAJOR_VERSION	główne oznaczenie wersji	7
PHP_MINOR_VERSION	pomocniczy numer wersji	0
PHP_RELEASE_VERSION	wersja wydania	33
PHP_VERSION_ID	wersja w postaci liczby przydatna do programowych porównań wersji	70033
PHP_OS	nazwa systemu operacyjnego, na którym uruchomione jest PHP	Linux
PHP_CONFIG_FILE_PATH	lokalizacja pliku konfiguracji	/etc/php/7.0/apache2
PHP_MAXPATHLEN	maksymalna długość nazwy pliku (łącznie ze ścieżką)	4096
PHP_INT_MAX	największa liczba całkowita obsługiwana w danej wersji PHP	2147483647
PHP_INT_MIN	najmniejsza liczba całkowita obsługiwana w danej wersji PHP	-2147483648
PHP_INT_SIZE	rozmiar liczby całkowitej w bajtach	4

Przykładowy kod wyświetla pełną informację o wersji PHP.

echo PHP_VERSION;

Wybrane stałe związane ze środowiskiem

Nazwa stałej	Opis	Przykładowa wartość
DIRECTORY_SEPARATOR	seperator w ścieżkach dostępu do plików	/
PATH_SEPARATOR	separator ścieżek w dyrektywach konfiguracyjnych	:
PHP_EOL	znak końca linii w danym systemie	\n

W przykładzie dla bieżącego skryptu dodano nową ścieżkę do listy katalogów, w których PHP poszukuje plików dołączonych np. za pomocą instrukcji include.

$path = '/var/www/app';
set_include_path(get_include_path() . PATH_SEPARATOR . $path);

Stałe związane z błędami

Wartość stałej	Nazwa stałej	Opis
1	E_ERROR	Błędy krytyczne w czasie wykonania, wykonanie skryptu zostaje zatrzymane.
2	E_WARNING	Ostrzeżenia w czasie wykonywania, wykonanie skryptu nie zostaje zatrzymane.
4	E_PARSE	Błędy analizy w czasie kompilacji.
8	E_NOTICE	Powiadomienia w czasie wykonywania.
16	E_CORE_ERROR	Generowane przez rdzeń PHP błędy krytyczne.
32	E_CORE_WARNING	Generowane przez rdzeń PHP ostrzeżenia
64	E_COMPILE_ERROR	Błędy krytyczne w czasie kompilacji.
128	E_COMPILE_WARNING	Ostrzeżenia w czasie kompilacji.
256	E_USER_ERROR	Komunikat o błędzie wygenerowany przez użytkownika za pomocą funkcji trigger_error().
512	E_USER_WARNING	Komunikat ostrzegawczy wygenerowany przez użytkownika za pomocą funkcji trigger_error().
1024	E_USER_NOTICE	Wiadomość z powiadomieniem wygenerowana przez użytkownika za pomocą funkcji trigger_error().
2048	E_STRICT	Włącz, aby PHP sugerowało zmiany w kodzie, które zapewnią kompatybilność w przód.
4096	E_RECOVERABLE_ERROR	Wykrywalny błąd krytyczny.
8192	E_DEPRECATED	Ostrzeżenia o kodzie, który nie będzie działał w przyszłych wersjach.
16384	E_USER_DEPRECATED	Komunikat ostrzegawczy wygenerowany przez użytkownika za pomocą funkcji trigger_error().
32767	E_ALL	Wszystkie obsługiwane błędy i ostrzeżenia.

W przykładowym wywołaniu funkcji error_reporting() dla bieżącego skryptu ustawiono poziom raportowania błędów uwzględniający wszystkie błędy (E_ALL) z wyjątkiem powiadomień w czasie wykonywania (E_NOTICE).

error_reporting(E_ALL & ~E_NOTICE);