Operadores PHP: aritméticos, lógicos, de string e mais

Um operador recebe um ou mais valores e produz um novo: $a + $b soma, $a . $b junta strings, $a && $b é um E lógico, $a === $b compara, $i++ incrementa.

<?php
$a = 17;
$b = 5;

echo "a + b  = ", $a + $b, "\n";
echo "a - b  = ", $a - $b, "\n";
echo "a * b  = ", $a * $b, "\n";
echo "a / b  = ", $a / $b, "\n";
echo "a % b  = ", $a % $b, "\n";
echo "a ** 2 = ", $a ** 2, "\n";
echo "intdiv = ", intdiv($a, $b), "\n";

/ retorna um float, a menos que dois inteiros se dividam exatamente: 17 / 5 é 3.4, 10 / 5 é o inteiro 2. Quando você quer só a parte inteira, use intdiv(). Arredondamento é explicado na página de matemática.

Operadores aritméticos

O módulo é útil para "a cada N itens" e para verificar par ou ímpar. O resultado tem o sinal do lado esquerdo, e dividir por zero lança um erro que você pode capturar:

<?php
for ($i = 1; $i <= 6; $i++) {
    echo $i, $i % 2 === 0 ? " even" : " odd", "\n";
}

var_dump(-7 % 3);
var_dump(fmod(7.5, 2));   // modulo for floats

try {
    echo 10 % 0;
} catch (DivisionByZeroError $e) {
    echo "Error: ", $e->getMessage(), "\n";
}

Operadores de atribuição

= guarda um valor. Cada operador aritmético e de string tem uma forma combinada que atualiza a variável no lugar.

<?php
$total = 100;
$total += 20;   // $total = $total + 20
$total -= 5;
$total *= 2;
$total /= 10;
$total **= 2;
echo $total, "\n";

$path = "/home";
$path .= "/docs";      // append a string
echo $path, "\n";

$name = null;
$name ??= "Guest";     // assign only if null or unset
echo $name, "\n";

??= faz parte da família do operador de coalescência nula. Ele só atribui quando a variável não está definida ou é null.

Incremento e decremento: ++ e --

$i++ retorna o valor atual e depois soma 1. ++$i soma 1 e depois retorna o novo valor. A diferença só aparece quando você usa o resultado na mesma expressão.

<?php
$i = 5;
echo $i++, "\n";  // prints 5, then $i becomes 6
echo $i, "\n";

$j = 5;
echo ++$j, "\n";  // $j becomes 6, prints 6

$k = 10;
$k--;
echo $k, "\n";

// ++ also works on letters
$col = "A";
$col++;
echo $col, "\n";
$col = "Z";
$col++;
echo $col, "\n";

O truque com letras é como muitas vezes se geram nomes de colunas de planilha (A, B, ... Z, AA).

Operadores lógicos: &&, ||, ! e xor

&& e || fazem curto-circuito: o lado direito não é avaliado quando o lado esquerdo já decide o resultado. É isso que torna isset($user) && $user->isAdmin() seguro.

<?php
$age = 20;
$hasTicket = true;

var_dump($age >= 18 && $hasTicket);
var_dump($age < 12 || $age > 65);
var_dump(!$hasTicket);
var_dump(true xor true);

function check(string $label): bool {
    echo "checked $label\n";
    return true;
}
false && check("A");   // never runs
true || check("B");    // never runs
true && check("C");    // runs

and ou &&: a armadilha da precedência

and e or têm ligação mais fraca que =, então numa atribuição eles são aplicados depois que o valor é guardado. Este é um bug clássico:

<?php
$x = true and false;   // read as: ($x = true) and false
var_dump($x);

$y = true && false;    // read as: $y = (true && false)
var_dump($y);

$z = (true and false); // parentheses fix it
var_dump($z);

A precedência baixa é útil num idioma, $file = fopen($path, 'r') or die('Cannot open');, em que você quer que a atribuição aconteça primeiro. Em todo o resto, use && e ||.

Operadores de string: . e .=

O PHP tem dois operadores de string: . junta duas strings ("Grace" . " " . "Hopper") e .= acrescenta a uma variável ($html .= "<li>"). + nunca junta strings: "3" + "4" é o número 7, enquanto "3" . "4" é a string "34". A página sobre strings explica interpolação e aspas.

Comparação e o operador spaceship <=>

== compara depois de converter os tipos, === também verifica o tipo, e <=> retorna -1, 0 ou 1, exatamente o que callbacks de ordenação precisam. Os detalhes e a tabela completa de comparação frouxa estão na página sobre operadores de comparação.

<?php
var_dump(1 <=> 2);
var_dump(2 <=> 2);
var_dump(3 <=> 2);

$prices = [30, 5, 120, 18];
usort($prices, fn($a, $b) => $a <=> $b);
echo implode(", ", $prices), "\n";

usort($prices, fn($a, $b) => $b <=> $a);   // descending
echo implode(", ", $prices), "\n";

Operadores de array

+ em arrays é uma união: as chaves do array da esquerda vencem e só as chaves ausentes são adicionadas a partir da direita. Isso surpreende quem espera que ele acrescente no fim. == verifica os mesmos pares chave/valor, === também exige a mesma ordem e os mesmos tipos.

<?php
print_r([1, 2] + [3, 4, 5]);
print_r(["a" => 1] + ["a" => 99, "b" => 2]);

var_dump(["a" => 1, "b" => 2] == ["b" => 2, "a" => 1]);
var_dump(["a" => 1, "b" => 2] === ["b" => 2, "a" => 1]);

Para acrescentar uma lista a outra, use array_merge() ou a sintaxe spread [...$a, ...$b].

Precedência de operadores

Quando uma expressão mistura operadores, o PHP os aplica numa ordem fixa. Os que mais confundem, com o que o PHP 8.3 imprime:

echo 2 + 3 * 4;        // 14: * before +
echo (2 + 3) * 4;      // 20
echo 2 ** 3 ** 2;      // 512: right to left, 2 ** 9
echo -2 ** 2;          // -4: ** before unary minus
echo "Sum: " . 2 + 3;  // Sum: 5, since PHP 8 + runs before .

Na dúvida, adicione parênteses. Eles não custam nada, e quem ler a linha depois não precisa lembrar da tabela.