Mostrando entradas con la etiqueta PHP. Mostrar todas las entradas
Mostrando entradas con la etiqueta PHP. Mostrar todas las entradas

viernes, 26 de noviembre de 2010

Experiencias en Code Igniter - Parte 1

Bueno luego de una ausencia muuuy prolongada he decidido contribuir al conocimiento general como todo el mundo.
No tengo mejor manera de arrancar esto sino con lo que más he usado los últimos 3 años como herramienta de trabajo.

The Code Igniter Framework




0. Nota


Esto esta enfocado a personas que por lo menos han trabajado con algún framework, no esta escrito para personas que recién arrancan en el mundo de éstos. 
 

1. Instalación




Vamos al sitio oficial de CodeIgniter (http://codeigniter.com/) y descargamos la última versión (al día de hoy 1.7.2) .
Descomprimimos el archivo y vemos que la estructura es:

/
. /system
. /index.php



Primero que nada, el index.php es el archivo de CodeIgniter (de aquí en más CI) que maneja todas las peticiones al framework. Dentro de la carpeta system tenemos un monton de carpetas, la única que debemos tener en cuenta es la carpeta "application".

Dentro de esta carpeta estarán todos los archivos específicos de nuestro proyecto. Por lo que actualizar el framework se torna sumamente sencillo.

Hemos de suponer que se tiene de un lugar donde alojar estos archivos, por ejemplo, un servidor con un dominio. En otro momento mostraré como se pueden crear un entorno de trabajo cómodo para trabajar varias personas sobre el mismo proyecto. Entonces, decía, supongamos que tenemos un dominio http://misitio.com/ y que el document root de nuestro hosting se llama "httpdocs".
Debemos tirar dentro de la carpeta pública (httpdocs) los archivos ta cual están en el .zip que nos bajamos del sitio de CI.

Para una instalación básica, solo debemos modificar el archivo:

/system/application/config/config.php
 

Donde dice: 


$config['base_url'] = "http://www.mysite.com/";


debemos especificar la dirección del sitio, ahora bien, muy a menudo sucede que el sitio puede cambiar de dirección (múltiples nombres o diferentes ámbitos), lo que yo aconsejo es dejar parametrizado este parámetro (redundancia :D ) 


$config['base_url'] = "http://".$_SERVER['HTTP_HOST']."/";


Así nos aseguramos de que no importa el dominio en el que se encuentre, siempre va a funcionar. 


Probemos la instalación haciendo http://misitio.com/ en el browser, deberíamos ver una página que diga "Welcome to Code Igniter!. Eso significa que que logramos instalar correctamente el framework Hasta aquí nada complicado ni nuevo. Ahora bien, comenzamos la parte donde "tuenamos" el CI para potenciarlo.


1. División MVC


La división MVC clásica nos dice que tenemos una capa Modelo, una capa Vista y una capa Controladora (en realidad sería Model View Controller). Esto es ya lo disponemos en nuestro CI.
  • /controller: carpeta de los controladores.
  • /model: carpeta de los modelos.
  • /views: carpeta de los archivos de vistas.
Bien, según esto, dentro de los archivos de "views" vamos a tener solamente HTML, CSS, JS, y muy poco de php (por lo general, los objetos de transporte de datos y búcles de iteración). En "controller" tenemos los controladores que son los métodos por los cuales accederemos a nuestras páginas, pero también son aquellos que leen datos del usuario y leen datos desde la DB.
¿Que tiene de bueno y de malo ésto?
  • Lo bueno: Hay una separación entre la vista y el modelo mediando por el controlador, este se encargará de trabajar los datos entre ambos extremos para poder presentarlos en cada uno de ellos de la manera correcta.
  • Lo malo: se torna complicado reutilizar código o modularizar componentes ya que depende mucho de como fue confeccionado el controlador. Es decir, puedo reutilizar un controlador que permita registrar o loguear a un usuario, pero ya es más difícil si mi controlador hiciera cosas más complejas o que dependan un poco más del proyecto en el que esté.

Ahora, ¿que pasa si a este modelo le agregáramos una capa más al MVC? llamémosla capa "business". Podríamos colocar aquí todo lo relativo al manejo grueso del negocio en la aplicación, haciendo que una clase sea la encargada exclusiva de solicitar datos al modelo y presentarlos como colección de objetos al controlador, para que éste opere con éstos como lo desee. También se encargaría de las acciones que impacten en el modelo, tomando los datos en "crudo" desde el controlador para que luego trabaje con ellos (validación, conversión, etc) y eventualmente realize la operación solicitada o notifique un error. También puede encargarse de tareas sobre archivos, enviar e-mails, etc. Todo aquello que pueda ser modularizado y realice tareas complejas (más allá de tareas de presentación de datos).



Resumiendo: Creamos una nueva capa llamada business donde concentra todo el negocio grueso de nuestra aplicación, impacto de datos en el modelo, validación de los datos, obtención de datos desde el modelo, envío de e-mails, etc, etc.


2. Transferencia de datos y Objetos


Como habrán visto, la transferencia de datos, sobre todo de parámetros en php puede llegar a ser compleja si no se tiene cuidado. Es por eso que el concepto que debemos asimilar es la de usar Data Transfer Objects (DTOs). Estos son objetos sencillos donde representarían la entidad que deseamos modelar. Estos objetos no son nada mas que clases vacías de implementación solo con los atributos.
Por ejemplo: Si tuviéramos que crear un DTO para la entidad "usuario" éste sería:


/**
 * 
 * User Data Transfer Object
 * @author isanchez
 * @version 1.0
 *
 */
class UserDTO {
 /**
  * 
  * User Identification
  * @var Int
  */
 public $userId = null;
 
 /**
  * 
  * User name
  * @var VARCHAR
  */
 public $name = null;
 
 /**
  * 
  * User E-mail
  * @var VARCHAR
  */
 public $email = null;
}

En este caso definimos la clase UserDTO con los atributos userId, name e email. si tuviéramos este objeto cargado en una variable el mismo se vería así:



$userDTO = new UserDTO();
$userDTO->userId = 123;
$userDTO->name = "Bill Gates";
$userDTO->email = "none@none.com";




Entonces cuando queremos pasarle los datos de creación de un usuario al business de usuario, solo deberíamos cargar los datos como lo hicimos anteriormente (sin el userId obviamente) y pasárselos a la función encargada, como por ejemplo:


$userDTO->userId = $userBusiness->create($userDTO);
if( $userDTO->userId > 0 ){
    echo "Usuario creado";
}else{
    echo "No se pudo crear el usuario";
}
Resumiendo: Usamos clases vacías como objetos para trasportar datos, tanto sea para pasarlo como parámetro entre los métodos de una clase como para usarlos a nivel de vista (podemos paras arrays de UserDTOs cuando queramos listar los usuarios de nuestra aplicación por ejemplo).


Bien hasta aquí mas o menos se logra tener instalada una copia de CI con la división MVC + la capa business. Más adelante escribiré en detalle sobre esta última capa y sobre las clases "base" que debemos tener para una mejor utilización de éste framework.

miércoles, 22 de abril de 2009

Instalación y Configuración de Apache 2.2 con PHP y MySQl

El otro día me vi en la situación de instalar Apache con PHP y MySQL en mi ubuntu 8.10 (próximamente a convertirse en el 9.1) y googleando encontré mucho material, y arme un instructivo paso a paso de como instalar Apache en Ubuntu.

Ejecutamos para instalar apache.

sudo apt-get install apache2

Ejecutamos para instalar php5:

sudo apt-get install php5 libapache2-mod-php5

Para comprobar que este bien instalado hacemos:

sudo a2enmod php5

Reiniciamos apache:

sudo apache2ctl restart

Instalamos MySQL:

sudo apt-get install mysql-server

Instalamos manejador de php mysql:

sudo apt-get install php5-mysql

Y como complemento si queremos SVN:

sudo apt-get install subversion


Ahora bien, vamos a necesitar identificar y hacer algunos ajustes al apache para que funcione con algunos elementos extras como por ejemplo, los Virtual Host (VHost en adelante).

La idea es crear sitios con virtual host distintos para que cada uno tenga una configuración aparte.

Para esta tarea primero identificaremos la estructura de directorios de apache.

En /etc/apache2 disponemos de varios subdirectorios dos de ellos importantes para nosotros.

•conf.d

•mods-available

•mods-enabled

•sites-available

•sites-enabled

Los ficheros de configuración de los VHost se configuran en sites-available.

En sites-enabled sólo contiene enlaces a aquellos VHost que queremos activar.

Supongamos que queremos crear (por ejemplo) un VHost de nombre "misitio.site" para que, cuando ponga en mi navegador http://misitio.site me lleve a la página principal de ese host.

Observar!! Si pongo http://localhost me llevará al VHost por defecto (distinto del de misitio.site).

Pero antes que nada, para que mi browser "sepa" a que ip conectarse cuando haga el request de misitio.site debo añadir unas líneas al archivo situado en: /etc/hosts

Entonces ejecuto

sudo vim /etc/hosts

Creo una nueva entrada manteniendo lo que había y añado lo siguiente:

127.0.0.1 misitio.site

127.0.0.1 www.misitio.site

En general será {IP} {serverName} à IP y nombre del servidor

Observar que esto solo es necesario para que desde mi propia máquina pueda acceder al sitio por medio del browser, en caso de montar un servidor, este trabajo lo haría el propio dominio que estaría apuntando a la ip de mi servidor.

Ahora comienzo con la creación del espacio en disco para mi sitio, creo una carpeta para el contenido dentro de la carpeta /var/www/ para este caso usaremos: /var/www/misitio.site

Notar que no interesa que como se llame la carpeta, pero es una buena práctica identificarla con el dominio que tendrá.

Pasamos a la configuración del VHost, ejecutamos

cd /etc/apache2/sites-available

Hacemos:

sudo vim default

default es un archivo donde se definen los virtual host y le agrego la línea (esto solo por una única vez) NameVirtualHost *:80

Hago una copia del archivo default ejecutando

cp default misitio.site

Edito el misitio.site y lo dejo, como por ejemplo:

<VirtualHost 127.0.0.1:80>

ServerAdmin admin@misitio.site

DocumentRoot "/var/www/misitio.site/src"

ServerName misitio.site

ServerAlias www.misitio.site

</VirtualHost>

En fin, agrego todo lo que necesite para mi VHost, como por ejemplo reglas de rescritura, etc.

Cierro el archivo y ejecuto

cd /etc/apache2

y luego

a2ensite misitio.site

El comando a2ensite (available 2 enablesite) crea un enlace en sites-enable al site que le indiquemos (es decir, activa el VHost que acabamos de crear)

Comprobamos que todo este OK ls -al sites-enabled/

Recargamos apache /etc/init.d/apache2 reload

En caso de que el VHost configurado lleve reglas de rescritura, se debe cargar el módulo mod_rewrite esto lo podemos hacer con el comando a2enmod ejecutado:

cd /etc/apache2/

y luego

a2enmod rewrite

y por último restart del apache

/etc/init.d/apache2 restart

Y con esto tendríamos pronto un sitio en apache, mediante un virtual host, podremos chequearlo con solo acceder a http://misitio.site