Tema 8 PHP: Acceso a Bases de Datos Una de las razones por las que más se ha popularizado PHP, como ya comentamos en el tema anterior, es su posibilidad de conexión con casi todos los tipos de bases de datos. En este tema vamos a ver algunas nociones de MySQL: instalación y configuración rápida, organización, etc. La razón de ver MySQL es porque se trata de base de datos más usada con PHP, incluso se podría decir que es la base de datos propia de PHP, pues al parecer, PHP Group desarrolla en primera instancia para esta base de datos y después migra el trabajo a las librerías de acceso a otras bases de datos. Otra librería de acceso a bases de datos interesante es la de acceso a través de ODBC que nos abre el camino a la conexión a cualquier otro tipo de base de datos de la que no se tenga acceso nativo en PHP. También puede ser interesante usar el acceso ODBC para las bases de datos de las que se tiene funciones PHP directamente, pues, aunque aparentemente más complejo y aveces más limitado, el acceso ODBC nos garantiza cierta compatibilidad que prácticamente nos independiza del SGDB que se use. Así pues, en este tema vamos a trabajar sobre tres ejemplos de acceso a bases de datos MySQL y dos ejemplos ODBC en el que podremos trabajar tanto con MySQL como con otras bases de datos como MS-Access. 8.1. De vuelta con PHP Vamos en primera instancia a retomar algunos de los ejemplos PHP del tema anterior para ir calentando motores. En concreto, con idea de seguir con los ejemplos auto-ilustrativos del Tema 7, vamos a fusionar el ejemplo generico.php y ejemplos.php de forma que un solo código nos gestione una plantilla genérica y nos permita elegir y ejecutar los ejemplos de este tema, que a semejanza del caso anterior están en el directorio: "C:\Archivos de programa\apache Group\Apache\cgi-bin\tema8" La plantilla.phtml usada ahora se ha adaptado para este tema: Visualiza a la izquierda el código, a la derecha un formulario y encima de la tabla el posible resultado producido al invocar el formulario. La nueva plantilla se llama ahora: "C:\Archivos de programa\apache Group\Apache\htdocs\tema8\index.phtml" La idea es la de adaptar Apache para que también pueda tomar como página por defecto de un sitio Web ese nombre de fichero, cambiando en httpd.conf la siguiente línea: DirectoryIndex index.html por esta otra: DirectoryIndex index.html index.phtml Recuerda arrancar Apache.
Listado 8.1. C:\Archivos de programa\apache Group\Apache\htdocs\tema8\index.phtml Plantilla de ejemplos del Tema 8. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <?php include "tema8/ejemplos.php"?> <HTML> <HEAD> <TITLE> <?php titulo()?> </TITLE> </HEAD> <BODY> <CENTER> <H1 style="font-weight:bold; font-size:200%; color:blue"> <?php titulo()?> </H1> <?php resultado()?> <TABLE width="100%" border="1" rules="all"> <TR align="center"> <TD> <B>Código</B><BR> </TD> <TD> <B>Formulario</B><BR> </TD> </TR> <TR valign="top"> <TD> <?php codigo()?> </TD> <TD> <?php formulario()?> </TD> </TR> </TABLE> </CENTER> </BODY> </HTML> El esquema es semejante al usado en el tema 7, pero hay que destacar que la función resultado ha sido sustituida por una formulario y una nueva función resultado debe reflejar en la parte superior el resultado de enviar el formulario. La función formulario invocará a una función del mismo nombre que el ejemplo que se esté visualizando, como antes hacia la función resultado. El código del nuevo ejemplo ejemplos.php queda así: Listado 8.2. C:\Archivos de programa\apache Group\Apache\cgi-bin\tema8\ejemplos.php Programa que permite seleccinar uno de los ejemplos del Tema 8. if (!isset($ejemplo)) $Ejemplo="Ejemplos"; $Fichero=strToLower("tema8/$Ejemplo.php"); @include_once($fichero); if (!function_exists("titulo")) { function titulo() { global $Ejemplo; print($ejemplo); if (!function_exists("resultado")) { function resultado() { function codigo() { global $Ejemplo; global $Fichero; if (@show_source($fichero)) { function formulario() { 2
global $Ejemplo; $Ejemplo(); else print(" $Ejemplo.php?"); function ejemplos() { global $REQUEST_URI; include("tema8/plantillas/ejemplos.html"); function opciones() { $Directorio=openDir(get_cfg_var("include_path")."/tema8/"); while ($Fichero=readDir($Directorio)) { $Fichero=ucFirst(strToLower($Fichero)); list($ejem,$ext)=explode(".",$fichero); if ($Ejem AND!strCaseCmp($Ext,"php")) print("<option>$ejem</option>\n"); closedir($directorio); A destacar únicamente dos puntos. Lo primero que si la función resultado no existe (porque el ejemplo no hace nada cuando se envía el formulario), para que no se produzca error al invocarla, se crea vacía. Lo segundo, el formulario que debería estar en la función con el mismo nombre que el fichero (ejemplos() en este caso) no esta en este fichero, sino aparte, en un fichero con extensión.html, que aunque no es verdaderamente un fichero HTML, puede ser medianamente interpretado por un navegador o un programa de diseño HTML, de forma que se puede ver y cambiar independientemente del código, es decir se trata de una plantilla. Así pues, la función que muestra el formulario queda reducida a declarar como globales todas las variables que se usen en la plantilla.html e incluirla. Este esquema se repite en todos los ejemplos de este tema. El directorio que contiene las plantillas.html de los formularios es: "C:\Archivos de programa\apache Group\Apache\cgi-bin\tema8\plantillas" Puedes ver el aspecto que tienen estas plantillas cargándolas desde tu disco local directamente (no a través del servidor Apache) con tu navegador. La plantilla que usamos en este invocador de ejemplos es: Listado 8.3. C:\Archivos de Group\Apache\cgi-bin\tema8\plantillas\ejemplos.html Plantilla formulario para seleccionar ejemplos. <FORM action="<?=$request_uri?>" method="post"> <CENTER> <LABEL> <B>Ejemplos:</B><BR> <SELECT name="ejemplo"> <?php opciones()?> </SELECT> </LABEL><BR> <INPUT type="submit" value="mostrar"> </CENTER> </FORM> Ahora puedes ver el resultado, invocar a cualquier ejemplo de este tema se hace con la URL: http://localhost/tema8 3
8.2. MySQL Monty Widenius quiso trabajar con APIs a bajo nivel de msql, comprobó que no eran suficientemente rápidas y decidió crear sus propias APIs MySQL. Así nació MySQL, una base de datos SQL (Structured Query Language) muy rapida, multi-hebra, multi-usuario y robusta según sus propios autores. Se trata, además, de un software gratuito licenciado bajo la General Public License de GNU. Instalación El primer paso que debemos dar es descargar la última versión desde http://www.mysql.com. Las distribuciones de binarios para Win32 siempre han sido tradicionalmente shareware. En el momento de editar estas páginas, se encuentra disponible una versión 3.23.28-gamma totalmente gratuita. El segundo paso es la descompresión del paquete y su instalación, ejecutando programa setup que aparece al descomprimir. La instalación compacta es suficiente para nuestro caso y para la mayoría de usuarios de MySQL que lo ejecuten sobre Win32. Si no le hemos indicado lo contrario el instalador nos habrá creado un directorio C:\mysql, con varios ficheros y subdirectorios. Los importantes son estos tres subdirectorios: C:\mysql\docs Contiene documentación sobre MySQL. Lo más interesante es el manual, accesible en HTML desde el fichero C:\mysql\docs\manual_toc.html. C:\mysql\data Por defecto almacena las bases de datos, en un subdirectorio cada una (con el mismo nombre que la base de datos). La distribución instala por defecto dos, la del sistema del propio servidor que se llama mysql y otra test, pero esta última está vacía. En subdirectorio correspondiente a la base de datos del sistema (mysql) se puede apreciar que MySQL guarda tres ficheros por cada tabla, con el mismo nombre que la tabla pero distintas extensiones: El formato se guarda en los ficheros.frm, los datos en los.myd y la información para gestionar el acceso por indices en los.myi. Las tablas de mysql son 5: user, host, db, tables_priv y columns_priv. C:\mysql\bin Este directorio guarda los ejecutables: Demonios servidores, clientes, gestores y herramientas de test, administración y mantenimiento. Algunos de ellos son sólo para Windows NT o sólo para Windows 9x. El único que de momento nos interesa es winmysqladmin.exe, que lo ejecutaremos para comprobar la instalación y arrancar el servidor: WinMySQLadmin Cuando lo ejecutamos por primera vez nos pregunta por un usuario y clave para establecerlos como defecto. Esto lo hace por que detecta que no existe el fichero de configuración: C:\windows\my.ini En la documentación se explica como incluir distintas opciones en este fichero. Si le damos a cancelar y no introducimos ningún usuario y clave, creará un fichero my.ini con las opciones mínimas. No te tiene que preocupar no proporcionar usuario por defecto, pues la base de datos del sistema (la mysql que hemos visto en el directorio data) viene preparada inicialmente para 4
operar con cualquier usuario. Sin embargo el dar a cancelar también implica que no incluya un enlace directo a winmysqladmin.exe en el menú de inicio que producirá el arranque automático de este programa al iniciar una sesión en Windows. Puede ser interesante que copies o muevas ese enlace directo a otro menú, uno propio del MySQL, para poderlo invocar voluntariamente. Después, el programa WinMySQLadmin se quedará residente. Lo puedes apreciar por un semáforo con la luz verde que aparece a la derecha de la barra de tareas. Este semáforo tiene la luz verde cuando el servidor de MySQL se encuentra en marcha y rojo si está parado. El programa WinMySQLadmin no es el servidor, sino un programa que sirve para arrancar, parar y monitorizar al servidor. Éstas son las opciones que aparecen al solicitar el menú contextual sobre icono del semáforo, además de la opción de parar esta propia herramienta, que no implica parar el servidor MySQL. En conclusión, aunque esta herramienta nos permita curiosear el funcionamiento del servidor, principalmente servirá para poder arrancar y parar el servidor MySQL y comprobar mediante la luz del semáforo si está en marcha. Acceso a MySQL Otro programa llamado simplemente mysql (aparece también e el directorio C:\mysql\bin) es el típico interprete SQL de línea de comandos. Invócalo para ver alguna tabla de la base de datos del sistema (la mysql): C:\>C:\mysql\bin\mysql.exe mysql Ahora prueba a listar la tabla de usuarios y permisos: mysql> select * from user; Lo que estas viendo significa algo así como: El usuario root tiene todos los privilegios posibles desde la máquina localhost. Cualquier usuario desde cualquier máquina no tiene ningún privilegio. Cualquier usuario desde localhost tiene todos los privilegios. El usuario root desde cualquier máquina tiene todos los privilegios. Es posible que aparezca otra fila con el usuario y clave que te pidió WinMySQLadmin. Acceso a MySQL mediante PHP Vamos a intentar visualizar la misma tabla de usuarios que hemos visto mediante el interprete SQL, pero a través de nuestro servidor Apache y un programa PHP. Para ello vamos a ver un ejemplo de visor de tablas: un formulario recoge máquina, usuario, base de datos y tabla, y mediante las funciones PHP de acceso a MySQL visualizamos la tabla. La plantilla del formulario será: Listado 8.4. C:\Archivos de Group\Apache\cgi-bin\tema8\plantillas\visor.html Plantilla formulario para el visor. <FORM action="<?=$request_uri?>" method="post"> <INPUT type="hidden" name="ejemplo" value="<?=$ejemplo?>"> <TABLE> <TD><B>Host:</B></TD> <TD><INPUT type="text" name="host" value="localhost"></td> 5
<TD><B>Usuario:</B></TD> <TD><INPUT type="text" name="usuario" value="root"></td> <TD><B>Base de datos:</b></td> <TD><INPUT type="text" name="bd"></td> <TD><B>Tabla:</B></TD> <TD><INPUT type="text" name="tabla"></td> <INPUT type="submit" name="visualizar" value="visualizar"> <INPUT type="submit" value="limpiar"></center> </TABLE> </FORM> Lo primero que nuestro programa debe hacer es conectarse a un servidor MySQL en una máquina $Host como el usuario $Usuario, después seleccionar la base de datos $BD, lanzar la pregunta SQL que obtendrá la selección de las filas de la tabla $Tabla y por último interpretar el resultado: Listado 8.5. C:\Archivos de programa\apache Group\Apache\cgi-bin\tema8\visor.php Visor de tablas MySQL. function visualizar($host,$usuario,$bd,$tabla) { if (!mysql_connect($host,$usuario)) print("<p>error al conectar con $Host como $Usuario</P>"); elseif (!mysql_select_db($bd)) print("<p>error al seleccionar la base de datos $BD</P>"); elseif (!$Cursor=mysql_query("SELECT * FROM $Tabla")) print("<p>error al obtener cursor a tabla $Tabla</P>"); else { print("<table border=\"1\" rules=\"all\">\n"); print("<tr>\n"); for ($i=0;$i<mysql_num_fields($cursor);$i++) print("<th>".mysql_field_name($cursor,$i)."</th>\n"); print("</tr>\n"); while ($Fila=mysql_fetch_row($Cursor)) { print("<tr>\n"); foreach ($Fila as $Campo) print("<td>$campo</td>\n"); print("</tr>\n"); print("</table><br>\n"); function resultado() { global $Visualizar,$Host,$Usuario,$BD,$Tabla; if (isset($visualizar)) { print("<p><b>host:</b> $Host "); print("<b>usuario:</b> $Usuario "); print("<b>base de datos:</b> $BD "); print("<b>tabla:</b> $Tabla</P>\n"); visualizar($host,$usuario,$bd,$tabla); function visor() { global $REQUEST_URI,$Ejemplo; include("tema8/plantillas/visor.html"); La función mysql_connect(), de ser satisfactoria, devuelve un enlace a la base de datos. Este enlace debería ser pasado a las funciones mysql_select_db() y mysql_query(), pero ese parámetro es opcional, en caso de no hacerlo, se toma como enlace, la última conexión hecha, que en nuestro caso se trata de la única conexión hecha. La función mysql_query() devuelve un recurso, que puede ser interpretado en este caso como un cursor, del que poder extraer la información requerida en la pregunta. Son varias las 6
funciones que pueden extraer información de un recurso devuelto por mysql_query(), y distintas las formas o estrategias para interpretarlo: Mediante la función mysql_fetch_object() se puede obtener un objeto por fila cuyos atributos son los campos de la tabla. Mediante la función mysql_fetch_array() se pude obtener un array por fila cuyas claves sean los campos de la tabla, sus posiciones o ambas cosas. mysql_fecth_row() es un caso particular del anterior, el array siempre esta indexado por posiciones (empezando por la 0). Se puede acceder a cualquier fila y columna de la tabla mediante la función mysql_result(). Además es posible acceder a otra información sobre la respuesta, como el nombre los campos de la tabla o que cantidad de filas o columnas hay. En el ejemplo se usan las funciones myql_num_fields() y mysql_filed_name(). Esto nos permite poder visualizar los nombres de los campos en la cabecera de la tabla incluso cuando la tabla esta vacía: No pruebes solo la tabla user de la base de datos mysql, prueba también con una tabla vacía como tables_priv de la misma base de datos. 8.3. Manejo de bases de datos MySQL desde PHP Para poder ilustrar gran parte de las posibilidades de edición de las funciones PHP de acceso a MySQL, vamos a ver dos ejemplos más. El primero para poder crear una base nueva con la que experimentar (crear tablas, campos, modificarlos, borrar, etc.). El segundo, combinándolo con el manejo de sesiones nos permitirá editar (añadir, modificar y borrar) fila a fila en una base de datos. Gestor de base de datos (manejo de la estructura) En este ejemplo vamos a usar tres formularios distintos, dependiendo del nivel de atomicidad al que llevemos la gestión (base de datos, tabla o campo): Listado 8.6. C:\Archivos de Group\Apache\cgi-bin\tema8\plantillas\gesbd.html Plantilla formulario para el gestor en gestion a bases de datos. <FORM action="<?=$request_uri?>" method="post"> <INPUT type="hidden" name="ejemplo" value="<?=$ejemplo?>"> <INPUT type="hidden" name="gestion" value="<?=$gestion?>"> <TABLE> <TD><B>Host:</B></TD> <TD><INPUT type="text" name="host" value="<?=$host?>"></td> <TD><B>Usuario:</B></TD> <TD><INPUT type="text" name="usuario" value="<?=$usuario?>"></td> <TD><B>Base de datos:</b></td> <TD><INPUT type="text" name="bd"></td> <INPUT type="submit" name="operacion" value="crear"> <INPUT type="submit" name="operacion" value="conectar"> <INPUT type="submit" name="operacion" value="eliminar"></center> </TABLE> </FORM> 7
La variable $Gestion informará de que gestión se lleva a cabo (base de datos, tabla o columna), mientras $Operacion indica si se debe crear, eliminar, etc. Listado 8.7. C:\Archivos de Group\Apache\cgi-bin\tema8\plantillas\gestabla.html Plantilla formulario para el gestor en gestion a tablas. <FORM action="<?=$request_uri?>" method="post"> <INPUT type="hidden" name="ejemplo" value="<?=$ejemplo?>"> <INPUT type="hidden" name="gestion" value="<?=$gestion?>"> <INPUT type="hidden" name="host" value="<?=$host?>"> <INPUT type="hidden" name="usuario" value="<?=$usuario?>"> <INPUT type="hidden" name="bd" value="<?=$bd?>"> <TABLE> <TD><B>Tabla:</B></TD> <TD><CENTER><SELECT name="tabla"> <?php tablas($bd)?> </SELECT></CENTER></TD> <INPUT type="submit" name="operacion" value="cambiar"> <INPUT type="submit" name="operacion" value="eliminar"></center> <B>o</B></CENTER> <TD><B>Tabla:</B></TD> <TD><INPUT type="text" name="nueva"></td> <INPUT type="submit" name="operacion" value="crear"></center> </TABLE> </FORM> Las variables del formulario anterior en este se mantienen ocultas. La variable $Nueva llevará el nombre de la tabla si se trata de una operación Crear. Listado 8.8. C:\Archivos de Group\Apache\cgi-bin\tema8\plantillas\gescampo.html Plantilla formulario para el gestor en gestion a campos. <FORM action="<?=$request_uri?>" method="post"> <INPUT type="hidden" name="ejemplo" value="<?=$ejemplo?>"> <INPUT type="hidden" name="gestion" value="<?=$gestion?>"> <INPUT type="hidden" name="host" value="<?=$host?>"> <INPUT type="hidden" name="usuario" value="<?=$usuario?>"> <INPUT type="hidden" name="bd" value="<?=$bd?>"> <INPUT type="hidden" name="tabla" value="<?=$tabla?>"> <TABLE> <TD><B>Campo:</B></TD> <TD><CENTER><SELECT name="campo"> <?php campos($bd,$tabla)?> </SELECT></CENTER></TD> <INPUT type="submit" name="operacion" value="eliminar"></center> <B>o</B></CENTER> <TD><B>Campo:</B></TD> <TD><INPUT type="text" name="nuevo"></td> <TR><TD> <LABEL><INPUT type="radio" name="tipo" value="int" checked>entero</label> <TR><TD> <LABEL><INPUT type="radio" name="tipo" value="varchar">cadena</label> </TD><TD><CENTER> 8
<LABEL>Longitud: <INPUT type="text" name="longitud" size="2"></label> </CENTER> <INPUT type="submit" name="operacion" value="añadir"></center> </TABLE> </FORM> A la hora de añadir un campo, las variable $Nuevo y $Tipo aportan el nombre y el tipo respectivamente. Solo se permiten dos tipos de datos (para simplificar), el entero y la cadena. En este segundo tipo otra variable $Longitud aporta el número máximo de caracteres. También por simplificar, no se puede cambiar de tipo un campo, ha de eliminarse y añadirse de nuevo. Listado 8.9. C:\Archivos de programa\apache Group\Apache\cgi-bin\tema8\gestor.php Gestor de bases de datos MySQL. function resultado() { global $Host,$Usuario,$BD,$Tabla,$Campo; global $Gestion,$Operacion; if (isset($gestion)) { // Si se ha solicitado una gestion... if (mysql_connect($host,$usuario)) { // se conecta y gestiona $Gestion=$Gestion($Operacion,$BD,$Tabla,$Campo); if ($Gestion!="gestionBD") { // Se muestran los datos print("<p><b>host:</b> $Host "); print("<b>usuario:</b> $Usuario "); print("<b>base de datos:</b> $BD "); if ($Gestion!="gestionTabla") print("<b>tabla:</b> $Tabla"); print("</p>\n"); else { print("<p>error al conectar con $Host como $Usuario</P>\n"); $Gestion="gestionBD"; else { $Gestion="gestionBD"; $Host="localhost"; $Usuario="root"; function gestionbd($operacion,$bd) { // Para base de datos switch ($Operacion) { case "Crear": // - o se crea: if (!mysql_create_db($bd)) { print("<p>error al crear la base de datos $BD</P>\n"); return("gestionbd"); case "Conectar": // - o entra en la BD if (!mysql_select_db($bd)) { print("<p>error al seleccionar la base de datos $BD</P>\n"); return("gestionbd"); return("gestiontabla"); case "Eliminar": // - o se elimina if (!mysql_drop_db($bd)) print("<p>error al eliminar la base de datos $BD</P>\n"); default: return("gestionbd"); function tablas($bd) { // Lista las tablas de una BD como opciones $Cursor=mysql_list_tables($BD); for ($i=0;$i<mysql_num_rows($cursor);$i++) print("<option>".mysql_tablename($cursor,$i)."</option>\n"); function gestiontabla($operacion,$bd,&$tabla) { // Para tabla global $Nueva; if (!mysql_select_db($bd)) { // Entra en la base de datos print("<p>error al seleccionar la base de datos $BD</P>\n"); 9
return("gestionbd"); if ($Operacion=="Eliminar") { // Elimina tabla o... if (!mysql_query("drop TABLE $Tabla")) print("<p>error al eliminar la tabla $Tabla</P>"); return("gestiontabla"); if ($Operacion=="Crear") { //... crea tabla if (!mysql_query("create TABLE $Nueva (id INT)")) { print("<p>error al crear la tabla $Nueva</P>"); return("gestiontabla"); $Tabla=$Nueva; return("gestioncampo"); function campos($bd,$tabla) { // Lista los campos de una tabla $Cursor=mysql_list_fields($BD,$Tabla); for ($i=0;$i<mysql_num_fields($cursor);$i++) print("<option>".mysql_field_name($cursor,$i)."</option>\n"); function gestioncampo($operacion,$bd,$tabla,$campo) { // Para campo global $Nuevo, $Tipo, $Longitud; if (!mysql_select_db($bd)) { // Entra en la base de datos print("<p>error al seleccionar la base de datos $BD</P>\n"); return("gestionbd"); if ($Operacion=="Eliminar") // Elimina campo o... if (!mysql_query("alter TABLE $Tabla DROP COLUMN $Campo")) print("<p>error al eliminar el campo $Campo</P>"); if ($Operacion=="Añadir") { //... añade campo if ($Tipo=="VARCHAR") $Tipo="$Tipo($Longitud)"; if (!mysql_query("alter TABLE $Tabla ADD COLUMN $Nuevo $Tipo")) print("<p>error al añadir el campo $Nuevo tipo $Tipo</P>"); return("gestioncampo"); function gestor() { global $REQUEST_URI,$Ejemplo,$Gestion; global $Host,$Usuario,$BD,$Tabla; if ($Gestion=="gestionCampo") // Seleciona formulario include("tema8/plantillas/gescampo.html"); elseif ($Gestion=="gestionTabla") include("tema8/plantillas/gestabla.html"); else include("tema8/plantillas/gesbd.html"); La variable $Gestion almacena el nombre de la función que debe realizar la gestión: gestionbd(), gestiontabla(), o gestioncampo(). Todas las gestiones son llamadas con el máximo de parámetros, aunque a algunas no les hace falta tantos. La función gestionbd() crea y destruye tablas con las funciones mysql_create_db() y mysql_drop_db() respectivamente. La función gestiontabla() destruye y crea tablas con las instrucciones DROP TABLE y CREATE TABLE de SQL. La función gestioncampo() elimina y añade campos con la instrucción ALTER TABLE de SQL. Las funciones tablas() y campos() listan en los formularios, como opciones, las tablas de una base de datos y los campos de una tabla. Para ello utilizan funciones para extraer información sobre la estructura de la base de datos como mysql_list_tables() y mysql_list_fields(). 10
Puedes probarlo creando nuevas bases de datos y/o eliminándolas después. Además puedes verificar los cambios que produces con el interprete de SQL (mysql) o con el visor del ejemplo anterior. Editor de base de datos (manejo de los datos) Vamos a ver otro ejemplo con el que poder rellenar de datos las bases de datos creadas con el anterior. La edición la haremos por fila, pudiendo pasar de una fila a otra para su edición. Esto supone establecer sesiones que nos guarden información sobre que fila de que tabla y base de datos estamos editando. El directorio de datos para las sesiones es, como en otros temas anteriores, el subdiretorio datos: C:\Archivos de programa\apache Group\Apache\cgi-bin\tema8\datos La edición consistirá en modificar o borrar la fila actual o añadir una nueva al final, por esa razón, siempre se dejará editar una fila de más en blanco al final de la tabla. Las plantillas formulario para este ejemplo son dos, una para seleccionar una tabla y otra para editar una fila: Listado 8.10. C:\Archivos de Group\Apache\cgi-bin\tema8\plantillas\editabla.html Plantilla formulario para el editor en selección de tabla. <FORM action="<?=$request_uri?>" method="post"> <INPUT type="hidden" name="ejemplo" value="<?=$ejemplo?>"> <TABLE> <TD><B>Host:</B></TD> <TD><INPUT type="text" name="host" value="<?=$host?>"></td> <TD><B>Usuario:</B></TD> <TD><INPUT type="text" name="usuario" value="<?=$usuario?>"></td> <TD><B>Base de datos:</b></td> <TD><INPUT type="text" name="bd" value="<?=$bd?>"></td> <TD><B>Tabla:</B></TD> <TD><INPUT type="text" name="tabla" value="<?=$tabla?>"></td> <INPUT type="submit" name="operacion" value="editar"></center> </TABLE> </FORM> Listado 8.11. C:\Archivos de Group\Apache\cgi-bin\tema8\plantillas\edifila.html Plantilla formulario para el editor en edición de fila. <FORM action="<?=$request_uri?>" method="post"> <INPUT type="hidden" name="ejemplo" value="<?=$ejemplo?>"> <TABLE> <?php campos($cursor,$fila)?> <INPUT type="submit" name="operacion" value="<?=boton('añadir')?>"> <INPUT type="submit" name="operacion" value="<?=boton('modificar')?>"> <INPUT type="submit" name="operacion" value="<?=boton('borrar')?>"> </CENTER> <INPUT type="submit" name="operacion" value="<?=boton('<<')?>"> <INPUT type="submit" name="operacion" value="<?=boton('<')?>"> <INPUT type="submit" name="operacion" value="salir"> 11
<INPUT type="submit" name="operacion" value="<?=boton('>')?>"> <INPUT type="submit" name="operacion" value="<?=boton('>>')?>"> </CENTER> </TABLE> </FORM> La función boton() determina si el botón queda habilitado o deshabilitado. Lamentablemente, esta funcionalidad de habilitar o deshabilitar controles no la reflejan correctamente todos los navegadores. El código es el siguiente: Listado 8.12. C:\Archivos de programa\apache Group\Apache\cgi-bin\tema8\editor.php Editor de bases de datos MySQL. session_save_path("../../cgi-bin/tema8/datos"); // Antes que nada: session_start(); // Inicia o restablece sesion: if (!sizeof($http_session_vars)) { // Si inicia, da valores $Host="localhost"; // iniciales a Host y $Usuario="root"; // Usuario y registra session_register("host","usuario"); // todas las variables a session_register("bd","tabla","fila"); // conservar en sesion else // Si restablece,... foreach ($HTTP_POST_VARS as $Variable => $Valor) if (session_is_registered($variable)) // sobrescribe con los ${$Variable=$Valor; // valores de formulario function resultado() { global $Operacion,$Host,$Usuario; global $BD,$Tabla,$Cursor; if (isset($operacion) AND $Operacion!="Salir") if (!mysql_connect($host,$usuario)) print("<p>error al conectar con $Host como $Usuario</P>\n"); elseif (!mysql_select_db($bd)) print("<p>error al seleccionar la base de datos $BD</P>"); elseif (!$Cursor=mysql_query("SELECT * FROM $Tabla")) print("<p>error al obtener cursor a tabla $Tabla</P>"); else { print("<p><b>host:</b> $Host "); // Informa de conexion, print("<b>usuario:</b> $Usuario "); // base de datos y print("<b>base de datos:</b> $BD "); // tabla con la que print("<b>tabla:</b> $Tabla</P>\n"); // operar return; $Operacion="Salir"; function campos($cursor,$fila) { // Muestra los campos de la fila $Tope=mysql_num_rows($Cursor); // corespondiente en formulario: print("<tr><td colspan=\"2 \"><CENTER>".($Fila+1)); print(" de ".$Tope."</CENTER>\n"); for ($i=0;$i<mysql_num_fields($cursor);$i++) { $Campo=mysql_field_name($Cursor,$i); print("<tr><td><b>$campo: </B></TD><TD><CENTER>"); print("<input type=\"text\" name=\"_${campo_\""); if ($Fila<$Tope) print(" value=\"".mysql_result($cursor,$fila,$i)."\""); print("></td></center>\n"); function boton($tipo) { global $Cursor,$Fila; print("$tipo"); switch ($Tipo) { case "Añadir"; if ($Fila==mysql_num_rows($Cursor)) return; break; case "<": case "<<": if ($Fila>0) return; break; // Determina que botones deben // o no estar deshabilitados. 12
case "Modificar": case "Borrar": case ">": case ">>": if ($Fila<mysql_num_rows($Cursor)) return; print("\" disabled \""); function operar($operacion,&$cursor,$tabla,&$fila) { switch ($Operacion) { // Determina, segun la operacion, case "Salir": // incrementar o decrementar la return(false); // fila y hacer la operacion case "<": // corespondiente. if (--$Fila>=0) return(true); case "Editar": case "<<": $Fila=0; return(true); case ">": if (++$Fila<=mysql_num_rows($Cursor)) return(true); case ">>": $Fila=mysql_num_rows($Cursor); return(true); case "Modificar": case "Borrar": if ($Fila==mysql_num_rows($Cursor)) return(true); $Operacion($Cursor,$Tabla,$Fila); if (!$Cursor=mysql_query("SELECT * FROM $Tabla")) print("<p>error al obtener cursor a tabla $Tabla</P>"); return(true); function añadir($cursor,$tabla,$fila) { // Añade una fila global $HTTP_POST_VARS; for ($i=0;$i<mysql_num_fields($cursor);$i++) { if ($i>0) $Valores.=","; $Campo=mysql_field_name($Cursor,$i); $Tipo=mysql_field_type($Cursor,$i); if (strtolower($tipo)=="string") $Valores.="'"; $Valores.=$HTTP_POST_VARS["_${Campo_"]; if (strtolower($tipo)=="string") $Valores.="'"; if (!mysql_query("insert INTO $Tabla VALUES($Valores)")) print("<p>error añadiendo los valores:<br>($valores)</p>"); function modificar($cursor,$tabla,$fila) { // Cambia una fila global $HTTP_POST_VARS; for ($i=0;$i<mysql_num_fields($cursor);$i++) { if ($i>0) { $Nuevos.=","; $Viejos.=" AND "; $Campo=mysql_field_name($Cursor,$i); $Nuevos.="$Campo="; $Viejos.="$Campo="; $Tipo=mysql_field_type($Cursor,$i); if (strtolower($tipo)=="string") { $Nuevos.="'"; $Viejos.="'"; $Nuevos.=$HTTP_POST_VARS["_${Campo_"]; $Viejos.=mysql_result($Cursor,$Fila,$i); if (strtolower($tipo)=="string") { $Nuevos.="'"; $Viejos.="'"; if (!mysql_query("update $Tabla SET $Nuevos WHERE $Viejos")) print("<p>error al sustituir por los valores:<br>$nuevos</p>"); function Borrar($Cursor,$Tabla,$Fila) { for ($i=0;$i<mysql_num_fields($cursor);$i++) { if ($i>0) $Valores.=" AND "; $Campo=mysql_field_name($Cursor,$i); $Valores.="$Campo="; // Elimina una fila 13
$Tipo=mysql_field_type($Cursor,$i); if (strtolower($tipo)=="string") $Valores.="'"; $Valores.=mysql_result($Cursor,$Fila,$i); if (strtolower($tipo)=="string") $Valores.="'"; if (!mysql_query("delete FROM $Tabla WHERE $Valores")) print("<p>error al borrar los valores:<br>$valores</p>"); function editor() { global $REQUEST_URI,$Ejemplo; global $Operacion,$Host,$Usuario; global $Cursor,$BD,$Tabla,$Fila; if (operar($operacion,$cursor,$tabla,$fila)) include("tema8/plantillas/edifila.html"); else include("tema8/plantillas/editabla.html"); // Opera y determina a // que formulario volver: Lo primero que hace el código es gestionar la sesión. Esta premura se justifica porque por defecto las sesiones se establecen por medio de cookies que deben ser introducidas como cabeceras de los mensajes de respuesta, así que, como vimos en el tema anterior, la gestión de una sesión debe realizarse antes de que el interprete PHP empiece a enviar el cuerpo del mensaje de respuesta. La función session_start() empieza una sesión si no existía, en caso contrario la reasume. Reasumirla significa restablecer los valores de las variables registradas en anteriores conexiones de esa misma sesión. Así pues, si no existe ninguna variable vinculada a la sesión ($HTTP_SESSION_VARS) significa que es la primera conexión de la sesión y que todavía no se ha registrado ninguna variable. En este caso registraremos todas las variables necesarias previa inicialización de las que nos interesen. Si no se trata de la primera conexión de la sesión, es posible que los valores de las variables registradas en la sesión (valores que tenían en la última conexión) entren en conflicto con los valores enviados por formulario (en nuestro caso por método POST). El problema es que valores asumen las variables globales PHP, el procedente de la sesión (el que perdura de la conexión anterior) o el que proviene del formulario. La directiva de configuración variables_order del fichero php.ini configura en que orden pasan los valores a las variables globales. Los valores de las variables globales predefinidas provienen de cinco posibles fuentes método GET, método POST, cookies, variables de entorno o sesión. En principio podríamos utilizar esta directiva para indicar que, en caso de conflicto, nos interesa más los valores introducidos por formulario (método POST) que los procedentes de la sesión. Esto significaría que PHP debería leer primero las variables registradas en la sesión y después las que vienen en la petición. Pero pensemos como obtiene PHP los valores de las variables de sesión: los obtiene de un fichero asociado al identificador de sesión donde guardó los valores al terminar la última conexión de la sesión. El identificador de sesión es un nombre único para cada sesión que el navegador y PHP se pasan mediante cookies y/o variables ocultas en formularios. Puedes comprobarlo al visualizar el código HTML desde tu navegador y buscando en el formulario de este ejemplo, por defecto la variable se llama PHPSESSID. PHP incluye por defecto esta variable en cualquier formulario que genere durante una sesión como alternativa a que el usuario desactive el sistema de cookies. En resumen, no se puede adelantar la valoración de las variables registradas en una sesión al paso de variables por cookies, método GET o método POST, pues se usa una variable pasada por alguno o algunos de estos tres métodos para identificar a la propia sesión. Así pues nos toca a nosotros mismos reescribir los valores de las variables globales que entren en conflicto por tener valor de procedencia sesión y procedencia formulario a la vez. Esto no es 14
complicado, pues tenemos los valores claramente identificados por procedencia en los arrays $HTTP_COOKIE_VARS, $HTTP_POST_VARS, $HTTP_GET_VARS y $HTTP_SESSION_VARS. La función campos() crea entradas del formulario con los campos de la fila en edición, si ésta es la última fila (la fila de más para añadir) las entradas quedan en blanco. Las variables asociadas a las entradas de texto tiene el mismo nombre que el campo de la tabla pero con un carácter _ al principio y al final, por si el nombre del campo coincide con alguna variable ya usada. La función operar() ajusta el nuevo valor para la fila y en los casos de Añadir, Modificar y Borrar, llama a la función del mismo nombre y luego vuelve a pedir el cursor para que refleje los cambios. Las funciones añadir(), modifica() y borrar() hacen uso de las instrucciones SQL INSER INTO, UPDATE y DELETE FROM. Añadir() y modificar() utilizan el array $HTTP_POST_VARS para obtener los valores de los campos enviados por formulario de las variables _campo_ correspondientes. 8.4. ODBC Open Data Base Connection es un estándar que permite tratar de forma genérica las conexiones a bases de datos SQL. Cada fabricante de sistemas de bases de datos debe facilitar el controlador correspondiente para que a través de este se pueda conectar a sus bases de datos. Como cada sistema de base de datos crea, organiza y en general gestiona sus bases de datos de forma propia, ODBC solo proporciona funcionalidades genéricas a la mayoría de los sistemas, dejando fuera muchas operaciones propias para cada base de datos y al revés, pudiendo proporcionar funciones que no tienen efecto en algunos sistemas en concreto. A pesar de ello resulta muy útil e interesante, pues fusiona, por de alguna forma decirlo, todos los tipos de accesos a bases de datos en uno. Para ver todos los controladores instalados que dispones en tu máquina, ves al panel de control y abre el icono ODBC u ODBC de 32 bits, los controladores suelen llevar en su propio nombre una descripción de para qué sistema de base de datos están diseñados. Con ODBC, en vez de conectarse a una base de datos, hay que conectarse a una fuente de datos (Data Source). Estas fuentes de datos no son más que una descripción de cómo conectarse a una verdadera base de datos (con que controlador, a que base de datos, con que usuario, etc.). Estas descripciones aparecen en la misma ventana de los controladores ODBC como DSN (Data Source Name), y las hay de tres tipos, generales a sistema, propias del usuario o descritas en un fichero. Comprueba si ya tiene disponible alguna DSN a la que conectarte mediante ODBC. MySQL a través de ODBC MySQL también tiene sus controladores ODBC, puedes descargarlos de MySQL, en el momento de escribir este tema la última versión para Windows 9x es la 2.50.36. El instalador es en realidad un instalador de controladores ODBC genérico que Microsoft proporciona a los fabricantes de sistemas de bases de datos para que distribuyan sus controladores. Al descomprimir e instalar nos aparecerá la ventana de gestión de Data Sources por si queremos añadir una DSN. El instalador ya ha introducido como ejemplo una llamada sample-mysql pero conecta con una base de datos test que posiblemente sigamos teniendo vacía, podemos modificar esta para crear la nuestra. 15
En cualquier caso (nueva o modificada), nosotros vamos a obtener una DSN con el nombre Tema8-ODBC-Mysql que conectará con el controlador ODBC de MySQL a una base de datos en localhost llamada Tema8 con el usuario root. Si no tienes una base de datos MySQL que se llame así (Tema8) créala con el ejemplo del gestor y rellénala con algún dato con el ejemplo editor, pues la vamos a usar en el siguiente ejemplo. Para comprobar el controlador ODBC de MySQL está correctamente instalado y que nuestra DSN está bien definida, llama al programa admndemo.exe que te habrá aparecido al descomprimir el instalador del controlador. Lo primero que te pide al arrancar es que le indiques con que DSN conectar. Selecciona nuestra DSN Tema8-ODBC-MySQL. Luego te aparecerá una ventana dividida en dos paneles. En el panel superior puedes escribir cualquier instrucción SQL (un SELECT será lo mas facil). En la barra de menús seleccionamos el menú Command seleccionamos la opción Execute y la instrucción SQL debe ejecutarse sobre nuestra base de datos Tema8. Visor ODBC Vamos a modificar el ejemplo visor para que en vez de conectar directamente con bases de datos MySQL lo haga a través de ODBC. Le llamaremos odbc precisamente. La nueva plantilla de formulario es: Listado 8.13. C:\Archivos de Group\Apache\cgi-bin\tema8\plantillas\odbc.html Plantila formulario para el visor ODBC. <FORM action="<?=$request_uri?>" method="post"> <INPUT type="hidden" name="ejemplo" value="<?=$ejemplo?>"> <TABLE> <TD><B>DSN ODBC:</B></TD> <TD><INPUT type="text" name="dsn" value="<?=$dsn?>"></td> <TD><B>Usuario:</B></TD> <TD><INPUT type="text" name="usuario" value="<?=$usuario?>"></td> <TD><B>Tabla:</B></TD> <TD><INPUT type="text" name="tabla" value="<?=$tabla?>"></td> <INPUT type="submit" name="visualizar" value="visualizar"> <INPUT type="submit" value="limpiar"></center> </TABLE> </FORM> El código queda más sencillo todavía que el del visor: Listado 8.14. C:\Archivos de programa\apache Group\Apache\cgi-bin\tema8\odbc.php Visor de tablas a través de ODBC. function titulo() { print("visor ODBC"); function visualizar($dsn,$usuario,$tabla) { print("<p>"); if ($DSN) print("<b>dsn ODBC:</B> $DSN "); if ($Usuario) print("<b>usuario:</b> $Usuario "); 16
if ($Tabla) print("<b>tabla:</b> $Tabla"); print("</p>\n"); if (!$Conexion=odbc_connect($DSN,$Usuario,"")) print("<p>error al conectar con $DSN como $Usuario</P>"); elseif (!$Cursor=odbc_exec($Conexion,"SELECT * FROM $Tabla")) print("<p>error al obtener cursor a tabla $Tabla</P>"); else { odbc_result_all($cursor,"border=\"1\" rules=\"all\""); print("<br>\n"); function resultado() { global $Visualizar,$DSN,$Usuario,$Tabla; if (isset($visualizar)) visualizar($dsn,$usuario,$tabla); else $DSN=$Usuario=$Tabla=$Visualizar; function odbc() { global $REQUEST_URI,$Ejemplo,$DSN,$Usuario,$Tabla; include("tema8/plantillas/odbc.html"); La función odbc_connect() conecta con la DSN que se le indique. La función odbc_exec() ejecuta una instrucción SQL. Necesita forzosamente de la conexión devuelta por odbc_connect(). La función odbc_result_all() imprime el resultado de la consulta SQL en formato tabla HTML, la cadena que acompaña al cursor como parámetro proporciona los atributos para la etiqueta TABLE. Visualiza tablas de la base de datos Tema8 a través de la DSN Tema8-ODBC-MySQL mediante este ejemplo. Si dispones de MS-Access, prueba a crear una base de datos, créale una DSN (desde la ventana de controladores de ODBC que obtienes a través del panel de control se pueden añadir DSN nuevas) y visualiza sus tablas con este visor PHP de ODBC. Migración de unos a otros sistemas de bases de datos Como último ejemplo vamos a ver como pasar una tabla (estructura y datos) de una base de datos a otra, con independencia de sus sistemas de bases de datos mediante una DNS de origen y otra de destino. La plantilla a utilizar es: Listado 8.15. C:\Archivos de Group\Apache\cgi-bin\tema8\plantillas\migrador.html Plantila formulario para el migrador. <FORM action="<?=$request_uri?>" method="post"> <INPUT type="hidden" name="ejemplo" value="<?=$ejemplo?>"> <TABLE> <TR><TD colspan="2"> <CENTER>Migrar de...</center> <TD><B>DSN ODBC:</B></TD> <TD><INPUT type="text" name="de_dsn" value="<?=$de_dsn?>"></td> <TD><B>Usuario:</B></TD> <TD><INPUT type="text" name="de_usuario" value="<?=$de_usuario?>"></td> 17
<TR><TD colspan="2"> <CENTER>... a...</center> <TD><B>DSN ODBC:</B></TD> <TD><INPUT type="text" name="a_dsn" value="<?=$a_dsn?>"></td> <TD><B>Usuario:</B></TD> <TD><INPUT type="text" name="a_usuario" value="<?=$a_usuario?>"></td> <TR><TD colspan="2"> <CENTER>... la...</center> <TD><B>Tabla:</B></TD> <TD><INPUT type="text" name="tabla" value="<?=$tabla?>"></td> <INPUT type="submit" name="migrar" value="migrar"> <INPUT type="submit" value="limpiar"></center> </TABLE> </FORM> Lo que el código de este ejemplo hace es: conectar con la DSN origen, obtener el cursor de la tabla origen, conectar con la DSN destino, extraer información de la estructura de la tabla origen y crear una tabla en destino como la origen, y por último copiar los datos obtenidos del cursor de la tabla origen a la tabla destino. Veamos, pues, el código: Listado 8.16. C:\Archivos de programa\apache Group\Apache\cgi-bin\tema8\migrador.php Migrador de tablas a través de ODBC. function migrar($de_dsn,$de_usuario,$a_dsn,$a_usuario,$tabla) { if (!$Origen=odbc_connect($De_DSN,$De_Usuario,"")) print("<p>error al conectar con $De_DSN como $De_Usuario</P>"); elseif (!$Cursor=odbc_exec($Origen,"SELECT * FROM $Tabla")) print("<p>error al obtener cursor a tabla $Tabla</P>"); elseif (!$Destino=odbc_connect($A_DSN,$A_Usuario,"")) print("<p>error al conectar con $A_DSN como $A_Usuario</P>"); else { extraerdefinicioncampos($cursor,$definicion,$formatos); if (odbc_exec($destino,"create TABLE $Tabla ($Definicion)")) copiafilas($cursor,$formatos,$destino,$tabla); else print("<p>error creando la tabla $Tabla con:<br>($definicion)</p>"); function extraerdefinicioncampos($cursor,&$definicion,&$formatos) { for ($i=1;$i<=odbc_num_fields($cursor);$i++) { if ($i>1) $Definicion.=","; $Definicion.=odbc_field_name($Cursor,$i); $Tipo=odbc_field_type($Cursor,$i); $Definicion.=" ".$Tipo; if (strtolower($tipo)=="varchar") { $Definicion.="(".odbc_field_len($Cursor,$i).")"; $Formatos[]="'%s'"; else $Formatos[]="%d"; function copiafilas($cursor,$formatos,$destino,$tabla) { for ($i=1;$i<=odbc_num_rows($cursor);$i++) { if (odbc_fetch_into($cursor,$i,$fila)) { foreach ($Fila as $j => $Campo) { if ($j==0) $Valores=sprintf($Formatos[$j],$Campo); else $Valores.=",".sprintf($Formatos[$j],$Campo); if (!odbc_exec($destino,"insert INTO $Tabla VALUES($Valores)")) print("<p>error añadiendo los valores:<br>($valores)</p>"); 18
else print("<p>error al leer fila $i</p>"); function resultado() { global $Migrar,$De_DSN,$De_Usuario,$A_DSN,$A_Usuario,$Tabla; if (isset($migrar)) migrar($de_dsn,$de_usuario,$a_dsn,$a_usuario,$tabla); else $De_DSN=$De_Usuario=$A_DSN=$A_Usuario=$Tabla=$Migrar; function migrador() { global $REQUEST_URI,$Ejemplo,$Tabla; global $De_DSN,$De_Usuario,$A_DSN,$A_Usuario; include("tema8/plantillas/migrador.html"); La función extraerdefinicioncampos() obtiene información de la estructura de la tabla (nombres y tipos de sus campos) a través de as funciones odbc_num_fields(), odbc_field_name(), odbc_field_type() y odbc_field_len() y la devuelve en la cadena $Definicion (usada para crear la tabla) y en el array $Formatos donde se guarda los formatos %d o %s según sea el campo entero o cadena (No estamos contemplando más tipos de datos en los ejemplos de este tema). La función copiafilas() recorre todas las filas (odbc_num_rows()) mediante la función odbc_fetch_into() que pasa la fila a un array que es compuesto con los formatos correspondientes para enviar en una instrucción SQL INSER INTO. Para probarlo créate una base de datos MS-Access vacía llamada Tema8. Si no dispones de MS-Access, en el directorio datos (donde se guarda la información de las sesiones) tienes una. Crea una DSN con el controlador ODBC de Access llamada Tema8-ODBC-Access para acceder a la base de datos vacía que has creado. Ahora ejecuta el ejemplo y pasa todas tus tablas de la base de datos Tema8 de MySQL a la nueva de Access a través de las DSN Tema8-ODBC-MySQL y Tema8-ODBC-Access. Abre la base de datos en Access y comprueba la migración. Si no dispones de Access usa el visor ODBC del ejemplo anterior. 8.5. Combinando ejemplos. Hemos terminado el tema habiendo creado una serie de herramientas que a través de Web nos van a permitir manipular datos en cualquier sistema de base de datos del que dispongamos su controlador ODBC, apoyándonos si es necesario en tablas que nos creemos o migremos a MySQL de forma temporal. Por ejemplo, si nos creamos la DSN Tema8-ODBC-Texto con el controlador ODBC de texto y vinculándolo a un directorio cualquiera (o creando uno vacío para tal menester), podemos hacar tablas en MySQL, pasarlas a texto a través del nuevo DSN y para consultarlas podemos usar el visor ODBC. 19