diff --git a/appendices/userlandnaming.xml b/appendices/userlandnaming.xml index 2dbec6853..2b59af7ae 100644 --- a/appendices/userlandnaming.xml +++ b/appendices/userlandnaming.xml @@ -1,16 +1,15 @@ - - + Guía de entorno de usuario para nombres - + La siguiente es una guía para saber cómo elegir el mejor nombre para los identificadores del código del entorno del usuario PHP. Cuando se eligen nombres para cualquier código que crea símbolos en el espacio de nombres global, es importante tener en cuenta los siguientes lineamientos para evitar que en futuras versiones de PHP estos choquen con los símbolos elegidos. - +
Espacio de nombres global @@ -19,47 +18,53 @@ - funciones - clases - interfaces - constantes (no constanstes de clase) - variables definidas fuera de funciones/métodos + funciones + clases + interfaces + traits + enumeraciones + constantes (no constantes de clase) + + variables definidas fuera de funciones y métodos +
Reglas - + La siguiente lista muestra un resumen de los derechos que se reserva el proyecto PHP para sí mismo, cuando elige los nombres para los nuevos identificadores internos. La guía definitiva son los - ESTÁNDARES DE CODIFICACION oficiales: - + estándares de codificación de PHP oficiales: + - PHP es el propietario de el namespace de nivel superior, pero trata de - encontrar una descripción decente de nombres y evitar así futuros choques. + PHP es el propietario del espacio de nombres de nivel superior, pero trata de + encontrar nombres descriptivos correctos y de evitar cualquier choque evidente. - - Los nombres de función usan guion bajo entre palabras, mientras que los - nombres de las clases usan las reglas camelCase o PascalCase. - + + Los nombres de función usan guion bajo entre palabras, los nombres de las + clases usan la notación PascalCase, y los nombres de los + métodos la notación camelCase. + - + PHP antepondrá a cualquier símbolo global de una extensión el nombre de - de la extensión. (En el pasado, han habido numerosas excepciones a esta regla). + la extensión. (En el pasado ha habido numerosas excepciones a esta regla, + por lo que algunos nombres existentes no llevan prefijo). Ejemplos: - + - curl_close - mysql_query + curl_exec + mysqli_query PREG_SPLIT_DELIM_CAPTURE new DOMDocument() @@ -82,15 +87,19 @@ - - PHP se reserva todos los simbolos que comienzan con __ - como magicos. Es recomendado que no se creen simbolos que comiencen con - __ en PHP a menos que se quiera usar una funcionalidad - magica documentada. Ejemplos: - + + PHP se reserva todos los símbolos que comienzan con __ + como mágicos. Se recomienda que no se creen símbolos que comiencen con + __ en PHP, a menos que se quiera usar una funcionalidad + mágica documentada. Ejemplos: + - __get() - __autoload + + __get() + + + __construct() + @@ -98,12 +107,12 @@
Consejos - + Con el fin de escribir código que funcione en el futuro, se recomienda no colocar muchas variables, funciones o clases en el espacio de nombres global. Esto prevendrá de conflictos de nombres con código de terceros así como con posibles adiciones futuras al lenguaje. - + Una manera común de evitar conflictos con nombres de funciones y clases es añadirlos a su propio @@ -116,24 +125,27 @@ namespace MiProyecto; -function mi_función() { +function mi_función() +{ return true; } \MiProyecto\mi_función(); + +?> ]]> - - Esto todavía necesita que se mantenga la cuenta de los espacios de nombres ya utilizados, pero una vez - que se decido el espacio de nombres que se va a usar se pueden añadir todas las funciones y - clases e él sin tener que pensar más en conflictos. - - + + Todavía es necesario llevar la cuenta de los espacios de nombres ya utilizados, + pero una vez elegido el espacio de nombres se pueden añadir a él todas las + funciones y clases sin tener que pensar más en conflictos. + + Es una buena práctica limitar el número de variables añadidas al ámbito global para evitar conflictos de nombres con código de terceros. - + Ámbito de variables