Za méně křiku v kódu

Tradice používání velkých písmen pro konstanty pochází z jazyka C, kde se takto označovaly tzv. makrokonstanty preprocesoru. Bylo užitečné nepřehlédnutelně odlišit kód pro parser od kódu pro preprocesor. PHP tohle odlišení nepotřebuje jelikož preprocesor nemá. Naopak přílišné zvýraznění konstant je kontraproduktivní. Proč by měla konstanta křičet a upozorňovat na sebe, být vyčnívajícím elementem v toku programu? Není k tomu důvod.

Příklad reálného kódu s SCREAMING_SNAKE_CASE konstantami, které agresivně vyčnívají z kódu a také se hůře čtou:

foreach (self::SYMBOL_TO_NAME as $symbol => $name) {
	$idx = self::ACTION_BASE[$state] + $symbol;
	if (($idx >= 0 && $idx < count(self::ACTION) && self::ACTION_CHECK[$idx] === $symbol
			|| $state < self::YY_2_TBLSTATE
			&& ($idx = self::ACTION_BASE[$state + self::NUM_NON_LEAF_STATES] + $symbol) >= 0
			&& $idx < count(self::ACTION) && self::ACTION_CHECK[$idx] === $symbol)
		&& self::ACTION[$idx] !== self::UNEXPECTED_TOKEN_RULE
		&& self::ACTION[$idx] !== self::DEFAULT_ACTION
		&& $symbol === 0
	) {
		return true;
	}
}

Příklad téhož kódu s PascalCase konstantami, který působí mnohem kompaktněji:

foreach (self::SymbolToName as $symbol => $name) {
	$idx = self::ActionBase[$state] + $symbol;
	if (($idx >= 0 && $idx < count(self::Action) && self::ActionCheck[$idx] === $symbol
			|| $state < self::Yy2Tblstate
			&& ($idx = self::ActionBase[$state + self::NumNonLeafStates] + $symbol) >= 0
			&& $idx < count(self::Action) && self::ActionCheck[$idx] === $symbol)
		&& self::Action[$idx] !== self::UnexpectedTokenRule
		&& self::Action[$idx] !== self::DefaultAction
		&& $symbol === 0
	) {
		return true;
	}
}

Kompatibilita

Nette samozřejmě dbá na zpětnou kompatibilitu. Všechny veřejné konstanty nadále zůstávají také v původní podobě a slouží jako aliasy pro preferované PascalCase konstanty. Budou existovat i v příští major verzi a budou mít příznak @deprecated.

Všechny nově přidané konstanty tříd už jsou pouze ve variantě PascalCase. Globální konstanty Nette nepoužívá.

Enumerations

PHP 8.1 přináší výčtové typy, které se budou jednou používat i v Nette. Dříve se enumy napodobovaly pomocí konstant. Samotná dokumentace PHP pro „enum cases“ používá PascalCase notaci, taktéž PHP-FIG nebo dřívější experimentální implementace SplEnum.

Výčty jsou v podstatě syntactic sugar pro konstanty, z pohledu PHP není mezi „enum case“ a třídní konstantou žádný rozdíl. A proto kombinovaní PascalCase enumů a SCREAMING_SNAKE_CASE konstant by vypadalo nekonzistentně, což je dalším důvodem pro změnu stylu zápisu konstant.

Jak změnit vlastní kód?

Každá kosmetická změna vyvolá vždy spoustu nevole. Ale pokud zkusíte měsíc PascalCase konstanty používat, budete z nich nadšeni a nebude cesty zpět. A budete chtít zavést novou notaci i do vlastního kódu. Jak na to? Ideální cestou je přejmenovat konstanty v PhpStormu pomocí funkce Refactor > Rename . Nainstalujte si také plugin String Manipulation a přidělte mu v nastavení klávesovou zkratku pro Switch Case > To Pascal Case.

Pak bude stačit umístit kurzor na konstantu, stisknout Ctrl-F6 (rename) a následně zkratku pro To Pascal Case a PhpStorm změní konstantu v celém projektu.

Happy coding!