Variable Scope

Variáveis criadas dentro de uma função são completamente separadas de variáveis fora dela. Esse conceito é chamado de escopo de variável, e compreendê-lo previne bugs confusos em seu código.

Uma variável definida dentro de uma função só existe dentro dessa função. Ela é chamada de variável local:

<?php
function sayHi() {
    $message = "Hello!";
    echo $message;
}

sayHi();
echo $message; // Erro: $message não existe aqui
?>

A variável $message é criada dentro de sayHi() e desaparece quando a função termina. Tentar acessá-la fora causa um erro.

Da mesma forma, variáveis definidas fora de uma função não estão automaticamente disponíveis dentro dela:

<?php
$name = "Alice";

function greet() {
    echo $name; // Error: $name is not defined inside this function
}

greet();
?>

Mesmo que $name exista no código principal, a função não pode vê-lo. Para usar valores externos em uma função, passe-os como parâmetros—essa é a abordagem limpa e recomendada que você já aprendeu.

Essa separação é na verdade útil. Isso significa que as funções não alterarão acidentalmente variáveis em outras partes do seu programa, tornando seu código mais previsível e mais fácil de depurar.