Manual PHP. librería PHPLIB (I)

Después de la primera entrega de esta sección donde presentamos PHP4, vamos a ponernos ya a programar aplicaciones utilizando PHP. Y PHP no es más que un lenguaje y un conjunto de librerías orientadas hacia el desarrollado de aplicaciones web. Todo lo que podemos hacer con PHP lo podríamos hacer exactamente igual con otro lenguaje utilizando CGI, pero la complejidad y tiempo de desarrollo serían mucho mayores y su integración con el web mucho menor.

Quizás podamos ver PHP como una extensión de HTML del lado del servidor. Recordemos que en principio el lenguaje PHP se mezcla con HTML en una página HTML con extensión “.php”. Es precisamente esta extensión la que alerta al servidor de web para que antes de entregar la página al cliente, se la pase al interprete de PHP para que ejecute las partes PHP y envíe al cliente el HTML y los resultados de las partes PHP. A lo largo de esta entrega nos vamos a centrar en describir PHPLIB, una librería que nos va a permitir de forma sencilla poder trabajar con diferentes bases de datos de forma transparente, poder gestionar sesiones de una forma sencilla y llevar un control de acceso muy flexible basado en bases de datos. PHPLIB también proporciona clases, está basada en objetos, para gestionar plantillas y crear HTML desde PHP. Como veremos uno de los problemas fundamentales con lenguajes como PHP, donde se mezcla el código PHP con el código HTML, es que no está bien delimitado el campo del diseñador HTML y del programador y que el código resultante puede ser complejo de entender y por o tanto, muy complicado de mantener. Las plantillas permiten que el código HTML esté totalmente fuera del código PHP con lo que el resultado final es mucho más flexible y mantenible.

PHPLIB es una librería GPL y se puede obtener en la referencia [1]. Su instalación es un tanto compleja ya que toda su funcionalidad principal utiliza base de datos. Por lo tanto lo primero es tener una base de datos funcionando en el sistema. Nos vamos a centrar en MySQL pero la instalación sería muy similar para PostgreSQL o MS Access.

Una vez que hayamos obtenido el “tar.gz” de la librería la descomprimimos en un directorio (tar xvfz phplib-7.2.tar.gz ) y pasamos a instalarla. La estructura de directorios resultante es:

CHANGES  COPYING  HELP    README  VERSION  pages  stuff
COMMIT  CREDITS  Makefile  TODO   doc     php  unsup

La documentación de la librería es de los más completa y se encuentra en el directorio “doc”. Las clases que componente la librería se encuentran en el directorio “php” y los “scripts” de creación de base de datos y tablas necesarios para el funcionamiento de la librería y el soporte de LDAP se encuentra en el directorio “stuff”. En el directorio “pages” tenemos unos sencillos ejemplos para comenzar a trabajar con la librería y en “unsup” tenemos utilidades de las que no se da soporte, es decir, que pueden ser útiles pero que no son parte de la distribución oficial. Sobre la licencia como ya dijimos es software GPL y por lo tanto dentro de “COPYING” tenemos la querida licencia GPL.

La guía de instalación rápida nos cuenta en 10 pasos como instalar la librería. Como ya dijimos lo primero es tener una base de datos funcionando en el sistema. Quizás puede parecer un requisito excesivo pero los servidores web sin base de datos serán una especie en extinción en el futuro cercano. Si tenemos MySQL instalado todo va a ser sencillo. Accedemos al directorio “stuff” y ejecutamos:

mysqladmin -u root create phplib  mysql -u root
< create_database.mysql

Con ello creamos una base de datos para PHPLIB y dentro de ella la poblamos con una serie de tablas. En estas tablas es donde PHPLIB guarda toda la información de sesiones y control de accesos. Una vez que ya tenemos la infraestructura de base de datos preparada hay que indicar a PHP que en todas las páginas incluya el núcleo de PHPLIB. Se puede evitar hacer esto pero es muy cómodo tener toda esta funcionalidad de forma automática en nuestras páginas PHP, y este núcleo es bastante reducido. Esto lo vamos a lograr accediendo al fichero de configuración de PHP, normalmente “/etc/php.ini”, e incluir en la línea que comienza con “auto_prepend_file” la localización del fichero “prepend.php3″ que se encuentra dentro del directorio “php” de PHPLIB. De esta forma el interprete de PHP incluye PHPLIB en todas las páginas PHP. Una vez hecho esto solo nos queda acceder al fichero “local.inc” y especificar los datos necesarios en la clase “DB_Example” para que PHPLIB puede acceder a la base de datos. El contenido de esta clase es:

class DB_Example extends DB_Sql {var $Host  = "localhost";
var $Database = "phplib"; var $User = "root";
var $Password = ""; }

Tenemos que especificar en que máquina está corriendo la base de datos, como se llama la base de datos en la que se van a almacenar los datos de PHPLIB, y un usuario y clave para acceder a esa base de datos. La clase DB_Sql es una abstracción del acceso a la base de datos, es decir, que a través de esta clase podemos acceder de forma idéntica a varios tipos de bases de datos diferentes. En concreto en la versión actual de PHPLIB nos encontramos implementaciones de DB_Sql para las siguientes bases de datos:

db_msql.inc: msql   db_mssql.inc: MS SQL Server
db_mysql.inc: MySQL
db_oci8.inc, db_oracle.inc: ORACLE   db_odbc.inc: ODBC
db_pgsql.inc: PostgreSQL   db_sybase.inc: Sybase

Si basamos nuestros desarrollos en PHPLIB y DB_Sql la migración de un sistema de bases de datos será trivial: sólo habrá que traspasar los datos y cambiar la clase con la que se accede a la base de datos. Todo nuestro código será idéntico.