Volver al Tutoriales de PHP

TUTORIAL: Cómo mantener la fuente limpia

  • Bogey
  • Bogey
  • Genius
  • Avatar de Usuario
  • Registrado: Jul 14, 2005
  • Mensajes: 8211
  • Loc: USA
  • Status: Offline

Nota Agosto 11th, 2009, 7:42 pm

Introducción


Aunque no lo parezca, pero la fuente es importante para los programadores, por lo que la forma en que usted escribe un programa y cómo organizar el código...asuntos. Este tutorial va a cubrir a todas las personas que tengan un conocimiento básico de PHP.

La Fuente


Hay un par de características importantes de un buen programa debe tener...una característica importante y fundamental es que el programa realmente funciona de la manera en que se supone que es. La segunda característica importante de un buen programa es la manera en que se escribe y cómo se organiza la fuente.

¿Por qué? Así que sería fácil para los programadores a leer la fuente y seguir la lógica de la secuencia de comandos. Si llaves correspondientes están alineados, bucles anidados con sangría y variables, funciones y clases se denominan correctamente, sería una brisa actualización o re-factoring código para los programadores...especialmente para los que está editando un guión que no escribió.

Un limpio y bien organizado de origen también es bueno para el cliente, ya que pueden encontrar un programador que sería capaz de modificarlo.

Ahora, ¿qué es lo que considero un limpio y bien organizado de origen? Es mejor explicarlo con un ejemplo:
PHP Código: [ Select ]
<?php
function addition()
{
    // Getting array of passed arguments
    $args = func_get_args();
   
    // Initiating the return value
    $return = 0;
   
    // Looping through every argument and doing the code
    foreach ($args as $key => $number)
    {
        // Making sure we aren't working with an array (Associative Arrays are not allowed)
        if (is_numeric($number))
        {
            $return += $number;
        }
    }
   
    return $return;
}
?>
  1. <?php
  2. function addition()
  3. {
  4.     // Getting array of passed arguments
  5.     $args = func_get_args();
  6.    
  7.     // Initiating the return value
  8.     $return = 0;
  9.    
  10.     // Looping through every argument and doing the code
  11.     foreach ($args as $key => $number)
  12.     {
  13.         // Making sure we aren't working with an array (Associative Arrays are not allowed)
  14.         if (is_numeric($number))
  15.         {
  16.             $return += $number;
  17.         }
  18.     }
  19.    
  20.     return $return;
  21. }
  22. ?>

Me gustaría señalar a su atención en las características de la fuente que lo hacen bien organizada y limpia.
  • Correspondientes llaves (apertura y cierre para el caso de las declaraciones y el bucle) están en la línea vertical
  • El SI está anidado dentro del bucle, de modo que se sangra un poco más desde el margen
  • Las llaves para abrir las declaraciones y los bucles son un espacio después de la declaración / decleration bucle ( if () ).
  • La fuente se mantiene limpio mediante el uso de Operadores de asignación ($ return + = $ number; en lugar de $ return = return $ + $ numero;)
  • La fuente también comentó a dejar que otros programadores saben lo que están haciendo.
  • Su no es la codificación adicional para hacer que el script de tomar un tiempo largo

Sí, que el código podría ser fácilmente modificado para ser de cuatro líneas más pequeñas...Let me show you:
PHP Código: [ Select ]
<?php
function addition()
{
    // Getting array of passed arguments
    $args = func_get_args();
   
    // Initiating the return value
    $return = 0;
   
    // Looping through every argument and doing the code
    foreach ($args as $key => $number)
        // Making sure we aren't working with an array (Associative Arrays are not allowed)
        if (is_numeric($number))
            $return += $number;
   
    return $return;
}
?>
  1. <?php
  2. function addition()
  3. {
  4.     // Getting array of passed arguments
  5.     $args = func_get_args();
  6.    
  7.     // Initiating the return value
  8.     $return = 0;
  9.    
  10.     // Looping through every argument and doing the code
  11.     foreach ($args as $key => $number)
  12.         // Making sure we aren't working with an array (Associative Arrays are not allowed)
  13.         if (is_numeric($number))
  14.             $return += $number;
  15.    
  16.     return $return;
  17. }
  18. ?>

Lo que ocurrió allí es que me quita las llaves del bucle y la si declaración. Usted puede hacer que si el bucle tiene una sola línea de código y si la sentencia condicional sólo tiene una línea siguiente después de que, de lo contrario tendrá las llaves.

A pesar de que puede hacerlo y es más fácil para la gente más perezosos a hacerlo de esa manera, realmente no se recomienda que, dado que se rompe la lógica del código. (Yo soy culpable de ser perezoso aunque este...Soy nadie para juzgar gif "alt =": lol: "title =" Laughing "> )

La razón de que yo no recomiendo esto es porque se rompe la lógica del código (como ya he mencionado). Las llaves se supone que diga cuando la declaración de si se inicia y termina, y también sería más fácil para otros programadores, si las llaves ya están allí, si necesita agregar más líneas a la condición o el bucle.

Conclusión


Así pues, en conclusión se puede ver que mi primer ejemplo es más correcto (en el sentido de la organización de origen), entonces el segundo ejemplo, aunque es de cuatro líneas más. A veces la longitud del código no determina cómo está organizada la fuente..., en este caso, se dice realmente lo vagos que la persona está :lol:
"Bring forth therefore fruits meet for repentance:" Matthew 3:8
  • Anonymous
  • Bot
  • No Avatar
  • Registrado: 25 Feb 2008
  • Mensajes: ?
  • Loc: Ozzuland
  • Status: Online

Nota Agosto 11th, 2009, 7:42 pm

Página 1 de 1

Publicar Información

  • Total de mensajes en este tema: 1 mensaje
  • Moderador: Tutorial Writers
  • Usuarios navegando por este Foro: No hay usuarios registrados visitando el Foro y 1 invitado
  • No puede abrir nuevos temas en este Foro
  • No puede responder a temas en este Foro
  • No puede editar sus mensajes en este Foro
  • No puede borrar sus mensajes en este Foro
  • No puede enviar adjuntos en este Foro
 
 

© 2011 Unmelted, LLC. Ozzu® es una marca registrada de Unmelted, LLC