Sintaxis al utilizar PDO/PHP

[hhs]

Iniciado por bandolera

Por qué se recomienda utilizar la variable $stmt cuando se trabaja con PDO en PHP?
Es una convención? Recomendación? Buena práctica? Hay algún sustento?

En ningún lado se recomienda, pero se utiliza para darle claridad a los ejemplos.
Y la razón es muy simple:

Código PHP:

public PDOStatement PDO::prepare ( string $statement [, array $driver_options = array() ] )
 

Si observas prepare regresa un objeto PDOStatment, así que es lógico usar $stmt o $statement para que puedas entender el ejemplo.

Código PHP:

try {
  $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8", $username, $password);
  $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
 
  $stmt = $pdo->prepare('INSERT INTO someTable VALUES(:name)');
  $stmt->execute(array(
    ':name' => 'Justin Bieber'
  ));
 
  # Affected Rows?
  echo $stmt->rowCount(); // 1
} catch(PDOException $e) {
  echo 'Error: ' . $e->getMessage();
}
 

De hecho es una buena practica nombrar tus clases y variables de forma que se pueda entender el código al momento de leerlo.
Como ejemplo cual de los siguientes fragmentos de código se entiende mas?

Código PHP:

//get salary from employee
$sal = salary($usr); //code 1
 
$salary = getSalaryFrom($employe); // code 2
 

Creo que definitivamente el segundo código es mejor, se lee sin necesidad de un comentario. Es un ejemplo extremo pero resalta la importancia de usar nombres adecuados para tener código legible.