Drupal es un Administrador de Contenido de Software Libre. En su desarrollo y mantenimiento participan diseñadores, programadores y colaboradores en general, de todas partes del mundo. Para poder lograr que todos los aportes se den en forma ordenada y minimizar los problemas cuando alguien debe tomar el proyecto de otro para corregirlo o mejorarlo, se ha definido ciertas buenas prácticas, que toda la comunidad de Drupal sigue con el fin de facilitar las cosas. Estas incluyen obviamente la forma en que se programa en PHP (el lenguaje sobre el cual está construido Drupal), pero también cómo se debe utilizar otras herramientas como jQuery, Bases de Datos, estilos (CSS), control de versiones, documentación, etc.

En este caso vamos a enfocarnos en algunas buenas prácticas que utiliza la comunidad de Drupal para programar en PHP, y que pueden resultar útiles para equipos de programación en general, que tengan que estar desarrollando, compartiendo, depurando y probando código entre ellos.

Comentarios

Una buena práctica es seguir el estándar de Doxygen para los comentarios.

Doxygen -acrónimo de dox(document) gen(generator)- es un generador de documentación para código fuente. En PHP, como en otros lenguajes de programación, los comentarios se ingresan dentro de las combinaciones de caracteres /* (para abrir el comentario) y */ (para cerrarlo) cuando el comentario abarca más de una línea, o bien con // para indicar que en el salto de línea termina el comentario.

No hay ninguna definición dentro de la sintaxis original de PHP que indique lo que el programador puede agregar dentro de un comentario, sin embargo al adherirse a los parámetros que define Doxygen, es posible utilizar luego toda la información que se ha añadido en estos comentarios como base para generar la documentación del programa que se está desarrollando.

Aún si no se va a utilizar Doxygen para generar una base de documentación, seguir las pautas que sugiere permite que los programadores mantengan consistencia en la manera que agregan comentarios a sus programas.

A continuación dos ejemplos de comentarios del código de Drupal, que muestran el uso de Doxigen:

// $Id: index.php,v 1.94 2007/12/26 08:46:48 dries Exp $
 
/**
 * @file
 * The PHP page that serves all page requests on a Drupal installation.
 *
 * The routines here dispatch control to the appropriate handler, which then
 * prints the appropriate page.
 *
 * All Drupal code is released under the GNU General Public License.
 * See COPYRIGHT.txt and LICENSE.txt.
 */

Para más detalles sobre Doxygen y se puede visitar el sitio web del autor, Dimitri van Heesch: http://www.stack.nl/~dimitri/doxygen/

Indentación

Casi todos los programadores entienden la importancia de indentar el código, y lo aplican relativamente bien. Sin embargo en Drupal se ha generalizado el uso de dos espacios como norma para las indentaciones. No se utiliza el Tabulador, pues la longitud de las tabulaciones puede diferir de editor en editor, y esto puede provocar que el código se vea desordenado.

Este es un ejemplo de código indentado a dos espacios:

function drupal_init_path() {
  if (!empty($_GET['q'])) {
    $_GET['q'] = drupal_get_normal_path(trim($_GET['q'], '/'));
  }
  else {
    $_GET['q'] = drupal_get_normal_path(variable_get('site_frontpage', 'node'));
  }
}

Separación

Se siguen ciertas pautas para separar los diferentes elementos en una línea de código; por ejemplo, dejando espacios antes y después de los operadores (” = “, ” != “, ” && “, ” => “, ” : “, etc), o luego de la coma (“, “) cuando se listan parámetros; e igualmente, luego de usar estructuras de control como if, else, foreach, switch, etc., y antes de abrir una llave de agrupación (” {“). A veces se acostumbra hacer una separación por medio de líneas vacías entre la declaración de la función y sus variables, el cuerpo, y el retorno.

Este es un ejemplo donde se puede ver el uso de espacios para mantener el orden:

function image_get_toolkit() {
  static $toolkit;
 
  if (!$toolkit) {
    $toolkit = variable_get('image_toolkit', 'gd');
    $toolkit_file = './includes/image.'. $toolkit .'.inc';
    if (isset($toolkit) && file_exists($toolkit_file)) {
      include_once $toolkit_file;
    }
    elseif (!image_gd_check_settings()) {
      $toolkit = FALSE;
    }
  }
 
  return $toolkit;
}

Agrupación

El uso de llaves es obligatorio para agrupar secciones de código que se ejecutan dentro de una estructura de control. La llave se abre en la misma línea donde se declara la condición, y se cierra luego de la última línea de código de ese bloque lógico. Aunque no es necesario utilizarlas en casos que incluyen únicamente una línea, se recomienda mantener la norma pues esta práctica produce código mucho más ordenado y fácil de leer.

Por ejemplo, la siguiente función

function db_field_names($fields) {
  $ret = array();
  foreach ($fields as $field) {
    if (is_array($field)) {
      $ret[] = $field[0];
    }
    else {
      $ret[] = $field;
    }
  }
  return $ret;
}

podría escribirse como

function db_field_names($fields) {
  $ret = array();
  foreach ($fields as $field)
    if (is_array($field)) $ret[] = $field[0]; else $ret[] = $field;
  return $ret;
}

sin embargo, aunque la sintaxis es correcta, y se ejecuta exactamente igual que en la forma de arriba, se complica su interpretación. Si se piensa en intentar depurar archivos de cientos de líneas escritas sin agrupar unidades lógicas, el trabajo se vuelve mucho más complicado.

En resumen, la aplicación de estas sencillas reglas puede ayudar a que los equipos de programación tengan una mejor comunicación entre ellos, disminuye el tiempo de adaptación cuando se debe tomar el código de otros, agiliza los procesos de depuración, estandariza nuestros esquemas mentales y le añade profesionalismo al trabajo final.

Para más información sobre este tema, se recomienda consultar la documentación oficial de Drupal (http://drupal.org/coding-standards), la guía de buenas prácticas de PHP (http://www.odi.ch/prog/design/php/guide.php) y el siguiente artículo en Nettuts+: http://net.tutsplus.com/tutorials/php/30-php-best-practices-for-beginners/.

Dado que en los últimos años este CMS ha alcanzado gran popularidad, dedicamos este espacio para dar una breve introducción al mismo, esto con el fin de dar una rápida orientación a nuestros clientes y amigos que están empezando a escuchar buenos comentarios sobre Drupal.

Drupal es un sistema de gestión de contenidos modular, gratuito y de código abierto (open source), que permite construir todo tipo de páginas web adaptándose a las necesidades particulares de cada caso.

Entre sus fortalezas podemos citar:

• Control sobre la creación, edición, borrado y publicación de contenidos.
• Categorización y organización del contenidos (taxonomías)
• Seguridad, gestión de usuarios, roles, privacidad, y control del acceso.
• Presentación de contenido en diversos formatos.
• Sistema ampliable y extensible. (Módulos)
• Sistema de plantillas (Temas) separado de la lógica.
• Herramientas de cacheo a varios niveles
• Posee un API para desarrolladores

Se dice que Drupal es Software Libre porque esta publicado bajo la licencia GNU/GPL 2, lo cual permite su libre descarga, modificación y reutilización. Además todos los módulos y temas que se incluyen en la descarga inicial como en las descargas desde el repositorio oficial tienen licencia GPL.

En el siguiente gráfico podemos observar el crecimiento que ha experimentado Drupal contra otros administradores de contenido en los últimos años. El gráfico ilustra el crecimiento de plazas disponibles para programadores con conocimientos en este CMS según el sitio web indeed.com

Queremos complementar este rápido vistazo inicial con el siguiente video introductorio:

Para InterGraphicDESIGNS fue un gusto participar en el Drupal Camp Centroamérica y en definitiva recomendamos a todos los desarrolladores interesados en el tema el participar de las próximas ediciones de este importante evento.

http://www.flickr.com/photos/dragonbe/3411273755/in/pool-elephpants

PHP ingresó por primera vez al Top 3 de lenguajes de programación más populares según el ranking TIOBE. Este ranking mensual estudia cuáles lenguajes de programación cuentan con más desarrolladores capacitados, índice de popularidad, cursos impartidos y revendedores.

Según en ranking de setiembre 2009, los 5 lenguajes de programación más utilizados son: Java, C, PHP, C++ y (Visual) Basic. En el mundo del desarrollo web, otras posiciones interesantes son Perl (6ta posición), JavaScript (9na posición) y Ruby (10ma posición).

En el caso de PHP es la primera vez que ingresa al listado de los 3 lenguajes más utilizados y se posicionó detrás de Java y C. Para obtener estos datos el índice tomó en cuenta herramientas como Google, Wikipedia, Yahoo!, YouTube y MSN.

Es importante aclarar que el índice no es cualitativo, es decir, no pretende dictar cuáles son los mejores 3 lenguajes de programación, pero ciertamente es un indicador del uso, la difusión y el crecimiento de la comunidad de desarrolladores en los diferentes lenguajes.

Para la comunidad de PHP es una excelente noticia al saber que cada vez se cuentan con más expertos en el tema, lo cual desde luego genera mejores productos, más código libre, mejor documentación, más cursos impartidos y en general una plataforma de desarrollo y conocimiento más sólida para todos.

Para entender más sobre el ranking TIOBE puede visitar la definción del ranking TIOBE.

Google nos brinda el “API de Google Chart que permite generar gráficos de forma dinámica”.

Se utiliza llamando a la url de la API de la siguiente forma:

http://chart.apis.google.com/chart?cht=p3&chd=t:60,40&chs=250×100&chl=Hello|World

Este link devolverá una imagen con el gráfico.

Donde:

• http://chart.apis.google.com/chart? es la ubicación del API de Chart.
• & separa los parámetros.
• chs=250x100 es el tamaño del gráfico en píxeles.
• chd=t:60,40 son los datos del gráfico.
• cht=p3 es el tipo de gráfico.
• chl=Hello|World es la etiqueta del gráfico.

Te dejamos la guia del desarrollador de la API de Google Chart. Además si deseas una visualización mas personalizada (no solo para gráficos, puedes encontrar para tablas de resultados también) con varios ejemplos te recomendamos  Google Visualization API

Si lo que buscas es algo en PHP, la librería de pChart te puede dar la solución para la personalización  de gráficas.

Este sería el código (bastante amigable):

<?php
// Standard inclusions
include(“pChart/pData.class”);
include(“pChart/pChart.class”);

// Dataset definition
$DataSet = new pData;
$DataSet->ImportFromCSV(“Sample/bulkdata.csv”,”,”,array(1,2,3),FALSE,0);
$DataSet->AddAllSeries();
$DataSet->SetAbsciseLabelSerie();
$DataSet->SetSerieName(“January”,”Serie1″);
$DataSet->SetSerieName(“February”,”Serie2″);
$DataSet->SetSerieName(“March”,”Serie3″);
$DataSet->SetYAxisName(“Average age”);
$DataSet->SetYAxisUnit(“µs”);

// Initialise the graph
$Test = new pChart(700,230);
$Test->setFontProperties(“Fonts/tahoma.ttf”,8);
$Test->setGraphArea(70,30,680,200);
$Test->drawFilledRoundedRectangle(7,7,693,223,5,240,240,240);
$Test->drawRoundedRectangle(5,5,695,225,5,230,230,230);
$Test->drawGraphArea(255,255,255,TRUE);
$Test->drawScale($DataSet->GetData(),$DataSet->GetDataDescription(),SCALE_NORMAL,150,150,150,TRUE,0,2);
$Test->drawGrid(4,TRUE,230,230,230,50);

// Draw the 0 line
$Test->setFontProperties(“Fonts/tahoma.ttf”,6);
$Test->drawTreshold(0,143,55,72,TRUE,TRUE);

// Draw the line graph
$Test->drawLineGraph($DataSet->GetData(),$DataSet->GetDataDescription());
$Test->drawPlotGraph($DataSet->GetData(),$DataSet->GetDataDescription(),3,2,255,255,255);

// Finish the graph
$Test->setFontProperties(“Fonts/tahoma.ttf”,8);
$Test->drawLegend(75,35,$DataSet->GetDataDescription(),255,255,255);
$Test->setFontProperties(“Fonts/tahoma.ttf”,10);
$Test->drawTitle(60,22,”example 1″,50,50,50,585);
$Test->Render(“example1.png”);
?>

Este es el resultado:

Que opción es la mejor, es una cuestión de gusto y personalización. Pero con estas opciones es muy fácíl que hayas encontrado alguna que te pueda dar esa gráfica que buscas.

Cuando usted se encuentra desarrollando un diseño sofisticado, los archivos CSS rápidamente pueden volverse grandes y requerir de tiempo para cargar. En este artículo se han recopilado 3 formas interesantes para comprimir archivos CSS utilizando PHP.

El método de Paul Stamatiou

Para que usted pueda aplicar este método, primero debe renombrar todos sus archivos .css a .css.php

Además, asegúrese de importar los archivos en su html utilizando su nuevo nombre:




Cuando usted haya renombrado sus archivos css, edítelos y agregue la siguiente porción de código al inicio del archivo:

Seguidamente, agregue la siguiente línea al final del archivo y guárdelo:

Eso es todo. Este método es útil y eficiente.

El método Perishable Press

Básicamente, este método funciona igual que el de Paul Stamatiou, al renombrar sus archivos .css en .css.php (o solamente .php) y agregando esta pequeña porción de código al inicio de su archivo CSS:

ob_start (“ob_gzhandler”);

header (“content-type: text/css; charset: UTF-8″);

header (“cache-control: must-revalidate”);

$offset = 60 * 60;

$expire = “expires: ” . gmdate (“D, d M Y H:i:s”, time() + $offset) . ” GMT”;

header ($expire);

?>

Este método se recomienda más que el descrito por Paul Stamatiou debido a que usted no tendrá que editar tanto el inicio como el final del archivo CSS.

El método Reinhold Weber

Este método fue creado por el desarrollador alemán Reinhold Weber. Lo mínimo que se puede decir es que es el mejor de los 3 métodos de este artículo.

header('Content-type: text/css');

ob_start(“compress”);

function compress($buffer) {

/* remove comments */

$buffer = preg_replace(‘!/*[^*]**+([^/][^*]**+)*/!’, ”, $buffer);

/* remove tabs, spaces, newlines, etc. */

$buffer = str_replace(array(“rn”, “r”, “n”, “t”, ‘ ‘, ‘ ‘, ‘ ‘), ”, $buffer);

return $buffer;

}

/* your css files */

include(‘master.css’);

include(‘typography.css’);

include(‘grid.css’);

include(‘print.css’);

include(‘handheld.css’);

ob_end_flush();

?>

¿Por qué este método es el mejor? Porque es el único de los 3 métodos que no requiere renombrar sus archivos .css a .php ni modificarlos. Muy factible de utilizar en un sitio en producción. Adicionalmente, la expresión utilizada para comprimir los comentarios del archivo CSS es también muy buena.

Observaciones de InterGraphicDESIGNS:

A pesar del aprovechamiento que se le puede dar a estos métodos, tenemos que tomar en cuenta que los archivos css se comprimen cada vez que la página es cargada (con excepción de las páginas que habiliten algún caché), lo que podría provocar procesamiento extra del CPU en un sitio con mucho tráfico.

Algo que puede resultar de utilidad es elaborar un script en PHP que, usando cualquiera de estos 3 métodos, genere los archivos finales CSS comprimidos y éstos sean leídos directamente por las páginas para evitar que el servidor esté comprimiendo los archivos CSS cada vez que se cargan dichas páginas. Con esto conseguiríamos también “ofuscar” de alguna manera nuestros CSS haciendo un tanto difícil para el usuario en Internet leer los mismos.

El proyecto es encabezado por Chris Vincent, y utiliza la función microtime() de PHP para publicar este tipo de resultados.

Algunos ejemplos interesantes:

Utilizar for ($i=0; $i<$size; $i++)" en vez de utilizar "for ($i=0; $i

Pues el cálculo de la función sizeOf o count toma mucho tiempo de ejecución.

Resultados:

Precalculando el tamaño del array: 132 milisegundos.
Calculando el tamaño del array en cada iteración: 57296 milsegundos

Resultados interesantes con la función echo():

echo ‘aaaaaaaaaaaaaaaaaaaaaaaaaaaa’: 139 milisegundos.
echo ‘aaaaaaa’,'aaaaaaa’,'aaaaaaa’,'aaaaaaa’: 278 milisegundos.

Utilizar foreach en vez de utilizar while:

foreach($aHash as $val); 14 milisegundos.

while(list($key) = each($aHash)) $tmp[] = $aHash[$key]; 98 milisegundos.

Le invitamos a leer más conclusiones en el sitio web y hacer sus propias estimaciones utilizando la función microtime() en sus propias aplicaciones.

Ver artículo aquí.

Requiere PHP 4.3 o superior y MySQL 3 o superior.

Ha superado las pruebas de testing en Firefox y en IE 6.0 o superior.

El producto aún tiene en desarrollo varias tareas esenciales en la administración de bases de datos, por lo que la recomendación iría en tener esta herramienta como apoyo a otros editores de BD.

Ir al sitio oficial de TurboDbAdmin

Servidor:

• PHP: la programación conocida como “del lado del servidor”.

Cliente:

• CSS.
• Javascript
• HTML

Primero que todo ninguno de los códigos anteriores se puede encriptar porque si fuera así se irrespetaría la sintaxis del lenguaje y el código pierde su valor y deja de ser funcional.

Por otro lado, en el caso de los CSS, HTML y Javascript que se ejecutan en el navegador, sólo en el último caso se puede aplicar un obfuscador, el cual no encripta propiamente el código sino que lo reemplaza por otro que puede ser interpretado (se respeta la sintaxis de javascript) pero que no es leíble fácilmente por un humano. Sin embargo, todo lo que se ejecuta en el cliente se almacena de manera local (en caché) por lo que los archivos siempre son descargadas y si alguien se propone adueñarse de un código, técnicamente no hay nada que le impida hacerlo; pero se pueden usar ciertas técnicas (como el obfuscamiento) para que dicha tarea sea más difícil.