PHP 5: Funciones

2014-03-20 - Categorías: PHP

Hoy les dejo un resúmen sobre las funciones. Tenemos con ellas la primera herramienta para dividir nuestra aplicación en pequeñas partes más fáciles de desarrollar. Éstas funciones se pueden después reutilizar para no tener que repetir el mismo código una y otra vez.

Al programar, se aplica mucho el dicho «Divide y vencerás». Cuando tienes un problema lo bastante grande para resolverlo directamente conviene dividirlo en funciones. O simplemente para ver el programa más claro también conviene usar funciones.

El ejemplo

Es un tema sencillo así que con éste resúmen y un ejemplo seguro que puede quedar claro:

<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8">
    </head>
    <body>
        <p>
            <?php

   function tareaCompleja($totalrepeticiones) {
    $total = 0;
    for ($i = 0; $i < $totalrepeticiones; $i++) {
     $total = $total + $i;
    }
    return $total;
   }

   $mivariable = 1000;
   echo tareaCompleja($mivariable);
   
            ?>
        </p>
    </body>
</html>

Vamos a comentar el ejemplo. Tenemos un documento que es una web, que tiene dentro incrustado código PHP. Tenemos una función llamada tareaCompleja que realiza un bucle for.

Fijémonos primero después de la declaración de la función. Tenemos una variable que vale 1000 y en la última línea 19 del ejemplo tenemos un echo que usa la función.

Tenemos dos cosas importantes: una el echo anterior que llama a la función, la otra es la función que devuelve un valor. Cuando la función se llama desde el echo anterior, se ejecuta el código calculando el total. Con el return se devuelve el valor de total, en éste caso 499500. Entonces el echo al final lo que hace es un ‘echo 499500’ con lo que en la página web se imprimirá dicho número.

Tenemos entonces que con la palabra reservada function creamos las funciones. Dichas funciones pueden recibir información, dicha información se recibe en éste caso con la variable $mivariable que se pone entre paréntesis al usar la función. Y por último la función puede devolver o no un valor con la palabra reservada return.

Terminando

También tenemos muchas funciones que el propio PHP nos da. Ya en anteriores capítulos puse la función phpinfo() que escribía todas las configuraciones. Por ejemplo poniendo en un fichero .php lo siguiente lo veremos:

<?php 
phpinfo();

Antes de contruir una nueva función conviene mirar en la documentación si ya está y usarla directamente.

Para terminar me remito de nuevo a la documentación oficial de PHP.

Si te ha sido útil, te ha gustado, o simplemente quieres decirme que siga escribiendo en el blog o cualquier otra cosa puedes darle +1, compartir, dejar un comentario.. justo aquí debajo.

Un saludo.

PHP 4: Bucles

2014-03-17 - Categorías: PHP

Bueno, ya llegando a éste minitutorial se va poniendo divertido. Aquí tenemos las primeras estructuras de control que con pocas líneas de código nos van a permitir hacer muchas cosas. Ahora te preguntarás que como con programando pocas líneas podemos hacer muchas cosas. Sí!

Para entenderlo rápidamente, por ejemplo, si queremos hacer una tarea un millón de veces. Programando un bucle que podría tener apenas tres lineas podría hacerse.

for

El bucle for ejecuta un número de veces una tarea, por ejemplo:

for($i=1; $i<=1000000; $i++){
  // ésto es un comentario que no se ejecuta
  // porque tiene delante las barras
  echo $i;
}

Éste bucle usa una variable $i que va desde 1 hasta 1000000, saltando de uno en uno. Es decir se ejecuta un millón de veces el echo $i;

En la primera línea podemos ver el valor inicial, hasta cuándo ejecuta el bucle, y de cuánto es el incremento entre vuelta y vuelta del bucle. Éste miniprograma imprimirá «123456789101112131415… así sucesivamente hasta llegar a …9999991000000»

Si tratas de ejecutar éste bucle probablemente no terminará porque un millón de veces es demasiado, saltará un temporizador en el servidor y cortará la ejecución por tardar demasiado.

foreach

El foreach nos sirve para recorrer los vectores o arrays que hemos visto en otro tutorial anterior. Por ejemplo si tenemos un vector como el siguiente:

$vector = array("nombre" => "Pepe", "apellidos" => "Por Ejemplo");
$vector2[0] = "Pepe";
$vector2[1] = "Por Ejemplo";
   
foreach ($vector as $valor) {
  echo $valor . ", ";
}
foreach ($vector2 as $clave => $valor) {
  echo $clave . " => " . $valor . ", ";
}

El primer bucle va a imprimir lo siguiente: Pepe, Por Ejemplo,
El segundo bucle: 0 => Pepe, 1 => Por Ejemplo,

Si nos fijamos en los dos vectores, tenemos en $vector un vector de dos elementos donde la clave nombre almacena Pepe y la clave apellidos almacena Por ejemplo. En el segundo vector tenemos lo mismo en los valores pero las claves, en vez de ser nombre y apellidos son 0 y 1.

Si hubieramos puesto en el segundo bucle en vez del $vector2 al $vector, nos hubiera impreso lo siguiente: nombre => Pepe, apellidos => Por Ejemplo,

while

Supongamos que ahora queremos ejecutar una tarea mientras que se cumpla una condición, papra ésto es es el bucle while. Por ejemplo:

$variable = 1;
while($variable < 3){
  echo $variable . ", ";
  $variable++;
}

Éste bucle escribirá lo siguiente: 1, 2,

De forma que si la $variable tuviera en un principio el valor 20, no entraría en el bucle y no se ejecutaría nunca lo contenido entre llaves.

do.. while

Si lo que queremos es primero ejecutar una tareas y después comprobar si se cumple una condición para continuar el bucle usamos el do.. while. Al contrario que con el while simple, primero ejecuta lo contenido entre llaves, luego comprueba, ésta es la diferencia. Por ejemplo:

$variable = 3;
do {
  echo $variable . ", ";
  $variable++;
} while($variable < 3);

Éste código escribirá: 3,

Ahora es cuando uno piensa, pero si he puesto que la variable debe ser menor a 3. El problema es que primero ejecuta, como he puesto arriba..

Terminando

A partir de aquí ya empieza la imaginación, podemos poner un bucle dentro de otro, un foreach con varios for dentro o viceversa. Espero haberme explicado bien, sino haz un do.. while(noentender) xDD

O deja un comentario.

Me remito de nuevo, como de costumbre a la documentación oficial:

http://www.php.net/manual/es/language.control-structures.php

Si te ha gustado o te ha sido útil dale click a compartir, +1..

¡Un saludo!

PHP 3: Condicionales

2014-03-14 - Categorías: PHP

Siguiendo con la serie de minitutoriales, hoy les voy a dejar uno sobre los condicionales en PHP. Estamos viendo lo que se llaman estructuras de control, y dentro de ellas pretendo dividirlas y ver aquí sólo los condicionales if y switch.

Si buscas un tutorial breve y concreto, sin rodeos y sin entrar en detalles, aquí lo tienes.

A saber..

If

Los condicionales comprueban si se cumple una condición, como su nombre indica, y en ése caso ejecutan el código programado en él. Por ejemplo:

<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8">
    </head>
    <body>
        <p>
            <?php
   $variable = 2;
   if ($variable == 2) {
    echo "La variable vale dos.";
   } else {
    echo "La variable no vale dos.";
   }
            ?>
        </p>
    </body>
</html>

El código habla por sí sólo. Tenemos una web que utiliza el estándar HTML5 como indica su DOCTYPE, y en el cuerpo de la página tenemos incrustado código PHP. Simplemente mira si la variable vale 2 y como así es imprimirá ‘La variable vale dos.» en la web. Si no valiera dos entonces ejecutaría lo que hayas puesto en el else.

El meollo de los condiciones está en la expresión de comparación ($variable == 2). Tenemos disponibles varios operadores de comparadores, por ejemplo: ==, <=, >=, !=
Están todos muy bien explicados aquí http://www.php.net/manual/es/language.operators.comparison.php

Switch

Por otro lado tenemos el switch. Se usa para encontrar valores concretos. Un ejemplo para vero claro podría ser:

$otravariable = "patata";
switch ($otravariable) {
  case "patata" :
    echo "Es una patata.";
    break;
  case "boniato" :
    echo "Es un boniato.";
    break;
  case "cebolla" :
    echo "Es una cebolla.";
    break;
  default :
    echo "¡Alguien me ha cambiado el valor de la variable!";
    break;
}

Podriamos haber usado varios condicionales de tipo if para ir comprobando $otravariable. Pero cuando tenemos más de dos posibles valores es mejor usar la estructura del switch. Fíjate que dentro de cada caso hay un break para indicar que ahí termina el caso. Si no los ponemos estaremos uniendo varios casos.

Es importante notar también el caso especial default que se ejecutará sólo cuando no encuentre el valor.

De nuevo para terminar me remito a la documentación oficial http://www.php.net/manual/es/index.php, aquí tiene en la sección de Estructuras de control los condicionales y muchísima más información.

Si te ha sido útil o te ha gustado dale click al +1, compartelo.. también puede dejar un comentario.

¡Un saludo!

PHP 2: Variables

2014-03-13 - Categorías: PHP

Continuando con los minitutoriales para aprender rápidamente y en dos dias PHP, ahora las variables..

No hace falta declarar el tipo de variable que vamos a usar, simplemente le damos valor y la usamos. PHP no es fuertemente tipado. No hace falta definir el tipo de variables que usamos, además de que la naturaleza de las variables puede cambiar a lo largo de la ejecución de los programas.

PHP tiene características muy buenas para aprender a programar gracias a su flexibilidad. Quizá por esto es bien popular. Pero a la vez, esta flexibilidad, libertad, o libertinaje, da lugar a quizá códigos fuentes a veces confusos i no lo mejor posibles. Pero esto es otro tema para otro post, así que vamos al grano..

Variables simples

Las variables utilizan el símbolo $ delante del nombre de la variable.

$variable = "cadena";
$variable2 = 1;
$variable3 = 1.2;
$variable4 = true;
echo $variable;

Ésto escribirá ‘cadena’ en la web. Es sencillo ¿verdad? simplemente le damos valores y las usamos.

Variables no tan simples

A modo de curiosidad, en un test me preguntaron para qué servían las variables con doble $, pues mira el código siguiente:

$variable2 = "cadena2";
$$variable2 = "otro valor";
echo $cadena2;

Ésto escribirá ‘otro valor’. Pero ¿cómo? ¡si no le he dado valor a la variable $cadena2! Ésto es lo que en la documentación oficial se llaman variables variables. Sirve para usar nombres de variables que cambien. Dejo aquí el enlace con todo ésto mejor explicado http://php.net/manual/es/language.variables.variable.php

Vectores

También tenemos vectores, de la forma que tenemos una ‘lista’ de elementos. Con un ejemplo podemos verlo claramente cómo se puede usar.

$unvector[] = "valor1";
$unvector[] = "valor2";
$unvector["algo"] = "valor3";
$unvector[0] = "primer valor";
echo $unvector[1] . " - " . $unvector["algo"]; // valor2 - valor3
var_dump($unvector);

Fijándonos en el código anterior, podemos ver que los vectores comienzan por la clave 0 de forma automática. Otra forma de utilizarlos en vez de usar un entero para los elementos, es usando cadenas. Examinando el resultado de la última instrucción especial:

array(3) { [0]=> string(12) «primer valor» [1]=> string(6) «valor2» [«algo»]=> string(6) «valor3» }

Podemos ver que tenemos un vector de 3 elementos. Lo que tenemos entre corchetes [] son las claves para darle valor o usarlo. Y después del => tenemos el valor.

Matrices y otros

Hay muchas más posibilidades, podemos tener también matrices, de forma que en vez de tener vectores de elementos, tenemos vectores de vectores, similar a una tabla.

$matrix[0][0] = 1;
$matrix[0][1] = 2;
$matrix[1][0] = 3;
$matrix[1][0] = 4;

También podemos usar tres dimensiones.

// una matriz tridimensional
$matrix[0][1][5] = 27;

..cinco dimensiones..

// una matriz de cinco dimensiones
$matrix[0][1][5][2][3] = 2723;

Así sucesivamente. Queda añadir que los elementos de los vectores, matrices y otras formas multidimensionales que podamos usar pueden ser de todos los tipos disponibles.

De nuevo, me remito para más información a la documentación oficial http://www.php.net/manual/es/index.php

PHP 1: Escribiendo la respuesta

2014-03-13 - Categorías: PHP

Aquí desde Spain la crisis sigue apretando, no hay mucho trabajo así que aprovecho para seguir con los minitutoriales. Continuando con éste nuevo post, sin demasiada teoría, vemos dónde ponemos el código PHP. Al grano..

Escribiendo la respuesta

Partimos de que ya tenemos un esqueleto básico en HTML de nuestra página index.html o cualquier otra web con incluso CSS, Javascript, etc. Por ejemplo:

<!DOCTYPE html>
<html>
    <head>
        <title>PHP 1: Escribiendo la respuesta</title>
        <meta charset="utf-8">
    </head>
    <body>
        <!-- AQUÍ VA EL CONTENIDO DE LA
        WEB -->
        <?php
 echo "<p>¡Hola mundo!</p>";
        ?>
    </body>
</html>

En cualquier lugar podemos usando las etiquetas <?php código fuente ?> incluir nuestra programación que se ejecutará antes de enviar al navegante. Éste código dará de resultado, simple y llanamente el siguiente resultado que enviará al navegador:

<!DOCTYPE html>
<html>
    <head>
        <title>PHP 1: Escribiendo la respuesta</title>
        <meta charset="utf-8">
    </head>
    <body>
        <p>¡Hola mundo!</p>
    </body>
</html>

Existen otras formas de escribir la respuesta, pero para escribir simple texto con echo tenemos bastante. Tenemos también print, printf, fprintf, etcétera..

También podemos tener una página completamente en PHP, en la que sólo hace falta que abramos la etiqueta <?php y sin cerrar. Pero en éste caso, todo debe generarse desde PHP. Es decir, todas las etiquetas HTML o contenido cliente debe generarse.

<?php
// código fuente de nuestro programa..

Lo habitual es usar éste formato cuando dividimos la aplicación en varios ficheros. Por ejemplo, podemos tener funciones, objetos, variables y otras cosas separadas en otros ficheros .php e incluirlos o requerirlos. Más adelante escribiré sobre cómo incluir o dividir la aplicación en trozos. Todo éste código PHP se ejecutará en el servidor, escribiendo la respuesta que se le va a enviar al visitante, y posteriormente se le enviará al navegador sin que el navegador del visitante pueda ver nada de la programación PHP.

Para más información me remito a la documentación oficial http://www.php.net/manual/es/index.php

PHP 0: Preparando las herramientas

2014-03-10 - Categorías: PHP

Inaguro con éste post una serie de pequeños tutoriales que pretendo publicar para auto-reciclado de nuestros conocimientos. O para aprender los nuevos, los que los lleguen a leerlos, de una manera no demasiado técnica, aprendiendo los conceptos básicos sobre programar en PHP.

La sintáxis de PHP es parecida a C/C++, Java, JavaScript, así que si ya conoces alguno de éstos lenguajes verás más claros los codigos.

Sobre navegar

En Internet, mientras navegamos, todo ocurre de la forma: el navegador pide una página aun servidor web, el servidor web se encarga de hacer lo que tenga que hacer y construye la respuesta, y finalmente ésta respuesta se la envía al nevagador web. Hay una arquitectura cliente-servidor, donde el cliente (navegador) hace peticiones al servidor (servidor web) y éste le devuelve lo pedido.

Navegador ------------------> realiza petición ---------------------> Servidor Web
..el servidor procesa la petición, aquí PHP se ejecuta..
Navegador <------------------ recibe la petición <------------------- Servidor Web

PHP se ejecuta en el servidor, aunque también permite ejecutarse en línea de comandos, como el antiguo MSDos o el bash de Linux. Es decir, lo que programemos en PHP va a ejecutarse en el servidor web que tengamos antes de enviarsa nada a nuestros navegadores. PHP se usa para construir la respuesta que vemos en el navegador. Dicha respuesta puede contener noticias, un foro.. todo tipo de contenido dinámico generado según lo que se haya programado.

Herramientas

Vamos a necesitar, como para cualquier desarrollo web, unas herramientas:

Editor de texto: Notepad, Notepad++, Eclipse, Aptana Studio, Vi, Nano, Gedit.. cada cual con el que más le guste, si tienes experiencia con Eclipse recomiendo ver el Aptana Studio, si no mejor algo más simple para empezar como el Notepad++, si usas Linux no tendrás problema para encontrar el tuyo y tal vez ya tengas alguno bueno instalado. También los hay de pago como PhpStorm que últimamente está muy de moda.
Navegador web: imprescindible tener varios para probar en caso de querer máxima compatibilidad. Internet Explorer, Chrome, Opera, Firefox y Safari son los más utilizados. De entre ellos Firefox es que más respeta los estándares y ya todos suelen traer herramientas de desarrollador que nos faciliten la tarea.
Servidor web con PHP: ahora viene lo complicado, tenemos muchos servidores web disponibles y le podemos. Para programar nos puede valer con cualquiera decente que tenga PHP aunque no está de más elegir uno bastante estable y completo. Directamente recomiendo Apache en sus versiones XAMPP, WAMPP, LAMPP, Uniform Server para Windows o el propio Zend Server en su versión gratuita, que ya nos traerá todo el paquete listo para usar y no tendremos que meternos a hacer tareas de administrador de sistemas.

Una vez instalado y configurado todo podemos empezar con un primer proyecto para comprobar que todo funcione.

Primer proyecto

Doy por sentado unos conocimientos mínimos sobre programación, soltura en el manejo de tu ordenador, ficheros, directorios, etc..

Tenemos mucha información de instalación sobre cada servidor en Internet, las versiones de XAMPP son muy fáciles de instalar y seguro que siguiendo las instrucciones lo instalas rápidamente. En mi caso tengo instalado Uniform Server, que simplemente se descomprime y dentro de su carpeta tengo otra llamada ‘www’ que es donde apunta ‘localhost’. Configurar el servidor se sale del propósito de éste minitutorial así que tal vez en otro..

Cabe destacar que desde la versión 5.4.0 tenemos un servidor embebido que tan sólo instalando PHP. Es muy básico pero es simple para empezar. Entramos en línea de comando al directorio donde tenemos la web y ejecutamos lo siguiente:

C:directorioDeLaWebphp -S localhost:12345

Debemos tener el ejecutable de PHP en el path del sistema. Luego accediendo a http://localhost:12345/ podremos ver nuestro index.php o index.html

Una vez tengamos configurado el servidor elegido podremos acceder a http://localhost/ o al host virtual http://hostvirtual/ y vamos a crear nuestro primer ‘hola mundo’. Escribimos en un fichero de texto lo siguiente y lo ponemos en el directorio del servidor web donde está nuestro host:

<?php
echo "¡Hola mundo!";
?>

Una opción al clásico ‘hola mundo’ es mostrar la información del PHP instalado con lo siguiente veremos todas las variables de la instalación, así como la versión y otras configuraciones:

<?php
phpinfo();
?>

Debemos ver algo parecido a la imagen siguiente:

Terminando

Si te has instalado un entorno de desarrollo, un navegador, el servidor web y has conseguido ver en el navegador la imagen anterior del phpinfo te puedes dar por satisfecho. Espero pronto poder seguir escribiendo.

Para terminar no me queda más que remitirme a la documentación oficial de donde he sacado muchos conceptos. También hay muy buenas webs con más contenido sobre PHP, como por ejemplo el proyecto http://www.phptherightway.com/

Un saludo!

Joomla! Platform 4: Autocarga de clases con JLoader

2013-07-07 - Categorías: PHP

Empieza el domingo interesante. Un poco desesperado porque el framework de Joomla no tiene mucha documentación para usarlo independientemente del CMS pero ahí seguiré atento a los cambios, que seguro que algún día se convertirá en un framework de la categoría de Symfony o Codelgniter, por ejemplo. Con 2700 desarrolladores en todo el mundo, más de 6000 extensiones, con un 2,7% de portales en Internet que usan Joomla! ésto promete.

A fecha de hoy leo en los foros de grupos de desarrollo que con la separación de Joomla Platform del desarrollo del CMS se están cambiando los espacios de nombres y añadiendo más y más funcionalidades. Una de éstas últimas es el nuevo método para autocargar clases.

Con un ejemplo se ve bien sencillo:

<?php

// se importa la Plataforma Joomla.
require_once 'libraries/import.php';

// directorio base que se usa para el autocargador de clases
const JPATH_BASE = __DIR__;

// registra un prefijo cualquiera
JLoader::registerPrefix('Jnj', JPATH_BASE);

// crea una instancia de la clase nueva
$app = JApplicationWeb::getInstance("JnjUnDirectorioEjemploWeb");

// se supone que debemos guardar la applicación en el core
JFactory::$application = $app;

// y entonces podemos ejecutarla desde el core
JFactory::getApplication()->execute();

// así queda todo ordenado en el núcleo del framework

Éste podría ser un index.php del directorio principal. Con JLoader se establece un prefijo para las clases, en éste caso, ‘Jnj’. Ahora al cargar la instancia de la clase ‘JnjUnDirectorioEjemploWeb’, la clase se buscará en el directorio ‘/Un/Directorio/Ejemplo/web.php’ y la clase se deberá llamar ‘JnjUnDirectorioEjemploWeb’. Aquí abajo tienen la clase web para ejecutarlo:

<?php
class JnjUnDirectorioEjemploWeb extends JApplicationWeb {
    protected function doExecute()
    {
        $this->setBody("");
        $this->appendBody("<h1>Plataforma Joomla! Autocarga de clases con JLoader</h1>");
        $this->appendBody("Si estas viendo ésto en el navegador es que está bien la autocarga...");
    }
}

Los dos ejemplos y la estructura de directorios se pueden descargar aquí.

Para que funcione debemos tener el framework descomprimido en el mismo directorio raiz de la web, y ejecutarlo desde un navegador, como viene siendo costumbre en éstos minitutoriales.

Ahora eligiendo un prefijo, y organizando las clases del proyecto en directorios podemos ‘autocargar’ todo fácilmente sin tanto import o require. De manera dinámica el framework se encargará de todo.

Espero que sirva. Saludos.

Joomla! Platform 3: Bases de datos

2013-06-25 - Categorías: PHP

Ya llegó el calor, terminaron los exámenes de junio y parece que ya llega el verano, aunque hace poco aún estaba lloviendo en la costa mediterránea de España. Yo sigo con lo mío y hoy les traigo un acceso a bases de datos usando SQLite, una base de datos de dominio público, embebida, no necesita instalación y simplemente con que PHP tenga activada la extensión para ello ya podemos usarla.

Como viene siendo costumbre de la serie que escribo, me voy a centrar en el uso en un servidor web, con lo que el ejemplo es una página web. Se puede también ejecutar en línea de comando pero yo no uso PHP de esa forma así que… vamos al grano.

Materiales

El framework Joomla Platform. Yo he usado la versión 12.3, la oficial veo que es la 12.1 y está en desarrollo la 13.1. Aquí hay más información para los curiosos como yo.
Un entorno de desarrollo. Aquí ya para gustos estan los colores, Eclipse va muy bien y es multiplataforma.
Un servidor para ejecutarlo. XAMPP funciona muy bien y también es multiplataforma.

Empezando

Descomprimo el framework en el directorio si es que no lo tengo ya, entonces hay que crear un fichero .php como en el ejemplo siguiente y veremos rápidamente como funciona:

...
<?php

// se importa la Plataforma Joomla.
require_once 'libraries/import.php';

class laWeb extends JApplicationWeb {
    protected function doExecute()
    {
        $this->setBody("<html><body>");
        $this->appendBody("<h1>Plataforma Joomla! SQLite</h1>");

        // vector de configuración de la base de datos
        // para sqlite sólo hace falta ésto
        $option = array(); 
        $option['driver']   = 'sqlite';            // tipo de bd
        //$option['host']     = 'direccionhost.com';    // host
        //$option['user']     = 'usuario';       // 
        //$option['password'] = 'contraseña';   // 
        $option['database'] = 'bdpruebas.sqlite';      // nombre de la bd
        //$option['prefix']   = 'pref_';             // prefijo
        $dbo = JDatabaseDriver::getInstance($option);
        
        // se puede abreviar usando:
        //$dbo = JDatabaseDriver::getInstance(array('driver' => 'sqlite', 'database' => 'bdpruebas.sqlite'));
              
        
        // crea una tabla para las pruebas, la borra si existe
        $dbo->setQuery("DROP TABLE IF EXISTS aleatorios");
        $dbo->execute();
        $dbo->setQuery('CREATE TABLE IF NOT EXISTS aleatorios (id INTEGER PRIMARY KEY, numero INTEGER)');
        $dbo->execute();
        $this->appendBody("<p>Creada la base de datos...</p>");

        // inserta unos datos en la BD
        for ($i = 0; $i < 10; $i++) {
            $dbo->setQuery('INSERT INTO aleatorios (id, numero) VALUES (' . $i . ', ' . rand(0,99) . ');');
            $dbo->execute();
        }
        $this->appendBody("<p>Insertados datos...</p>");

        // lee la tabla
        $this->appendBody("Listando con loadRowList ");
        $dbo->setQuery("SELECT * FROM aleatorios;");
        $resultados = $dbo->loadRowList();
        foreach ($resultados as $res){
            $this->appendBody( "<p>" . $res[0] . ", " . $res[1] . "</p>");
        }
        
        // lee la tabla de otra forma
        $this->appendBody("Listando con loadAssocList ");
        $dbo->setQuery("SELECT * FROM aleatorios;");
        $resultados = $dbo->loadAssocList();
        foreach ($resultados as $res){
            $this->appendBody( "<p>" . $res['id'] . ", " . $res['numero'] . "</p>");
        }
        
        // lee de nuevo la tabla de otra forma
        $this->appendBody("Listando con loadObjectList ");
        $dbo->setQuery("SELECT * FROM aleatorios;");
        $resultados = $dbo->loadObjectList();
        foreach ($resultados as $res){
            $this->appendBody( "<p>" . $res->id . ", " . $res->numero . "</p>");
        }
        
        $this->appendBody("</body></html>");

    }
}

JApplicationWeb::getInstance("laWeb")->execute();
...

El ejemplo en descarga está aquí.

El resultado de ejecutarlo desde el navegador debe ser algo tal que así:

Plataforma Joomla! SQLite

Creada la base de datos…
Insertados datos…
Listando con loadRowList
0, 55
1, 4
2, 1
3, 76
4, 95
5, 62
6, 63
7, 16
8, 52
9, 73
Listando con loadAssocList
0, 55
1, 4
2, 1
3, 76
4, 95
5, 62
6, 63
7, 16
8, 52
9, 73
Listando con loadObjectList
0, 55
1, 4
2, 1
3, 76
4, 95
5, 62
6, 63
7, 16
8, 52
9, 73

Explicaciones

Lo que hace el programa es crear el archivo bdpruebas.sqlite si no existe, es un comportamiento peculiar de SQLite. Si usásemos otra base de datos como PostgreSQL o MySQL podríamos usar las sentencias SQL propias de cada base de datos. El código usa las funciones para cargar tablas de datos loadRowList, loadAssocList y loadObjectList. Ésto nos devuelve un objeto que almacenará los datos de la base de datos en nuestro programa. Hay otras funciones para cuando la consulta devuelve sólo una fila o sólo un dato por ejemplo.

Hasta aquí todo bien, pero entonces ¿porqué usar el framework y no usar directamente PHP como siempre sin framework?

Ahora a partir de las últimas versiones se han añadido más bases de datos aparte de la original MySQL, tenemos PostgreSQL, SQLServer, y se preveen el acceso a muchas otras. Ahora bien, tenemos una capa extra que nos va a independizar totalmente de la base de datos, siempre que no usemos las tradicionales sentencias SQL, como en el ejemplo anterior, y construyamos nuestra aplicación usando ésta herramienta. Puede que en un futuro querramos cambiar de base de datos o hacer posible que dicho cambio sea dinámico según configuración del usuario.

Independizando de la base de datos

La historia está en crear la query usando el framework. Tenemos la clase JDatabaseDriver que es la que nos provee de la conexión a la base de datos. Ahora sí, contruimos la $query usando la clase JDatabaseQuery y entonces obtendremos esa compatibilidad de las consultas, inserciones, actualizaciones y borrados de nuestro programa con varios tipos de bases de datos. He simplificado el ejemplo anterior:

...
<?php

// se importa la Plataforma Joomla.
require_once 'libraries/import.php';

class laWeb extends JApplicationWeb {
    protected function doExecute()
    {
        $this->setBody("<html><body>");
        $this->appendBody("<h1>Plataforma Joomla! Independizando de la base de datos</h1>");

        //
        $dbo = JDatabaseDriver::getInstance(array('driver' => 'sqlite', 'database' => 'bdpruebas.sqlite'));

        // borrando los datos de la tabla aleatorios
        // para tenerla limpia
        $query = $dbo->getQuery(true);
        $query->delete('aleatorios');
        $dbo->setQuery($query);
        $dbo->execute();
                
        $this->appendBody("<p>Borrados los datos...</p>");

        // inserta unos datos en la BD
        for ($i = 0; $i < 10; $i++) {
            // crear una nueva consulta
            $query = $dbo->getQuery(true);
            
            // se construye
            $query->insert('aleatorios')
            ->columns('id, numero')
            ->values($i . ', ' . rand(0,99));
            
            // se establece
            $dbo->setQuery($query);
            
            // se ejecuta
            $dbo->execute();
        }
        $this->appendBody("<p>Insertados datos...</p>");

        // consultado datos
        $query->select('*')->from('aleatorios');
        $dbo->setQuery($query);
        $resultados = $dbo->loadObjectList();
        foreach ($resultados as $res){
            $this->appendBody( '<p>' . $res->id . ', ' . $res->numero . '</p>');
        }

        $this->appendBody("</body></html>");

    }
}

JApplicationWeb::getInstance("laWeb")->execute();
...

Éste segundo ejemplo está en descarga aquí.

Utilizando la base de datos creada con el primer ejemplo, si guardamos éste segundo en otro fichero .php y lo ejecutamos en el navegador funcionará de forma similar. Ahora, si tenemos la base de datos distinta de SQLite, simplemente con cambiar la línea:

$dbo = JDatabaseDriver::getInstance(array('driver' => 'sqlite', 'database' => 'bdpruebas.sqlite'));

Haciendo la conexión con la base de datos que tengamos, nos aseguramos que el resto de consultas, inserciones, actualizaciones o borrados van a funcionar.

Terminando

Otra vez más, me remito para más información a la documentación oficial:

http://docs.joomla.org/J3.1:Accessing_the_database_using_JDatabasehttp://api.joomla.org/Joomla-Platform/Database/JDatabaseQuery.html#insert

Éste post al final se ha hecho bien largo, ¡otro testamento! xDD Es que las bases de datos lo merecen ¿no cree?

Espero que sirva.
Saludos.

Joomla! Platform 2: La fábrica de objetos de Joomla

2013-06-08 - Categorías: PHP

Hoy les escribo un poco más sobre Joomla y su framework de desarrollo en PHP, la Joomla Platform. Esto es una joya, aunque no se usa mucho de manera independiente al CMS puede ser que pronto se haga. Por lo menos mi opinión es que es un buen framework; simple, rápido y eficaz, una buena alternativa.

Siguiendo con la carnicería, sacando toda la casquería, las tripas y demás de todo lo que es el CMS y el framework. Y nos encontramos con la fábrica de objetos, la clase JFactory.

La fábrica de objetos se usa constantemente en el CMS, en el desarrollo de extensiones, y si queremos desarrollar un sitio web a partir del framework podemos usarla y de esta manera tendremos todo el proyecto mejor estructurado.

Materiales

El framework, Plataforma Joomla para los amigos.
Un entorno de desarrollo o editor de texto: Eclipse, Notepad++, Gedit, Vi, Notepad o el que sea que use..
Un servidor web con PHP: Va muy bien el XAMPP

El ejemplo

Con ésto pequeño ejemplo se puede ver una forma muy simple de usar el framework:

...
<?php

// se importa la Plataforma Joomla.
require_once 'libraries/import.php';

// en éste ejemplo tan simple la clase la pongo aquí pero 
// se debería poner en otro fichero 
class laWeb extends JApplicationWeb {
    protected function doExecute()
    {
        $this->setBody("<html><body>");
        $this->appendBody("<h1>Plataforma Joomla! probando la fábrica</h1>");

        // declara una variable que es un objeto para trabajar con emails
        $emiliator = JFactory::getMailer();
        $this->appendBody("<p>Versión de MAILER de la plataforma: " . $emiliator->Version);
        
        $this->appendBody("</body></html>");

    }
}

// instancio un objeto de la aplicación web
$app = JApplicationWeb::getInstance("laWeb");

// guardo la aplicación en el core
JFactory::$application = $app;

// uso la aplicación web que guardé directamente desde el core
JFactory::getApplication()->execute();
...

Descargar archivo con el ejemplo.

JFactory es un objeto, que sirve para acceder al núcleo del framework, es decir, nos va a dar acceso a todo tipo de objetos que, al instanciarlos en nuestro programa, podremos usarlos y ahorrarnos el desarrollo de éstos.

Explicaciones

En el ejemplo he usado la función getMailer() para tener acceso al objeto de tipo JMail que tenemos en el framework. Es una interfaz con la que podremos construir en un email con destinatario, asunto, mensaje, etcétera… y configurando los parámetros del servidor de email podríamos enviar.

Hay muchos otros objetos, para hacernos una idea general, la fábrica de Joomla nos proporciona las siguientes funciones con las que acceder a éstos:

getACL: para manejo de autorizaciones.
getApplication: almacena la aplicación.
getCache: la caché.
getConfig: las configuraciones del sitio.
getDate: para manejo de fechas.
getDbo: manejo de bases de datos.
getDocument: manejo de documentos de varios tipos.
getEditor: el editor.
getFeedParser: te da un XML ya parseado.
getLanguage: el lenguaje.
getMailer: el mailer del ejemplo.
getSession: manejo de sesiones.
getStream: manejo de esos objetos tan útiles a veces, los streams.
getURI: para URIs.
getUser: el usuario.
getXML: para manajar ficheros XML.

Me remito a la documentación oficial, como siendo costumbre para más información sobre cada función: http://api.joomla.org/

Podemos ver la implementación completa de la JFactory en el archivo /libraries/joomla/factory.php

Me siento friki de nuevo, otros leen, juegan a videojuegos… cuando tienen tiempo. Yo me complico la vida tratando de averiguar cómo los desarrolladores de Joomla, han hecho el CMS y su framework, me saltan chispas y estoy hechando humo, pero lo he disfrutado.. ¿éso es de friki no? xD Espero haber dado algo de luz sobre la JFactory.

Para cualquier mensaje, aquí abajo lo pueden dejar.

Un saludo.

Joomla! Platform 1: Configuración y otros datos, JConfig y JPlatform

2013-06-05 - Categorías: PHP

Continuando con la serie de minitutoriales sobre la Plataforma Joomla, en éste post voy a empezar a despellejar y destripar poco a poco ésta joya de la informática. A fecha de hoy Joomla es el CMS más utilizado en todo el mundo y hay una comunidad muy grande que lo mantiene.

Si vamos a usar un framework PHP, nos vamos a asegurar de que la aplicación va a seguir una estructura, un orden a la hora de programar. Cada archivo, módulo, subprograma, función… va a ser claro de su padre y de su madre. Pero si usamos un framework, cualquiera que lo conozca podrá colaborar en el proyecto más pronto que tarde, porque será más legible, tendrá menos líneas de código probablemente que si lo hubieramos desarrollado desde cero. Todo ésto porque nos ahorraremos unas cuantas líneas de código.

Así que veamos pues cómo lo han hecho…

Materiales

Simplemente 3 cosas para seguir éste minitutorial:

Un servidor web con PHP como XAMPP, disponible para varios Sistemas Operativos, o el Uniform Server portable y para Windows.
Nuestro editor o entorno de desarrollo preferido. Como por ejemplo Eclipse, Notepad++, etc…
El CMS si queremos probarlo lo tenemos en castellano en http:/www.joomlaspanish.org. Y la Joomla! Platform, yo he usado la versión 12.1, que lo tenemos en descarga en http://api.joomla.org/.

Empezando

Supongo que nos manejamos bien en PHP y con nuestro editor de código fuente, y tambien sabemos poner en marcha un servidor servidor local para nuestras pruebas. Además doy por entendido que conocemos el CMS de Joomla! lo sabemos instalar y más o menos llevamos un nivel adecuado de su manejo. Si no es así recomiendo no seguir y mirar antes éstas cosas.

Usaré para muchos de los ejemplos la clase JApplicationWeb para usar el framework, por si acaso comento que no es necesario, pero para ejecutar con un servidor web y ver en un navegador los resultados hace falta.

Antes de seguir descomprimimos el fichero de la Plataforma Joomla en el directorio donde vamos a hacer las pruebas y configuramos el servidor para acceder a él. Si queremos probar el CMS lo que ponemos en el directorio es el paquete Joomla para instalarlo., que también trae incluido una versión de la Plataforma.

JConfig y el fichero de configuraciones

En el CMS de Joomla! el fichero de configuracion de la web es /configuration.php. Cuando descomprimimos una instalación nueva, y visualizamos el nuevo Joomla! lo que vamos a ver el módulo o subprograma contenido en el directorio de instalación /installation. Dicho directorio está destinado a configurar la nueva instalación de Joomla! con una serie de formularios que nos guian paso a paso para poner todas las configuraciones, además de crear las tablas en la base de datos e introducir los datos necesarios para comenzar a usarlo.

Después de la instalación se debe de borrar el directorio /installation y se habrá creado dicho fichero /configuration.php. Simplemente tiene la clase JConfig que es un conjunto de variables. En el framework nos viene un ejemplo en /libraries/config.example.php como el siguiente:

<?php
class JConfigExample
{
 public $dbtype  = 'mysql';
 public $host  = 'localhost';
 public $user  = '';
 public $password = '';
 public $db   = '';
 public $dbprefix = 'jos_';
 public $ftp_host = '127.0.0.1';
 public $ftp_port = '21';
 public $ftp_user = '';
 public $ftp_pass = '';
 public $ftp_root = '';
 public $ftp_enable = 0;
 public $tmp_path = '/tmp';
 public $log_path = '/var/logs';
 public $mailer  = 'mail';
 public $mailfrom = 'admin@localhost.home';
 public $fromname = '';
 public $sendmail = '/usr/sbin/sendmail';
 public $smtpauth = '0';
 public $smtpsecure = 'none';
 public $smtpport = '25';
 public $smtpuser = '';
 public $smtppass = '';
 public $smtphost = 'localhost';
 public $debug  = 0;
 public $caching  = '0';
 public $cachetime = '900';
 public $language = 'en-GB';
 public $secret  = null;
 public $editor  = 'none';
 public $offset  = 0;
 public $lifetime = 15;
}

El ejemplo nos indica una forma de tener ordenadas las principales variables… En el siguiente ejemplo, he requerido el archivo de configuración de ejemplo que nos proporciona el framework para verlo como usaríamos uno nuestro:

<?php

// punto de entrada seguro
define('_JEXEC', 1);

require "libraries/import.php";
require "libraries/config.example.php";

class laWeb extends JApplicationWeb {
    protected function doExecute()
    {
        $this->setBody("<html><body>");

        $this->appendBody("<h1>Configuración de ejemplo</h1>");
 
        // crea el objeto con las configuraciones
        $conf = new JConfigExample();
                
        // lista dicho objeto
        foreach($conf as $nombre=>$valor) 
            $this->appendBody("<p><b>" . $nombre . "</b>: " . $valor . "</p>");
                                    
        $this->appendBody("</body></html>");


    }
}

JApplicationWeb::getInstance("laWeb")->execute();

En el punto de entrada seguro a Joomla, lo que se suele hacer es definir una variable, que en partes del CMS se busca y si no está declarada entonces termina la ejecución. Ésto se hace para evitar accesos directos por URL a ciertos archivos. Ésto es otro tema pero es de uso aconsejable.

La historia está en crear el objeto $conf declarado como un objeto de tipo JConfigExample, entonces en cualquier parte de nuestro programa podemos consultar los datos de configuración guardados en dicha variable $conf. En la práctica el CMS usa un objeto de tipo JConfig y se almacena para su uso posterior.

JPlatform, datos de la plataforma

Ésto es una clase destinada a guardar la información sobre la plataforma, versión del framework, nombre en clave y otros datos. Poniendo JPlatform::VARIABLE, podemos acceder a esos datos como en el ejemplo siguiente:

<?php
 
define('_JEXEC', 1);
require "libraries/import.php";

class laWeb extends JApplicationWeb {
    protected function doExecute()
    {
        $this->setBody("<html><body>");
        $this->appendBody("<h1>Información sobre la Plataforma Joomla!</h1>" .
                                        "<p>Compilación: " . JPlatform:: BUILD . "</p>" .
                                        "<p>Nombre en código: " . JPlatform:: CODE_NAME . "</p>" .
                                        "<p>Copyright: " . JPlatform:: COPYRIGHT . "</p>" .
                                        "<p>Texto del link: " . JPlatform:: LINK_TEXT  . "</p>" .
                                        "<p>Mantenimiento: " . JPlatform:: MAINTENANCE  . "</p>" .
                                        "<p>Producto: " . JPlatform:: PRODUCT  . "</p>" .
                                        "<p>Liberación: " . JPlatform:: RELEASE  . "</p>" .
                                        "<p>Fecha de liberación: " . JPlatform:: RELEASE_DATE . "</p>" .
                                        "<p>Tiempo de liberación: " . JPlatform:: RELEASE_TIME  . "</p>" .
                                        "<p>Zona de tiempo de liberación: " . JPlatform:: RELEASE_TIME_ZONE . "</p>" .
                                        "<p>Estado: " . JPlatform:: STATUS  . "</p>" );

        $this->appendBody("<p>Versión larga: " . JPlatform::getLongVersion() . "</p>" );
        $this->appendBody("</body></html>");


    }
}

JApplicationWeb::getInstance("laWeb")->execute();

Además de lo de aquí arriba también tenemos la función getShortVersion y isCompatible que devuelven una versión corta de la versión del framework que estemos usando y para comprobar si es compatible. isCompatible se usa para el CMS, para saber si es compatible el framework y el CMS.

Terminando

Los dos ejemplos anteriores los tienen en descarga aquí.

Con ésto me despido por hoy.

Saludos.

Joomla! Platform 0: Introducción

2013-05-18 - Categorías: PHP

Joomla sí, Joomla no

¿Debo usar un CMS para montar una web? ¿O más bien debo programar desde cero? La gran pregunta a la hora de hacer una web. Leo en algunos sitios que no hay que «reinventar la rueda», que ya tenemos disponibles unos CMS (gestores de contenido), que los ponemos online con un bonito diseño, rellenamos el contenido y ya tenemos lista una web. Pero ¿qué pasa a la larga con esa web si nos piden algo extraño?

Por otro lado podemos empezar desde cero, pero al final llegaremos tarde o temprano a usar herramientas que nos ahorrarán código como por ejemplo para enviar emails, generar PDFs o lo que sea que necesitemos. Al final podemos llegar a reunir tal conjunto de utilidades creando nuestro propio framework. Pudiera ser el caso de que disponemos de mucho tiempo, y llegásemos a desarrollar algunas de éstas utilidades nosotros mismos. Pero al final acabaríamos creando un CMS propio, con lo que estamos en el mismo punto en el que ya está Joomla! entonces pues lanzo la pregunta, ¿porqué no aprender y usar ya Joomla! y la Joomla!Platform?

Joomla y su Platform tienen detrás una gran comunidad que los mantiene. Algo bastante importante a tener en cuenta a la hora de elegir un framework. Casi toda la documentación que vengo encontrando está en inglés, así que manos a la obra me pongo a hacer mi versión en castellano, y la dejo aquí para el que le sea útil.

¿Hacia dónde va la Joomla!Platform?

Desde el 5 de Julio del 2011, el Joomla Framework se ha dividido del proyecto Joomla!, inagurando con su versión 11.1 de manera que ahora se llama Joomla!Platform y da pie a que su futuro no dependa directamente del desarrollo del CMS. Ya no sólo se va a usar para desarrollar el Joomla! Dará soporte al desarrollo del CMS pero también puede proporcionar utilidades que tal vez no se usen directamente en Joomla!.

Básicamente se trata de un conjunto de utilidades o librerías de programación, que podemos usar a la hora de crear un sitio. Se puede desarrollar una web completa, desde cero, pero dando saltos de gigante cada vez que uses las librerías del framework.

Materiales

Como mínimo necesitamos lo siguiente:

Archivo comprimido con el J!Platform. Hacemos click en el botón que pone Download y nos los descargamos donde vayamos a construir nuestro sitio de pruebas.
Un servidor de páginas web: Xampp para varias plataformas o Uniform Server para Windows, portable y sin instalador.
Un entorno de desarrollo, Eclipse, Notepad++, o cualquier otro para PHP o edición de webs.

Supongo que nos manejamos bien con PHP, sabemos usar el editor que tengamos instalado y sabemos lo que es un servidor de páginas web, configurarlo y poner en marcha un sitio local para hacer nuestras pruebas. En un post anterior sobre montar un servidor propio con Joomla! y Uniform Server expliqué todo ésto para Windows, así que me remito a él para más información. Si estás en Linux o Mac, las ideas principales son las mismas, cambiarás el editor y el servidor web pero el J!Platform es el mismo y su uso será igual.

Primera aplicación Hola Mundo

Al descomprimir el fichero del framework veremos que tenemos los siguientes directorio:

build/ Contiene información relevante para crear informes de la plataforma, puede haber procesos que guarden datos en éste directorio.
docs/ Documentación.
libraries/ Todas las libreriras PHP de la plataforma.
media/ Archivos que se usan en la parte cliente de la plataforma, es decir, se usan en el navegador del visitante.
tests/ Tests unitarios.

…y otros archivos sobre la plataforma.

PHP se puede usar en línea de comandos con la salida estandar o en una web que viene a ser el caso más usual. Me voy a centrar pues en su uso en web.

Entonces creamos un fichero en el directorio principal de nuesta web, habiendo descomprimido el framework en dicho directorio tambien. Una primera aplicación podría ser creando un fichero con extensión .php como el siguiente:

<?php

// punto de entrada seguro a la Joomla! Platform
//define('_JEXEC', 1);

require "libraries/import.php";

// la clase que va a implementar el sitio web
class HolaMundo extends JApplicationWeb
{
    protected function doExecute()
    {
        $this->setBody("<!DOCTYPE html>
                                        <html>
                                        <head>
                                        <title>Título de la página</title>
                                        </head>
                                        <body>
                                        <h1>Hola Mundo!</h1>
                                        </body>
                                        </html>");
    }

}

// crea el objeto si no se ha creado antes
$app = JApplicationWeb::getInstance('HolaMundo');

// ejecuta y muestra por la salida la página
$app->execute();

Puedes descargar aquí el código. Y usarlo en tu servidor web para ver el funcionamiento. Al ejecutar en el navegador ésta pequeña aplicación debemos ver algo tal que así:

Hola Mundo!

Se puede ver que simplemente descomprimiendo el fichero e importando las librerias con el require ya podemos usar J!Platform en nuestra aplicación.

Árbol de clases del Framework

Podemos ver el árbol de clases disponibles de la Joomla! Platform en http://api.joomla.org/classtrees_Joomla-Platform.html

Para hacernos una idea de los tipos de utilidades disponibles podemos ver la organización de éstos en la documentación oficial: