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

string strip_tags (9)

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

Hay muchas convenciones de codificación diferentes por ahí. 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.

Si está en un negocio, siga la convención del código de negocios.

Si se trata de un proyecto personal, puede obtener la especificación del lenguaje 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 lo hace proyecto de código abierto, debería ir a ver lo que ya está en su lugar.

Tienes un número de opciones:

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

Pear: 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.

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

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 para pasar a uno de estos. (Dicho esto, si alguna vez quieren usar 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 sensato al que se apeguen, no hay un problema real aquí: se encontrará ajustando la forma en que "ve" el código en consecuencia.

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

En lo que a mí respecta, lo más importante si estás trabajando con el código existente es seguir el estilo del código que estás 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 forma que lo haga más eficiente.

Encuentro que las pautas de codificación de la compañía a menudo son muy detalladas y terminan siendo olvidadas después de algunos años y un poco de abandono en el equipo de software ;-)

Debería seguir uno de los estándares de PSR para PHP aprobado por el Framework Interop Group

PSR-0 - Tiene como objetivo proporcionar un archivo estándar, clase y convención de espacio de nombres ..
PSR-1 : Tiene como objetivo garantizar un alto nivel de interoperabilidad técnica entre códigos PHP compartidos.
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; LoggerInterface expone ocho métodos para escribir registros en los ocho niveles de 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.

Los estilos de codificación varían de un grupo a otro y no es un tamaño único para todo tipo de cosas. 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.

Antes prefería 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 artículo de Wikipedia es un buen lugar para comenzar. También incluye un enlace a los Estándares de codificación PEAR, entre otros.

Para PHP, te sugiero que sigas las sugerencias de Zends

Como sabrá, ¡ Zend es el marco más utilizado!

Actualización: las personas también usan PSR hoy en día mucho

Zend Framework y los estándares PEAR son prácticamente 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.

Ver también:

Básicamente, todos los principales marcos tienen una convención de codificación en algún lugar de su documentación. Las Pautas de codificación PHP oficiales (pero en su mayoría desconocidas) 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 usar 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.