Facebook Twitter RSS Reset

Simple PHP – Framework (Proyecto Propio)

Antes que nada, quiero agradecer a toda la comunidad T! por colaborar con algunos cuestionarios online para poder presentar mi proyecto en la facultad.

Quiero compartir con ustedes un Framework que hemos desarrollado con un compañero y que lo denominamos Simple PHP, justamente por el hecho de su facilidad que es lo que buscábamos.

Esta diseñado para que gente que esta dando sus primeros pasos con PHP pueda llevar a cabo proyectos de forma rápida.

Sé que aún tiene muchas cosas por mejorar, en especial la parte de seguridad, pero creo que puede ser de gran utilidad para algunas personas, y es por eso que lo comparto.

A diferencia de muchos frameworks en el mercado, Simple PHP es facil de instalar y de usar. Basta con descargar el proyecto, descomprimirlo y colocar los datos de configuración en el archivo config.php

Lo que más me gusta del sistema que desarrollamos es el logo, bien de machos, que eligió mi compañero, en fin.. me terminó pareciendo un lindo logo quizas por la falta de ideas.. jaja

Si quieren pueden darle clic a las publicidades…jeje

Simple PHP - Framework (Proyecto Propio)

Se que no es la gran cosa.. pero.. quizás a alguien le sirva..

A continuación les dejo un tutorial sobre su uso, que también esta en el sitio. Si alguien necesita la documentación completa del trabajo me escribe..

Saludos..!!!

Simple PHP – Framework – Manual del Usuario

1 – REQUISITOS

1.1. Para utilizar Simple PHP debe tener instalado en su PC un servidor Web, que puede ser Apache o IIS 7 o superior.

Puede consultar estos Links si no posee un servidor Web:

https://technet.microsoft.com/es-es/library/cc725762.aspx

http://norfipc.com/internet/instalar-servidor-apache.html

1.2. Debe estar activo el módulo ReWrite del servidor Web.

Puede consultar esta información para activarlo:

https://www.youtube.com/watch?v=4nAz7gcTMvw

http://www.iis.net/downloads/microsoft/url-rewrite

2 – INSTALACIÓN

2.1. Descargar el framework desde el sitio oficial: http://www.simplephp.com.ar

2.2. Descomprimimos el archivo rar en la carpeta del servidor web, en este caso Apache con WampServer.

Simple PHP - Framework (Proyecto Propio)

3 – CONFIGURACIÓN

3.1. Abrimos la carpeta e ingresamos al directorio config

Simple PHP - Framework (Proyecto Propio)

3.2. Editamos el archivo config.php y colocamos en el los datos correspondientes a nuestra aplicación. En nuestro caso tomaremos como ejemplo una base de datos llamada InfoUtil que contiene tres tablas (usuario, sector, procedimiento).

Simple PHP - Framework (Proyecto Propio)

4 – PROBAMOS EL ACCESO A LA APLICACIÓN

4.1. Ingresamos en el navegador la dirección URL configurada anteriormente y deberías ver una pantalla como la siguiente:

Simple PHP - Framework (Proyecto Propio)

5 – CREANDO CLASES PHP

5.1. Ingresamos al panel de administración de Simple PHP a través de un navegador, colocando la dirección de nuestro proyecto seguido de la palabra admin.

Deberíamos visualizar las tablas de nuestra base de datos configurada, y desde el botón Generar creamos las clases que nos interesan.

Simple PHP - Framework (Proyecto Propio)

5.2. En nuestro caso generamos las tres clases. Usted puede seleccionar solo las que son de su interés. Aclaración: En esta etapa se generan 2 clases para cada tabla, una que corresponde a un registro en particular de la tabla y otra que será una colección de registros, la primera tendrá el mismo nombre que la tabla por ejemplo Usuario y la segunda será CollectionUsuarios.

Simple PHP - Framework (Proyecto Propio)

5.3. Podemos verificar que fueron creadas en el directorio Model del proyecto

Simple PHP - Framework (Proyecto Propio)

6 – CREANDO RELACIONES ENTRE LAS CLASES PHP

6.1. Desde el panel de administración donde creamos las clases podemos crear relaciones entre las mismas a través de sus atributos, de tal forma que al instanciar la clase podamos tener acceso a los datos de la tabla relacionada sin necesidad de crear un nuevo objeto.

Simple PHP - Framework (Proyecto Propio)

Por ejemplo, aquí relacionamos la clase Usuario con la de Sector a través de los atributos usuario.id_sector y sector.id con una relación de 1 a 1, logrando de esta forma que pueda ser usado de la siguinete manera:

Simple PHP - Framework (Proyecto Propio)

De esta forma hacemos uso del usuario 1 de la base de datos mostrando en el navegador su nombre y el nombre del sector al que pertenece. Esto se verá con más detalle más adelante.

7 – CREANDO SJS (Simple JS)

7.1 Son archivos JS que se corresponden a las tablas de la base de datos y están sincronizados con las clases generadas en PHP, su lenguaje de comunicación es JSON. Es importante aclarar que los JS se ejecutan en el cliente, por lo que un uso descuidado de ellos podría provocar que usuarios malintencionados tengan acceso a los datos a través de la consola de un navegador.

Simple PHP - Framework (Proyecto Propio)

7.2. Los JS son creados en el directorio web/sjs

Simple PHP - Framework (Proyecto Propio)

8 – CREANDO LAS VISTAS

8.1. Desde el panel de administración podemos crear las vistas para facilitar la carga de datos a través de una interfaz gráfica

Simple PHP - Framework (Proyecto Propio)

8.2. Podemos verificar que las vistas fueron creadas con éxito dentro del directorio view de nuestro proyecto. La extensión de estos archivos es tpl y contienen html.

Simple PHP - Framework (Proyecto Propio)

9 – RECORRIENDO LAS VISTAS GENERADAS

9.1. Luego de creadas las vistas, accedemos al HOME de nuestra aplicación y nos toparemos con la sorpresa que en la barra superior se ha creado un menú desde donde podremos gestionar nuestra base de datos sin escribir código.

En nuestro caso solo generamos la vista para usuario.

Simple PHP - Framework (Proyecto Propio)

9.2. Recorremos las vistas generadas.

Nuevo Usuario: permite dar de alta un nuevo registro.

Listar Usuario: muestra una lista completa de los datos de esa tabla realizando un paginado.

Modificar Usuario: permite realizar la búsqueda y carga de un registro en particular y modificar sus datos.

Eliminar Usuario: permite borrar un registro específico de la tabla en cuestión.

Simple PHP - Framework (Proyecto Propio)

Simple PHP - Framework (Proyecto Propio)

Simple PHP - Framework (Proyecto Propio)

Simple PHP - Framework (Proyecto Propio)

10 – ENTENDIENDO EL MANEJO DE LA URL

Básicamente, el manejo de la URL es el siguiente:

En la variable CONT de la configuración colocamos la cantidad de / que el framework leerá antes de comenzar el análisis.

Por ejemplo: si la URL de tu pagina es http://www.simplephp.com.ar/ , CONT estará en 1,

si es http://localhost/simplephp/ , CONT estará en 2, por lo que en el segundo caso tendremos que modificarlo cuando subamos a la web.

La URL está compuesta por 3 partes:

Controlador / Método / Parámetro

Por lo que una URL completa nos quedaría:

http://localhost/simplephp/controlador/metodo/parametro/

o

http://www.simplephp.com.ar/

Los controladores están o serán creados en la carpeta controller

Simple PHP - Framework (Proyecto Propio)

Los mismos serán archivos PHP con la siguiente estructura:

class Main

{

public static function init()

{

……………..

}

}

Main es nuestro controlador Principal, por lo que cuando alguien ingrese a la raíz del sitio será invocado y ejecutará el método init().

Para definir otros controlador lo podemos hacer de la siguiente manera:

1- Creamos un archivo PHP en al carpeta controller.

2- Definimos una clase con el nombre del Controlador.

class MiControlador

{

public static function init()

{

echo “Hola Mundo”;

}

}

3- Verificamos que todo esté correcto accediendo por la URL de la siguiente manera:

http://localhost/simplePHP/MiControlador/

Esto debería mostrarnos en pantalla “Hola Mundo”.

4- Ahora crearemos un método:

class MiControlador

{

public static function init()

{

echo “Hola Mundo”;

}

public static function MiMetodo()

{

echo “Esto es un método…”;

}

}

Para acceder al método http://localhost/simplePHP/MiControlador/MiMetodo, y esto mostrará por pantalla “Esto es un método…”.

5- Para utilizar parámetros lo hacemos de la siguiente manera:

class MiControlador

{

public static function init()

{

echo “Hola Mundo”;

}

public static function MiMetodo($miParametro)

{

echo “El parámetro ingresado es: ”.$miParametro;

}

}

Cuando ingresemos a http://localhost/simplePHP/Micontrolador/MiMetodo/param, en pantalla veremos “El parámetro ingresado es: param”.

11 – INVOCANDO UNA VISTA

Las vistas se encuentran en el directorio View de la raíz del proyecto, son archivos tpl que contienen HTML y que pueden tener etiquetas {MiEtiqueta}.

class MiControlador

{

public static function init()

{

echo “Hola Mundo”;

}

public static function MiMetodo($miParametro)

{

$data = array(“MiEtiqueta”=>$miParametro);

View::show(“NombreArchivoTPL”,$data);

}

}

En este ejemplo, se mostrará el masterPage.tpl que contiene en encabezado y el footer del sitio, y dentro de él la vista NombreArchivoTPL.tpl con la etiqueta {MiEtiqueta} reemplazada por el valor de $miParámetro.

O sea que los datos que necesitamos reemplazar en la vista lo pasamos en un vector como se ve en el ejemplo.

12 – UTILIZANDO LAS CLASES PHP GENERADAS

Para usar las clases que generamos anteriormente, lo hacemos de la siguiente manera.

1- Si queremos crear un nuevo registro, por ejemplo en la tabla usuario:

class MiControlador

{

public static function init()

{

$varUsuario = new Usuario();

$varUsuario->setNombre(“Mi Nombre”);

$varUsuario->setPassword(“Mi Password”);

$varUsuario->save();

}

}

De esta forma, creamos un registro en la tabla usuario, si deseamos saber el ID con que fue creado lo hacemos invocando el método getId() en el ejemplo.

echo $varUsuario->getId();

Entonces, cada clase tiene generada los geters y seters de los atributos para cuidar el encapsulamiento y un metodo save() para que los cambios sean guardados en la tabla.

2 – Si queremos modificar un registro:

$varUsuario = new Usuario(1);

$varUsuario->setNombre(“otro Nombre”);

$varUsuario->save();

De esta forma estamos realizando una modificación al registro número 1 de la tabla usuario.

3- Podemos eliminar registros:

$varUsuario = new Usuario(1);

$varUsuario->delete();

De esta forma el registro 1 de la tabla usuario queda eliminado.

4- También podemos trabajar con colecciones:

$conjuntoUsuarios = new CollectionUsuario(); //Trae todos los usuarios

echo $conjuntoUsuarios->Usuario[0]->getNombre();

// mostramos el nombre del primer Usuario de la colección.

5- Podemos crear un colección con condiciones:

$conjuntoUsuarios = new CollectionUsuario(“nombre=’Luis’”);

echo $conjuntoUsuarios->Usuario[0]->getNombre();

// La colección estará compuesta por los registros que cumplan la condición.

12 – UTILIZANDO LAS SJS

En simplePHP tenemos la posibilidad de trabajar en el cliente con JS con los datos de las tablas, tenemos que tener en cuenta que esto es muy peligroso si no se tiene los conocimientos necesarios para aplicar diferentes métodos de seguridad a nuestro sistema.

Las Clases JS se comunican con las clases PHP a través de JSON.

1- Nuevo usuario:

nuevoUsu = new Usuario();

nuevoUsu.nombre = ‘mi Nombre’;

nuevoUsu.password = ‘mi Password’;

nuevoUsu.save(

function(respuesta)

{

if(respuesta==’OK’)

{

alert(‘Usuario Guardado..’);

}

else

{

alert(‘Se produjo un error…’);

}

}

);

2- Modificando el usuario 1 de la tabla:

Usuario(1,function(miUsuario)

{

miUsuario.nombre = ‘Nuevo Nombre’;

miUsuario.save();

});

3- Eliminar el usuario 1 de la tabla:

Usuario(1,function(miUsuario)

{

miUsuario.delete();

});

Muchas Gracias por su Tiempo…!!!

No comments yet.

Leave a Comment