Como explicar a alguém que há erros semânticos no seu…

Os erros semânticos estão relacionados com o facto de o código estar formalmente correto (sem erros sintáticos), mas a sua execução não se comportar como esperado ou planeado. Isto pode ser um erro lógico, uso incorreto da API, incompatibilidade de tipos de dados, erros de lógica de negócio, etc.

Exemplos de erros semânticos em PHP:

Lógica incorreta na condição:

// Supõe-se que se o número for menor que 0 OU maior que 100, haverá um erro.
// Mas devido a um erro na lógica, a condição nunca será verdadeira.
if ($number < 0 && $number > 100) {
    echo "Erro: número fora do intervalo.";
}

Uso de uma variável antes de sua inicialização (embora o PHP possa convertê-la silenciosamente para null/0):

// $uninitialized_var_before não foi declarada
$sum = $uninitialized_var_before + 10; // Pode levar a resultados inesperados
echo $sum;

Incompatibilidade de tipos em operações:

// Comparar strings e números pode levar a resultados inesperados
$str = "10php";
$num = 10;
if ($str == $num) { // O operador == realiza conversão de tipos
    echo "São iguais (inesperadamente).";
}

Uso incorreto de funções da API:

// Supõe-se que se apaga um ficheiro, mas a função recebe o caminho do ficheiro, não o objeto
$file_object = new SplFileInfo('/path/to/file.txt');
unlink($file_object); // Erro: unlink espera uma string, não um SplFileInfo

Erros lógicos em algoritmos:

// Erro num ciclo ou cálculos, levando a um resultado incorreto
$total = 0;
for ($i = 0; $i <= 10; $i++) {
    $total += $i; // Isto é a soma de 0 a 10
}
// Se pretendia somar apenas os números de 1 a 10, há um erro semântico.

A correção de erros semânticos requer compreensão do comportamento pretendido do código, testes exaustivos, depuração (usando depuradores, logs, var_dump) e análise da lógica de negócio.

Como explicar a alguém que há erros semânticos no seu código?