PHP + AJAX = XAJAX Parte 1 - Introducción

XAJAX es una biblioteca de código abierto de PHP capaz de generar aplicaciones Web con tecnología AJAX, utiliza una forma de trabajo de funciones, designando qué funciones de código PHP se convierten en funciones AJAX. Tambien es posible usar HTML, CSS y JavaScript.

Podemos encontrar mas informacion en su página en http://xajaxproject.org.

Como primer paso vamos a descargar e instalar xajax, de preferencia la ultima version estable de la clase, para ello podemos descargarla directamente en http://sourceforge.net/, aunque en la pagina se encuentra la version 0.5 RC1, cabe mencionar que es uan version candidata para su liberacion, pero no garantiza que sea estable, la ultima version estable fue la 0.2.4.

CARACTERISTICAS

En la actualidad se encuentran diversas clases de bibliotecas y frameworks de AJAX disponibles para los desarrolladores de aplicaciones Web. Algunas de ellas son Prototype y ScriptAculo. Sin embargo para optar por estas soluciones los desarrolladores deben tener un conocimiento, si bien no muy elevado, pero si sólido de Javascript. Por tal hecho, la mayoría de ellos y sobre todo los que utilizan PHP, al hacer uso de estos frameworks podrían encontrar dificultades.

Por otro lado, la biblioteca Xajax es una biblioteca puramente centrada en PHP. Con la introducción de la misma el manejo de AJAX en PHP se hace mucho más sencillo y sobre todo solo se necesita escribir sentencias muy cortas y simples en Javascript, lo que supone una ventaja frente a otras soluciones.

Otras de las características son:

• Xajax es compatible con Firefox, Mozilla, Internet Explorer, Opera y Safari.

• Xajax puede ser usado para actualizar estilos, clases CSS, botones de selección, casillas de verificación y botones de radio o cualquier otro atributo de un elemento

• Cada función registrada para ser accesible a través de Xajax puede tener distintos tipos de petición.

INSTALACION

Obtendremos un archivo comprimido que debemos descomprimir en cualquier lugar de nuestro espacio de publicación. Por ejemplo, podemos crear un directorio llamado xajax donde podemos colocar todos los archivos del .zip descargado.

No hay que hacer especiales acciones para instalar xajax, simplemente descomprimirlo en cualquier servidor Apache o IIS que tenga compatibilidad con PHP 4.3.x o PHP 5.x, o superiores.

Una vez descargado podemos probar los ejemplos que vienen en el directorio examples, siempre a través de nuestro servidor web compatible con PHP, ya sea en local o en un servidor web remoto.

Atención al directorio donde finalmente metemos los archivos de xajax, pues luego tendremos que incluir archivos que hay en dicho directorio, para lo cual deberemos recordar la ruta relativa desde la página donde estemos al directorio donde está xajax.

FUNCIONAMIENTO

En un principio se crea una instancia de objeto Xajax (xajax object). Este objeto manejará todo el procesamiento a través de Xajax. En segundo lugar debemos registrar todas las funciones que hemos definido previamente en el objeto Xajax, esto se puede hacer usando el método xajax->registerFunction(). Finalmente todas las respuestas serán procesadas utilizando el método xajax->processRequest().

$objAjax = new xajax(); $objAjax->registerFunction('mi_funcion_1'); $objAjax->registerFunction('mi_funcion_2'); $objAjax->processRequest();

Paso 1: Incluir la biblioteca Xajax

Como primer paso debemos incluir la biblioteca Xajax de la siguiente manera, teniendo en cuenta que el archivo esta dentro de la carpeta donde guardamos los archivos contenidos en el zip:

require_once("xajax/xajax.inc.php");

Paso 2: Creamos una instancia del objeto Xajax

$xajax = new xajax(); 

 

Paso 3: Registramos las funciones PHP que queremos hacer accesibles desde JavaScript

$xajax->registerFunction("miFunction"); 

 

Paso 4: Escribimos las funciones PHP que vamos a registrar, no hay que olvidarse de que debemos devolver el XML

function miFuncion($argumentos)
{
     // obten el valor de la variable $argumentos y haz alguna cosa con ella como realizar
     // una consulta a una base de datos y pone el resultado dentro de otra
     // variable, como $datos 
     // Haz una instancia del objeto xajaxResponse
     $objResponse = new xajaxResponse();
     // añade un comando a la respuesta para asignar al atributo innerHTML
     // del elemento con id="identificador" para que cambie su contenido a $datos
     $objResponse->addAssign("identificador","innerHTML", $newContent);
     //retorna la respuesta XML generada por el objeto xajaxResponse
     return $objResponse;
} 

 

Paso 5: Le indicamos a Xajax que procese las peticiones:

$xajax->processRequest();

  

Paso 6: Debemos incluir el script Javascript entre las cabeceras HEAD de nuestro código HTML

<?php $xajax->printJavascript('xajax/'); ?>

 

Paso 7: Llamamos a la función desde un evento cualquiera, para ello debemos anteponer la palabra "xajax_" a la funcion para su uso

button onclick="xajax_miFuncion('Hola Mundo...');"

 

Esto es todo, mas adelante subire algunos ejemplos implementando esta tecnologia.