Introduction

¿Alguna vez te has encontrado con un comprobador de estilo quejándose de que una línea es demasiado larga, aunque pareciera razonable? Esta guía aclara las directrices de longitud de línea de PSR-2, abordando específicamente la distinción entre límites rígidos y blandos. Aprenderás cuáles son estos límites, cómo impactan el formato automático de código y entenderás por qué tu código podría ser marcado a pesar de parecer visualmente aceptable. Desmitificaremos los matices de las recomendaciones de PSR-2 para un código más limpio y legible.

Normas de longitud de línea PSR-2

## PSR-2 y la longitud de las líneas

El estilo de codificación PSR-2 define pautas de longitud de línea para código PHP, pero las reglas pueden ser confusas. El estándar establece dos límites de longitud de línea: un máximo preferido de 80 caracteres y un límite "suave" de 120 caracteres. Las líneas de hasta 80 caracteres se consideran ideales y siempre aceptables.

El "límite suave" de 120 caracteres significa que las herramientas automatizadas como los linters y los IDEs deben emitir una advertencia si una línea excede esta longitud. Sin embargo, estas herramientas no deben tratar de exceder los 120 caracteres como un error que impida la ejecución del código. La intención es fomentar la legibilidad al tiempo que se permite excepciones ocasionales donde dividir una línea sería perjudicial.

Esencialmente, priorice mantener las líneas por debajo de los 80 caracteres siempre que sea posible. Si una línea excede los 80 pero permanece por debajo de los 120, generalmente es aceptable, pero tenga en cuenta la legibilidad. Las líneas que superan los 120 caracteres requieren atención y una advertencia de herramientas automatizadas.

<?php

/**
 * Function to calculate the sum of two numbers.
 *
 * @param int $a First number.
 * @param int $b Second number.
 * @return int Sum of the two numbers.
 */
function addNumbers(int $a, int $b): int {
    return $a + $b;
}

// Example usage
$result = addNumbers(5, 3);
echo "The sum is: " . $result;

?>

Interpretando Límites Blandos vs. Duros

## REGLAS CRÍTICAS

PSR-2 define dos directrices de longitud de línea para código PHP, diferenciadas por su severidad para los analizadores de estilo automatizados. El "límite suave" de 120 caracteres actúa como una sugerencia. Se instruye a los analizadores de estilo para que emitan advertencias cuando las líneas excedan este límite, pero no deben reportarlas como errores que detengan el proceso.

El "límite duro" no existe en PSR-2. Idealmente, las líneas deberían permanecer por debajo de 80 caracteres, particularmente al dividir líneas largas en múltiples líneas subsiguientes. Esto promueve la legibilidad y la mantenibilidad.

Esencialmente, esfuércese por mantener líneas de menos de 80 caracteres, aunque líneas ocasionales de hasta 120 son permisibles, generando solo una advertencia de herramientas automatizadas. La clave es que las directivas "DEBE" y "DEBE" se aplican a los verificadores de estilo automatizados, no a las acciones de codificación directas del programador.

<?php
/**
 * Function to interpret soft vs hard limits.
 *
 * @param int $softLimit Soft limit value.
 * @param int $hardLimit Hard limit value.
 * @return string Interpretation of the limits.
 */
function interpretLimits($softLimit, $hardLimit) {
    // Check if inputs are valid integers
    if (!is_int($softLimit) || !is_int($hardLimit)) {
        return "Error: Both soft and hard limits must be integers.";
    }

    // Compare soft and hard limits
    if ($softLimit > $hardLimit) {
        return "Soft limit exceeds hard limit. Please adjust.";
    } elseif ($softLimit == $hardLimit) {
        return "Soft and hard limits are equal.";
    } else {
        return "Soft limit is within the acceptable range of the hard limit.";
    }
}

// Example usage
$soft = 10;
$hard = 20;

$result = interpretLimits($soft, $hard);
echo $result; // Output: Soft limit is within the acceptable range of the hard limit.
?>

Implicaciones prácticas para desarrolladores

## Directrices de estilo PSR-2

Las directrices de estilo PSR-2 establecen recomendaciones de longitud de línea para código PHP, pero la distinción entre límites "suaves" y "duros" puede ser confusa. El estándar dicta un límite suave de 120 caracteres y un máximo preferido de 80 caracteres. Estos límites conciernen principalmente a los verificadores de estilo automatizados, no al desarrollador directamente.

El límite "suave" de 120 caracteres significa que excederlo no desencadenará un error de las herramientas automatizadas. En cambio, estas herramientas deben emitir una advertencia, indicando un posible problema de legibilidad. Las líneas que excedan los 80 caracteres deberían idealmente dividirse en múltiples líneas para mantener la claridad del código.

Esencialmente, los desarrolladores deberían esforzarse por mantener las líneas por debajo de los 80 caracteres siempre que sea práctico. Las líneas ligeramente más largas son aceptables, pero las herramientas automatizadas las marcarán como una advertencia, lo que motivará la consideración de refactorización para una mejor legibilidad.

<?php
// Function to fetch user data from a database
function getUserData($userId) {
    // Database connection parameters
    $host = 'localhost';
    $dbname = 'example_db';
    $username = 'root';
    $password = '';

    try {
        // Create a new PDO instance
        $pdo = new PDO("mysql:host=$host;dbname=$dbname", $username, $password);
        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

        // Prepare the SQL query to fetch user data
        $sql = "SELECT * FROM users WHERE id = :userId";
        $stmt = $pdo->prepare($sql);

        // Bind the parameter and execute the query
        $stmt->bindParam(':userId', $userId);
        $stmt->execute();

        // Fetch the result as an associative array
        $userData = $stmt->fetch(PDO::FETCH_ASSOC);

        if ($userData) {
            return $userData;
        } else {
            throw new Exception("User not found");
        }
    } catch (PDOException $e) {
        // Handle database connection or query errors
        echo "Database error: " . $e->getMessage();
        return null;
    }
}

// Example usage
$userId = 1;
$userData = getUserData($userId);

if ($userData) {
    echo "User ID: " . $userData['id'] . "<br>";
    echo "Username: " . $userData['username'] . "<br>";
} else {
    echo "Failed to retrieve user data.";
}
?>

Conclusion

En última instancia, las directrices de PSR-2 sobre la longitud de las líneas, particularmente el límite “suave” de 80 caracteres, priorizan la legibilidad y la colaboración. Si bien no se aplican estrictamente, adherirse a este estándar promueve un código más limpio y facilita los procesos de revisión. Comprender la distinción entre límites suaves y duros permite a los desarrolladores tomar decisiones informadas sobre el formato del código, equilibrando las necesidades del proyecto con las convenciones establecidas.