¿Qué convención de codificación seguir para PHP?

Question

¿Debo seguir con las convenciones del código Java de Sun para el código PHP?

Answer 1

Para PHP, sugeriría seguir Zends suggestions

Como se puede saber, Zend is the most widely used framework!

Answer 2

Si usted está en un negocio seguir la convención de código de negocio.

Si se trata de un proyecto personal, puede obtener la especificación del idioma específico (si hace Java que Java, si hace PHP que PHP). Si es su proyecto personal, puede cambiar algunas cosas si lo desea ...

Si hace un proyecto de código abierto, debería ir a ver lo que ya está en su lugar.

Answer 3

Existen muchas convenciones de codificación diferentes. Eche un vistazo a lo que otras personas usan (lea un código de ejemplo y vea qué fácil es entender lo que se está haciendo) y haga su elección.

La parte importante es elegir una y atenerse a ella.

Answer 4

usted tiene un número de opciones:

Zend: http://framework.zend.com/manual/en/coding-standard.html

Pera: http://pear.php.net/manual/en/standards.php

Wordpress: http://codex.wordpress.org/WordPress_Coding_Standards

Pero como sugiere Prakash, Zend es una buena opción.

Answer 5

Actualización: personas también utilizan hoy en día una gran cantidad PSR

---

normas Framework Zend y pera son más o menos las convenciones de codificación más comunes. Si su empresa adoptó otra, siga la convención de su compañía. Mejor que no tener ninguna convención en absoluto. Y solo funcionan si todos se apegan a ellos.

Véase también:

• Which Coding convention to follow for PHP?
• PHP best practices for naming conventions
• PHP coding conventions?

Básicamente, todos los principales marcos tienen una convención de codificación en algún lugar de su documentación. El oficial (pero sobre todo desconocidos OMI) Pautas de codificación de PHP se pueden encontrar en

• http://news.php.net/php.standards/2

Si necesita validar el código contra una convención de codificación, considere el uso de CodeSniffer. Algunos IDE también ofrecen formato de código fuente automático por plantillas. Por ejemplo, Zend Studio tiene incorporadas las pautas de codificación de ZF, por lo que basta con un clic para formatear el código según esa convención.

Answer 6

Como dice Gordon, los estándares Zend y PEAR son el estándar de la industria efectiva.

Sin embargo, es posible que el código de la compañía sea anterior a estos, por lo que dependiendo del tamaño de la base de códigos, puede ser poco útil invertir el tiempo necesario para pasar a uno de estos. (Dicho esto, si alguna vez quieren utilizar herramientas de análisis de código estático, podrían usar esto como un impulso para considerar seriamente mudarse a Zend, etc.)

Sin embargo, siendo realistas, siempre y cuando tengan un estándar razonable que se adhieren a que no hay un problema real aquí: te encontrarás ajustando cómo "ves" el código en consecuencia.

Answer 7

Los estilos de codificación varían de un grupo a otro y no es el mismo para todos los gustos. Lo más importante es tener un estándar que se siga de manera consistente y no exagerar. Demasiadas reglas pueden ser tan malas como no suficientes.

Yo solía preferir el estilo K & R (el segundo). Después de tener que ajustarme al estilo Allman (su preferencia), ahora siento que hace que el código sea más legible y ha cambiado mi preferencia.

Este Wikipedia article es un buen lugar para comenzar. También incluye un enlace a los Estándares de codificación PEAR, entre otros.

Answer 8

Existen ventajas y desventajas para cualquier estilo de codificación. Paso mucho tiempo trabajando con código de muchas fuentes haciendo integraciones, a veces termino viendo muchos estilos diferentes en un solo día (diferentes convenciones de nomenclatura, colocación de llaves, pestañas, espacios, etc.)

Por lo que a mí respecta - Lo más importante si está trabajando con un código existente es seguir el estilo del código que está editando. Si no lo haces, harás las cosas más difíciles para cualquiera que te siga.

Si está escribiendo un código nuevo, debe tener libertad para hacerlo de la manera que lo haga más eficiente.

me parece que la compañía Reglas de codificación son a menudo muy detallado y terminan en el olvido después de algunos años y un poco de rotación en el equipo de software ;-)

Answer 9

Debe estar siguiendo uno de los estándares para PSR PHP aprobado por el Framework Interop Group

• PSR-0 - Tiene como objetivo proporcionar un archivo, la clase y espacio de nombres convención estándar ..
• PSR-1 - tiene por objeto garantizar un alto nivel de interoperabilidad técnica entre el código PHP compartido.
• PSR-2 - Proporciona una Guía de estilo de codificación para proyectos que buscan estandarizar su código.
• PSR-3 - Describe una interfaz común para el registro de bibliotecas; el LoggerInterface expone ocho métodos para escribir registros en los ocho niveles RFC 5424.
• PSR-4 - Describe una especificación para las clases de carga automática desde rutas de archivos. Es totalmente interoperable y se puede utilizar además de cualquier otra especificación de carga automática, incluido PSR-0.