Variáveis em PHP: declarar, escopo, global e static

Uma variável PHP é um nome que começa com $, e você a cria atribuindo um valor: $name = "Ada";. Não há palavra-chave de declaração nem tipo para informar, porque o valor decide o tipo. Você pode atribuir um valor de outro tipo depois.

<?php
$name = "Ada";
$age = 36;
$height = 1.65;
$isAdmin = true;

echo "$name is $age years old\n";

$age = $age + 1;           // update the value
$age++;                    // add one more
echo "Two birthdays later: $age\n";

$age = "thirty-eight";     // the type can change too
echo "Now a string: $age\n";

Regras para nomes de variáveis

Um nome de variável começa com $, depois uma letra ou underscore, depois quaisquer letras, dígitos ou underscores. Letras fora do ASCII contam como letras, então $名前 é válido, embora nomes ASCII sejam o padrão. Os nomes diferenciam maiúsculas de minúsculas.

Então $city, $City e $CITY são três variáveis diferentes. Use snake_case ($first_name) ou camelCase ($firstName), e mantenha um estilo por projeto. Os padrões de código PSR deixam o nome de variáveis em aberto de propósito; código Laravel e Symfony usa principalmente camelCase.

Usar variáveis em strings

Dentro de aspas duplas, o PHP troca as variáveis pelos valores; dentro de aspas simples, não. Coloque a variável entre chaves quando letras vierem logo em seguida ou quando você acessar um elemento de array por uma chave string:

<?php
$fruit = "apple";
$basket = ["count" => 4];

echo "I like $fruit pie\n";
echo 'I like $fruit pie' . "\n";              // single quotes: printed as written
echo "Two {$fruit}s please\n";                // braces separate the name
echo "There are {$basket['count']} left\n";   // array key inside a string
echo "Joined: " . $fruit . " and pear\n";     // concatenation with .

A página sobre strings explica aspas, concatenação e interpolação em detalhe.

Variáveis indefinidas e valores padrão

Ler uma variável que nunca recebeu valor dá null, e o seu PHP imprime um aviso:

Warning: Undefined variable $discount in /home/index.php on line 3

Verifique antes com isset, ou use o operador de coalescência nula ?? para fornecer um padrão. Os dois rodam sem aviso:

<?php
$price = 50;

$discount = $discount ?? 0;    // use 0 when $discount is not set
echo "Price: " . ($price - $discount) . "\n";

if (isset($coupon)) {
    echo "Coupon: $coupon\n";
} else {
    echo "No coupon given\n";
}

$coupon = null;
var_dump(isset($coupon));      // a variable holding null counts as not set

$x ??= 0; é a forma curta de $x = $x ?? 0;. Valores de formulário e de URL são o caso comum: $page = $_GET['page'] ?? 1;.

Escopo de variáveis em funções

Variáveis definidas fora de uma função não são visíveis dentro dela, e variáveis criadas dentro de uma função somem quando ela retorna. Essa é a surpresa mais comum para quem vem do JavaScript:

<?php
$taxRate = 0.2;

function priceWithTax($price)
{
    // $taxRate does not exist here, so ?? falls back to 0
    return $price * (1 + ($taxRate ?? 0));
}

function priceWithTaxFixed($price, $rate)
{
    return $price * (1 + $rate);   // pass what the function needs
}

echo priceWithTax(100), "\n";
echo priceWithTaxFixed(100, $taxRate), "\n";

Sem o ?? 0, a primeira função avisaria sobre um $taxRate indefinido. Passar valores como parâmetros deixa as funções previsíveis e fáceis de testar, e é o que você deve usar primeiro. A página sobre funções explica parâmetros e valores de retorno.

A palavra-chave global e $GLOBALS

Quando uma função realmente precisa usar uma variável global, declare-a com global, ou use o array $GLOBALS, que guarda todas as variáveis globais pelo nome:

<?php
$visits = 0;
$siteName = "Bakery";

function countVisit()
{
    global $visits;      // now $visits refers to the global variable
    $visits++;
}

function title()
{
    return "Welcome to " . $GLOBALS['siteName'];
}

countVisit();
countVisit();
echo "Visits: $visits\n";
echo title(), "\n";

Globais deixam o código mais difícil de acompanhar, porque qualquer função pode alterá-las. Elas aparecem em código antigo e em plugins WordPress (global $wpdb;); em código novo, passe os valores ou use uma classe.

Variáveis static mantêm o valor

Uma variável static dentro de uma função é criada uma vez e mantém o valor entre as chamadas. Ela continua local: o código fora da função não a enxerga.

<?php
function nextTicket(): int
{
    static $number = 100;   // runs only on the first call
    $number++;
    return $number;
}

echo nextTicket(), "\n";
echo nextTicket(), "\n";
echo nextTicket(), "\n";

function expensiveLookup(string $key): string
{
    static $cache = [];
    if (!isset($cache[$key])) {
        echo "(computing $key) ";
        $cache[$key] = strtoupper($key);
    }
    return $cache[$key];
}

echo expensiveLookup("php"), "\n";
echo expensiveLookup("php"), "\n";   // second call uses the cache

Variáveis variáveis ($$name)

$$name usa o valor de $name como nome de outra variável. Funciona, mas arrays quase sempre fazem o mesmo trabalho com mais clareza:

<?php
$field = "color";
$$field = "blue";        // creates $color
echo $color, "\n";

// The clearer way to have names chosen at runtime:
$settings = [];
$settings[$field] = "blue";
echo $settings["color"], "\n";

Cópia ou referência

Atribuir uma variável a outra copia o valor, arrays inclusive. Coloque & na frente para que os dois nomes apontem para o mesmo valor:

<?php
$a = [1, 2, 3];
$b = $a;          // copy
$b[] = 4;
echo "a has " . count($a) . ", b has " . count($b) . "\n";

$c = &$a;         // reference: $c and $a are the same array
$c[] = 99;
echo "a has " . count($a) . " after changing c\n";

function addBonus(int &$points)
{
    $points += 10;
}
$score = 5;
addBonus($score);
echo "Score: $score\n";

unset($b);
var_dump(isset($b));

Objetos se comportam de outro jeito: atribuir um objeto copia um handle para o mesmo objeto, então mudanças feitas por qualquer uma das variáveis aparecem nas duas. Use clone para uma cópia de verdade.

Erro comum: uma variável definida dentro de um if ou de um loop

O PHP não tem escopo de bloco, então uma variável criada dentro de if, for ou foreach continua existindo depois. Isso ajuda, mas esconde um bug: quando o bloco não roda, a variável nunca foi criada.

<?php
$orders = [];   // try [120, 80] here

$message = "No orders yet";   // set a default before the loop
foreach ($orders as $amount) {
    $message = "Last order: $amount";
}
echo $message, "\n";

foreach ([1, 2, 3] as $n) {
    $last = $n;
}
echo "Still visible after the loop: $last\n";

Sem a linha do valor padrão, um $orders vazio deixaria $message indefinida e imprimiria um aviso. Dê um valor a toda variável antes do bloco que pode defini-la.