Funkce
Kdy se closure (anonymní funkce) píše jako arrow funkce, kdy dostane static a kdy se
true a false předají jménem parametru, rozhoduje sekce functions. Rozhoduje
i o zbytečném return na konci funkce, o výchozí hodnotě parametru, kterou PHP nikdy nepoužije, a o funkci
deklarované uvnitř jiné funkce.
Zápis signatury a závorek patří jiným sekcím: mezera za function a fn sekci spacing, složená závorka closure sekci braces, typy parametrů sekci types.
functions:
arrowFunction:
oneExpression: required
trailingBareReturn: forbidden
unreachableParameterDefault: forbidden
$names = array_map(function ($user) { // The closure returning a single expression must be written as an arrow function.
return $user->name;
}, $users);
function writeLog(string $message, $level = 'info', $context) // Useless default value of `$level`, because a required parameter follows.
{
echo $message;
return; // Useless return, because the function ends right after it.
}
$names = array_map(fn($user) => $user->name, $users);
function writeLog(string $message, $level, $context)
{
echo $message;
}
Closure se na arrow funkci přepíše jen tam, kde je to totéž: nezachytává proměnnou referencí, nesahá na proměnnou, kterou nejmenuje, a neztratí se žádný komentář.
functions.innerFunction
A named function declared inside a function, a method, a closure or a property hook, which is only reported.
forbidden: never therekeep: nic se nevynucuje, kód zůstane, jak je
Výchozí keep · standardy: perCs keep, psr12 keep, nette
forbidden, symfony keep, laravel keep ·
pokrývá Squiz.PHP.InnerFunctions
functions.trailingBareReturn
return; as the last statement.
forbidden: never therekeep: nic se nevynucuje, kód zůstane, jak je
Výchozí keep · standardy: perCs keep, psr12 keep, nette
forbidden, symfony forbidden, laravel forbidden ·
pokrývá no_useless_return
functions.unreachableParameterDefault
A default a required parameter after it makes unreachable.
forbidden: never therekeep: nic se nevynucuje, kód zůstane, jak je
Výchozí keep · standardy: perCs keep, psr12 keep, nette
forbidden, symfony keep, laravel forbidden · pokrývá
no_unreachable_default_argument_value,
PEAR.Functions.ValidDefaultValue, SlevomatCodingStandard.Functions.UselessParameterDefaultValue
functions.arrowFunction.oneExpression
An arrow function written for a closure whose body is a single return, where that is equivalent: no variable
captured by reference, none reached by a name it does not spell out, no comment lost.
Not about the static of the arrow function, which functions.staticClosure decides.
required: always therekeep: nic se nevynucuje, kód zůstane, jak je
Výchozí keep · PHP 7.4 · standardy: perCs keep, psr12 keep,
nette required, symfony keep, laravel keep · pokrývá
use_arrow_functions, SlevomatCodingStandard.Functions.RequireArrowFunction
functions.arrowFunction.emptyBody
fn() => null written for a closure with an empty body, one returning void, never or
by reference aside.
required: always therekeep: nic se nevynucuje, kód zůstane, jak je
Výchozí keep · PHP 7.4 · standardy: perCs required, psr12
keep, nette keep, symfony required, laravel keep
functions.arrowFunctionNested
Whether a closure holding another closure or arrow function becomes one too.
yes, nebono
Výchozí no · PHP 7.4 · standardy: perCs no, psr12 no, nette
yes, symfony no, laravel no ·
pokrývá SlevomatCodingStandard.Functions.RequireArrowFunction
functions.staticClosure
The static keyword of a closure or an arrow function that does not use $this.
required: always there,static functionkeep: nic se nevynucuje, kód zůstane, jak je
Výchozí keep · standardy: perCs keep, psr12 keep, nette
keep, symfony keep, laravel keep · pokrývá
static_lambda, SlevomatCodingStandard.Functions.StaticClosure
Oprava je riziková (risky fix): closure se dá k objektu přivázat i jinde, přes bindTo() nebo
Closure::bind(), a to z jednoho souboru vidět není. Udělá se, až rozhodnutí uvedete v klíči fixRisky.
functions.namedBooleanArgument
A true or false passed by position to a parameter declared bool, written with the name
of the parameter, json_decode($json, associative: true); not where a positional argument follows it, nor in a call of
a setter, setVisible(true), or of a function PHP calls without a frame or optimizes.
required: always therekeep: nic se nevynucuje, kód zůstane, jak je
Výchozí keep · PHP 8.0 · standardy: perCs keep, psr12 keep,
nette keep, symfony keep, laravel keep
Pojmenovaný argument říká, co true nebo false přepíná, aniž by čtenář hledal signaturu.
DressCode pojmenuje jen argumenty na konci volání, za kterými už nestojí žádný poziční, protože PHP poziční argument
za pojmenovaným nepřijme. Setter jako setVisible(true) to říká už svým jménem, takže zůstane, jak je.
Zůstanou i funkce, které PHP volá bez rámce zásobníku nebo je optimalizuje kompilátor, třeba in_array():
pojmenovaný argument by jim optimalizaci vzal. Další funkce a metody vyjmenujete v
functions.namedBooleanArgumentExcept.
Jména parametrů funkcí PHP zná DressCode sám. U metod, new a funkcí vašeho projektu potřebuje typy kódu, bez nich taková volání nechá být.
functions:
namedBooleanArgument: required
namedBooleanArgumentExcept: [print_r]
$data = json_decode($json, true); // The boolean argument of `json_decode()` must be named `associative`.
$html = htmlspecialchars($text, ENT_QUOTES, 'UTF-8', false); // The boolean argument of `htmlspecialchars()` must be named `double_encode`.
echo print_r($data, true);
$data = json_decode($json, associative: true);
$html = htmlspecialchars($text, ENT_QUOTES, 'UTF-8', double_encode: false);
echo print_r($data, true);
Oprava je riziková (risky fix) u volání metody, kterou může potomek přepsat, třeba $this->render(true)
ve třídě, která není finální, nebo volání přes rozhraní: potomek může parametr pojmenovat jinak a volání by pak
skončilo chybou. Volání metody private nebo final, metody finální třídy, přes
self:: a parent:: a new rizikové nejsou. Rizikové opravy se udělají, až rozhodnutí
uvedete v klíči fixRisky.
functions.namedBooleanArgumentExcept
The functions and methods whose arguments stay positional, a method written with the class declaring it or the one it is called
on, Acme\Shop\Cart::add.
- seznam jmen
Výchozí [] · PHP 8.0 · standardy: perCs [], psr12 [], nette
[], symfony [], laravel []