Lenguaje y Normas de Desarrollo: Difference between revisions

* Cuando varias variables deben ser inicializadas con el mismo valor, utilize múltiples líneas

$var1=1;$var2=1;$var3=1;

en lugar de

$var1=$var2=$var3=1;

que es menos eficiente.

* las cadenas deben de ser encuadradas con comillas simples y las variables sacadas de la cadena.

print 'Mi texo muestra mi '.$variable.' !';

* Los comentarios deben seguir la sintaxis de C, es decir, una doble barra invertida para una línea de comentario y el uso de una barra con arterisco para abrir un bloque de varias líneas

/* Bloque de comentarios

  *

}

* Los ficheros deben ser guardados en formato Unix (LF) y no en formato Windows (CR/LF). El formato Unix es compatible con los SO Unix, Windows, Mac, mientras que el formato de archivo de texto de Windows es problemático en algunos PHP en Unix.

* ¡Los SELECT * están prohibidos! Cada Select deberá especificar la lista completa de los campos para recuperar. Esto permitirá evitar confusiones. Ejemplo:

SELECT field_a, field_b, field_c FROM table_1 WHERE field_d = '$id'

* En las consultas SQL, entrecomillaremos los campos, pero no los numéricos que contengan cantidades que se almacenen en los campos de tipo double o real. Los entrecomillados en los numéricos de tipo float se almacenan con un valor diferente. Por ejemplo 412.62 dentro del insert se guardara con el valor 412.61999512 en base si el campo es de tipo double(24,8). Y PHP sólo ve 412.61999512. Otras herramientas verán 412.62 dando la impresión de que no hay problemas. Y PHP tiene razón, hay un problema en base. Mediante la eliminación de las comillas en los numéricos, esto irá  mejor.

Ejemplo:

Bien:INSERT INTO table_1 (field_txt, field_num) VALUES ('txt', 412.62)

Mal: INSERT INTO table_1 (field_txt, field_num) VALUES ('txt', '412.62')

Nota, el problema de los float es general y no sólamete en el acceso a la base de datos, está presente en todos los lenguajes cuando trabajamos sobre números reales, por lo que deberán ser limpiados por la función price2num con el segundo parámetro rellenado con:

* Los enlaces href deben de ser absolutos. para las páginas, basarse en la constante DOL_URL_ROOT que apunta a htdocs, para las imágenes basarse en la llamada de la función img_picto.

Por ejemplo:

print '<a href="'.DOL_URL_ROOT.'/monrep/mapage.php">'.img_picto('Texte alt','nompictopng','').'</a>';

* Javascript y la llamada a scripts java en las páginas php está fuera de las normas. Si de todas maneras se incluye código javascript, debe estar condicionado mediante el test "$conf->use_javascript"

if ($conf->use_javascript)

{

...  // El código PHP que genera el javascript va aquí

}

* Las ventanas emergentes  no deben de ser utilizadas, exceptuando los tooltips (y quedan condicionados por el punto anterior).

Tanto en PHP como en otros lenguajes (Java, por ejemplo), los datos no enteros (float, real, double) no son fialbes.

Pruebe a realizar por ejemplo

print 239.2 - 229.3 - 9.9;

No obtendrá 0, sino un número muy pequeño en potencia 10 negativo . Si obtiene cero, puede encontrar otros ejemplos que no funcionan.

El problema de los float es general, una variable resultante del cálculo de números reales debe SISTEMATICAMENTE ser limpiada mediante la función price2num con el segundo parámetro rellenado con: 'MU', 'MT' ó 'MS' según el caso (ver doc de la función).

print price2num(239.2 - 229.3 - 9.9, 'MT');

Si no es un precio que se ajuste a los parámetros de MU, MT, MS debe utilizar la función '''round()'''.

DOL_DATA_ROOT.'/mimodulo'.

La carpeta puede crearse en desde su código mediante el código siguiente:

$mymoduledir=DOL_DATA_ROOT.'/mimodulo';

if (! is_dir($mymoduledir)) create_exdir($mymoduledir);

Si necesita una carpeta de datos temporales, esta carpeta deberá ser DOL_DATA_ROOT.'/minmodulo/temp'