Posts Tagged ‘tutorial’

febrero 26, 2010 0

Tutorial de ADOdb: Parte II

By in Librerías, PHP

En el anterior tutorial vimos como conectarnos a una base de datos. Hoy veremos como realizar consultas a la base de datos. Para ello vamos a ver un ejemplo donde nos conectaremos a una base de datos, MySQL en nuestro caso, y mediante el método Execute realizaremos una consulta a la base de datos (el ejemplo es muy parecido al de la anterior parte).

<?php

include('adodb.inc.php');

$conexion = NewADOConnection('mysqli');
$conexion->Connect('localhost', 'user', 'password', 'db');

$recordSet = $conexion->Execute('SELECT user_id, user_name FROM users');

if($recordSet != false)
{
 while(!$recordSet->EOF)
 {
  echo $recordSet->fields[0].':'.$recordSet->fields[1].'<br>';
  $recordSet->MoveNext();
 }
}

?>

Lo que hacemos es conectarnos a la base de datos, como vimos en la primera parte, y después ejecutamos una consulta con el método Execute. Este método nos devuelve una instancia de la clase ADORecordSet o false si ha ocurrido algún error. Esta clase nos provee de una serie de métodos y propiedades para manejar los datos devueltos por la consulta.

Una vez hecha la consulta comprobamos si se ha ejecutado correctamente la consulta. Acto seguido realizamos un bucle while siempre que no se haya llegado al final del recordset. Para ello comprobamos la propiedad EOF que nos indica si hemos llegado o no al final.

Luego imprimimos los datos. Para acceder a los datos de cada registro hacemos uso de la propiedad fields. Esta propiedad es un array que contiene cada uno de los campos de nuestro registro. Una vez que ya hemos hecho lo que queríamos, en este caso simplemente mostrar los datos, nos desplazamos al siguiente registro con el método MoveNext de la clase ADORecordSet.

Pero también podemos realizar otro tipo de consultas, por ejemplo de inserción o de modificación de registros. Para ello hacemos uso también del método Execute de la clase ADOConnection. Veamos un ejemplo:

<?php

include('adodb.inc.php');

$conexion = NewADOConnection('mysqli');
$conexion->Connect('localhost', 'user', 'password', 'db');

if($conexion->Execute('UPDATE user_name FROM users WHERE user_id = 1'))
{
 echo "Actualización realizada.";
}
else
{
 echo "Error al actualizar";
}

?>

En este caso el método devuelve true si la consulta se realiza satisfactoriamente y false si ocurre algún error.

Paso de parámetros a las consultas

Una de las cosas que podemos hacer con el método Execute es añadirle parámetros a las consultas. Para ello tenemos que construir la consulta de una forma especial, para indicar donde están los parámetros, y pasarle al método Execute un array con el valor de dichos parámetros. Veamos como hacerlo:

$rs = $conexion->Execute('SELECT user_name FROM users WHERE user_id=?', array($user_id));

Se puede apreciar que en la consulta se ha usado el símbolo ? para indicar donde va el parámetro. Como segundo parámetro del método execute se le pasa un array con los valores, en este caso es uno solo, de los parámetros.

Se puede usar este método con más de un parámetro:

$rs = $conexion->Execute('SELECT user_name FROM users WHERE user_id=? AND user_login =?', array($user_id, $user_login));

Podemos ver también que las cadenas no deben ir entre comillas en los parámetros, pues las comillas se le añaden a posteriori.

Otros métodos de la clase ADORecordSet

Métodos que devuelven una sola fila
Método: Descripción:
FetchRow() Devuelve una fila como un array y se desplaza al siguiente registro implícitamente.  No es necesario llamar después al método MoveNext.
FetchObject($toupper=true) Devuelve una fila como un objeto, siendo cada miembro un campo del registro. Si $toupper es igual a true los nombres de los campos irán en mayúsucula. Se recomienda usar el método FetchNextObject.
FetchNextObject($toupper=true) Igual que FetchObject pero mueve el puntero de posición al siguiente registro.
FetchObj() Igual que FetchObject(false)
FetchNextObject() Igual que FetchNectObject(false)
Métodos que devuelven todas las filas
Método: Descripción:
GetArray([$numRows]) Devuelve un array bidimensional con las filas desde la posición 0 a la $numRows -1. Si no se define $numRows devuelve toda la fila.

La clase RecordSet tiene muchos más métodos que nos pueden ser útiles, pero de momento con esto es suficiente. Si se quiere ver el resto de métodos se puede ver la documentación de la clase.

Comparte esta entrada:
Delicious Digg Google Technorati Menéame Fresqui Reddit Facebook Twitter Yahoo! Buzz MySpace Email BarraPunto

Tags: , , , ,

febrero 2, 2010 0

Tutorial de ADOdb: parte I

By in Librerías, PHP

Hola de nuevo. Después de más de un mes de vacaciones blogueras, al trabajo si que he tenido que ir, volvemos a la carga con un nuevo tutorial, en este caso de ADOdb.

ADOdb es una librería para PHP para acceder a bases de datos. La ventaja de usar esta librería está en que si se cambia de base de datos, por ejemplo de MySQL a PostgreSQL, no es necesario reescribir todo el código.

Lo primero que vamos a hacer es descargar la librería de la sección de descargas. Una vez tengamos la librería vamos a ver como conectarnos a una base de datos.

Para ello vamos a ver un pequeño ejemplo:

<?php

include('adodb/adodb.inc.php'); //Incluimos la librería

$conexion = ADONewConnection('mysqli'); // Creamos una conexión con el Driver MySQLi
$conexion->connect('host', 'user', 'password', 'database_name'); //Nos conectamos a la base dedatos

$recordSet = $conexion->Execute('SELECT * FROM tabla'); //Realizamos una consulta

if(!$recordSet) //Si ha habido algun error
{
  echo $conexion->ErrorMsg(); //Mostramos el mensaje de error
}
else
{
  while(!$recordSet->EOF) //Mientras no estemos al final de RecordSet
  {
    echo $recordSet->fields[0].' - '.$recordSet->fields[1].'<br>'; //Imprimimos los datos
    $recordSet->MoveNext(); //Nos movemos al siguiente registro
  }
  $recordSet->Close(); //Cerramos el RecordSet, esto es opcional
}

$conexion->Close(); //Cerramos la conexión. Opcional.
?>

Como podemos ver lo primero que hacemos es crear una conexión. Para eso llamamos a la función ADONewConnection indicándole el driver de base de datos que queremos usar. Esta función nos devuelve un objeto ADOConnection, mediante el cual realizaremos las consultas y otras operaciones a la base de datos. Aquí podemos ver el listado de bases de datos soportadas por ADOdb.

Una vez que hemos creado nuestra conexión lo siguiente es realizar la conexión en si. El método que hemos usado es el Connect. En este caso le pasamos el host de la base de datos, el usuario, el password y el nombre de la base de datos. Además de este método de conexión hay otros dos:

  • PConnect: Crea una conexión persistente.
  • NConnect: Fuerza a realizar una nueva conexión.

Una vez que nos hemos conectado ejecutamos una consulta con el método Execute, que nos devuelve un objeto ADORecordSet, y mostramos los datos devueltos.

Con esto queda concluida esta primera parte del tutorial. En las siguientes partes hablaremos más detenidamente de la clase RecordSet y de como realizar distintas consultas a la base de datos.

Comparte esta entrada:
Delicious Digg Google Technorati Menéame Fresqui Reddit Facebook Twitter Yahoo! Buzz MySpace Email BarraPunto

Tags: , , , ,

diciembre 3, 2009 39

Tutorial de CKEditor. Parte III.

By in JavaScript, Librerías

Hoy, por petición de un lector, vamos a ver como añadir a CKEditor un navegador de archivos que nos permite subir archivos e insertar imágenes al servidor. Para ello vamos a hacer uso de CKFinder, el navegador en cuestión.

Así se ve CKFinder

Así se ve CKFinder

Lo primero que tenemos que hacer es descargarnos CKFinder y colocarlo en el mismo sitio donde tenemos la carpeta de CKEditor, aunque esto no es obligatorio si es recomendable. Para el tutorial vamos a usar la versión para PHP. Tiene que quedar de la siguiente manera:

Disposición de los archivos

Disposición de los archivos

Una vez que tenemos esto solo tenemos que incluir la librería de CKFinder y hacer que este sea el navegador y gestor de nuestros archivos. Para ello nos basta con el código siguiente (corregido gracias a los lectores):

<script type="text/javascript" src="./ckeditor/ckeditor.js"></script>
<script type="text/javascript" src="./ckfinder/ckfinder.js"></script>
<script type="text/javascript">
window.onload = function()
{
 editor = CKEDITOR.replace('editor');
 CKFinder.setupCKEditor( editor, '/ckfinder/' );
}
</script>

De esta forma usamos CKFinder para que nos configure el editor, sin tener que tocar la configuración de este. Hay también métodos para hacer mediante la configuración de CKEditor, pero son más complejos y esto tampoco es un tutorial extensivo.

Así se ve el Pop Up de imagen

Así se ve el Pop Up de imagen

Si probamos esto veremos que no funciona, que nos da un error de configuración. Para solucionar esto tenemos que editar el archivo config.php. Buscaremos una función que se llama CheckAuthentication. Esta función devuelve true si el usuario tiene permiso para usar CKFinder y false si no lo tiene. Como podemos ver por defecto devuelve false. Aquí deberiamos comprobar si el usuario ha iniciado sesión, los permisos o roles que tiene asignado, etcétera; y en función de esto devolver lo que corresponda. Para hacer la prueba vamos simplemente a hacer que devuelva true:

function CheckAuthentication()
{
return true;
}

Ahora si nos dejará tanto subir archivos como seleccionar estos una vez subidos.

Comparte esta entrada:
Delicious Digg Google Technorati Menéame Fresqui Reddit Facebook Twitter Yahoo! Buzz MySpace Email BarraPunto

Tags: , ,

noviembre 18, 2009 18

Tutorial de CKEditor. Parte II.

By in JavaScript, Librerías

En la primera parte del tutorial vimos las distintas formas de configurar CKEditor. Hoy vamos a ver como configurar la barra de herramientas.

Para configurar la barra de herramientas tenemos dos formas:

  • Asignar a la propiedad toolbar una definición de la barra de herramientas.
  • Crear una propiedad toolbar_name con la definición de la barra de herramientas y posteriormente asignar a la propiedad toolbar el literal ‘name’.

Vamos a ver un ejemplo, con el segundo método, de creación de una barra de herramientas:

config.toolbar = 'Full';

config.toolbar_Full =
[
    ['Source','-','Save','NewPage','Preview','-','Templates'],
    ['Cut','Copy','Paste','PasteText','PasteFromWord','-','Print', 'SpellChecker', 'Scayt'],
    ['Undo','Redo','-','Find','Replace','-','SelectAll','RemoveFormat'],
    ['Form', 'Checkbox', 'Radio', 'TextField', 'Textarea', 'Select', 'Button', 'ImageButton', 'HiddenField'],
    '/',
    ['Bold','Italic','Underline','Strike','-','Subscript','Superscript'],
    ['NumberedList','BulletedList','-','Outdent','Indent','Blockquote'],
    ['JustifyLeft','JustifyCenter','JustifyRight','JustifyBlock'],
    ['Link','Unlink','Anchor'],
    ['Image','Flash','Table','HorizontalRule','Smiley','SpecialChar','PageBreak'],
    '/',
    ['Styles','Format','Font','FontSize'],
    ['TextColor','BGColor'],
    ['Maximize', 'ShowBlocks','-','About']
];

Con esto definimos una barra de herramientas muy completa. Como vemos la barra de herramientas es un array donde cada elemento es o bien un array o bien el literal ‘/’. Si el elemento es un array cada elemento es un botón. Si en lugar de un array nos encontramos con el carácter ‘/’ este fuerza un salto en la barra de herramientas, es decir nos crea una nueva barra debajo de la anterior.

Dentro de la definición de cada uno de los bloques de botones podemos encontrar el identificador de cada uno de los botones o el carácter ‘-‘ que nos crea un espacio en blanco.

La definición de la barra de herramientas debe ir en el archivo de configuración, o bien en el por defecto o en uno propio, explicado en el artículo anterior.

Podemos si lo queremos crear la barra de herramientas al crear la instancia de esta forma:

CKEDITOR.replace( 'editor1',
    {
        toolbar :
        [
            ['Styles', 'Format'],
            ['Bold', 'Italic', '-', 'NumberedList', 'BulletedList', '-', 'Link', '-', 'About']
        ]
    });

Como se puede ver es bastante sencillo configurar la barra de herramientas a nuestro gusto. Si teneis alguna duda intentaré resolverla en los comentarios.

Comparte esta entrada:
Delicious Digg Google Technorati Menéame Fresqui Reddit Facebook Twitter Yahoo! Buzz MySpace Email BarraPunto

Tags: , , , ,

noviembre 16, 2009 4

Tutorial de CKEditor. Parte I.

By in JavaScript, Librerías

Hace ya bastante tiempo se comenzó en este blog un tutorial sobre FCKEditor, uno de los muchos editores WYSIWYG que hay, pero se dejó abandonado. Varias fueron las razones, principalmente la falta de tiempo y la salida de CKEditor.

Después de un tiempo en el tintero, y gracias a un comentario de un lector, me he decidido a comenzar un tutorial introductorio a CKEditor. Puede servirnos como introducción el artículo “Probando CKEditor” donde se da un vistazo rápido a esta herramienta.

Lo primero que vamos a ver es como configurar nuestro editor. Para ello tenemos tres opciones:

  • Definir la configuración al crear el editor.
  • Usar el archivo config.js para colocar la configuración en este.
  • Crear nuestro propio archivo de configuración.

Definir la configuración al crear el editor:

Cuando creamos una instancia del editor con el método replace podemos indicarle la configuración de este. De esta forma nos evitamos tener que tocar la instalación del editor. Veamos como se haría:

CKEDITOR.replace( 'editor1',
    {
        toolbar : 'Basic',
        uiColor : '#9AB8F3'
    });

Hay que tener en cuenta que lo que se pasa a la función es la definición literal de un objeto, por lo que tendremos que usar la sintaxis parametro : valor, y tener cuidado de no usar el símbolo “igual que” (=).

Usar el archivo config.js para colocar la configuración:

Si editamos el archivo config.js, en la misma carpeta donde está ckeditor.js, veremos que hay una función llamada CKEDITOR.editorConfig. Dentro de esta tendremos que colocar los valores de configuración que deseemos.

CKEDITOR.editorConfig = function( config )
{
    config.language = 'fr';
    config.uiColor = '#AADC6E';
};

Definir la configuración en nuestro propio archivo:

En este caso nos crearemos un archivo donde colocaremos la configuración. De esta forma no tenemos que modificar la instalación de CKEditor y támpoco tendremos que tocar nuestras páginas, tan solo el archivo de configuración. Dentro de él definiremos la función CKEDITOR.editorConfig, podemos por ejemplo copiar el config.js como base, y luego indicaremos al editor donde se encuentra este archivo de la siguiente manera:

CKEDITOR.replace( 'editor1',
    {
        customConfig : '/custom/ckeditor_config.js'
    });

Conclusiones:

Como hemos podido ver el editor nos ofrece varias formas para configurarlo, dependiendo de nuestras necesidades o nuestros gustos. Personalmente me gusta más la tercera, aunque cada cual es libre de hacerlo a su manera.

Espero que esta primera parte les haya sido de ayuda pues esta es la base para customizar nuestro editor. Hasta la próxima entrega del tutorial, que espero pueda tenerla lista para el miércoles.

Comparte esta entrada:
Delicious Digg Google Technorati Menéame Fresqui Reddit Facebook Twitter Yahoo! Buzz MySpace Email BarraPunto

Tags: , , , ,