Archivo del sitio

Programando Clon MVC y WebApi en PHP (Parte 2)


En el apartado anterior hemos visto un ejemplo de como integrar las plantillas de Bootstrap a nuestra aplicación PHP, en este apartado veremos como crear un webApi, apoyandonos en los archivos .htacess y un pequeño modelito de web services rest de php que personalmente uso, si quieres ver como hacer servicios rest con php sin necesidad de Frameworks o librerías externas puedes echar una ojeada a esta entrada. Si has llegado a esta entrada por otros medios te recomiendo que leas esta serie de posts desde el primero.

Luego de todo el choro, manos a la obra, en esta ocasion nuesta atención se centrará en la carpeta service que se encuentra en la carpeta raíz de nuestra solución, este será el arbol de archivos que crearemos:

  • index.php
  • .htaccess
  • controller
    • Student.php

index.php

El archivo index.php nos permitirá obtener la información rest de los siguientes metodos GET,POST,PUT,DELETE, permitiendonos obtener la información directa y la llamada al recurso que corresponde como vemos en el siguiente código:

 


<?php 
header('Content-Type: application/json'); 
ini_set("allow_url_fopen", true); 
error_reporting(0); 
@session_start(); 
$path = parse_url($_SERVER["REQUEST_URI"], 5); 
$path = str_replace("/StudentWeb/service/", "", $path); 
$path = trim($path, "/"); 
@list($resource, $params) = explode("/", $path, 2); 
$method = strtolower($_SERVER["REQUEST_METHOD"]); 
$params = !empty($params) ? explode("/", $params) : array(); 
include("controller/". $resource .".php"); 
if (class_exists($resource)) { 
try { 
$resource = new $resource($params); 
$resource->{$method}();
    }
    catch (Exception $e) {
        @header("HTTP/1.1 500 Internal Server Error");
    }
}
else {
    @header("HTTP/1.1 404 File Not Found");
  echo "Error";
}
?>

Este código nos permite generar una ruta directa del index a cualquier controller, podria decirce que es un reflection o algo así:

.htaccess


<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /StudentWeb/service/index.php
</IfModule>

Este código htaccess nos permite redireccionar cualquier url que vaya en la dirección /StudentWeb/service/ al index.php que anteriormente creamos, dandonos la accesibilidad a la ruta /StudentWeb/service/Student/

Finalmente llegamos a nuestra carpeta controller dentro de la ruta /StudentWeb/service/controller/ la cual se encarga de contener todas nuestras claces relacionadas con nuestro servicio rest (clon de web api) editaremos el archivo Student.php que queda de la siguiente manera:


<?php
class Student {
	var $params;
	var $jsonParams;
    
	function Student($params="") {
		$this->params = $params;
		$content = file_get_contents("php://input", NULL, NULL, 0, 1000);
		$data = json_decode($content,true);
		$this->jsonParams = json_encode($data);
	}

	function get() {
		
		if (!$_SESSION["Students"]) {
			$_SESSION["Students"]  = array();
		}
		$Students["Students"] = $_SESSION["Students"];
		echo json_encode($Students);
	}

	function post() {
		try {
			$Students  = $_SESSION["Students"];
			$Student = $this->jsonParams; 
			$Sutdents = array();
			$Student["NoControl"] = Count($Students)+1;
			$Sutdents[] = $Student;
			$_SESSION["Students"] = $Sutdents;
			$result["success"] = true;
			$result["AdditionalData"] = $Student["NoControl"];
			echo json_encode($result);
		} catch(Exception $e) {
			$result["success"] = false;	
			$result["Description"] = $e;
			echo json_encode($result);
		}
	}
    
	function put() {
		$Student = $this->jsonParams;
		$Students  = $_SESSION["Students"];
		try {
			for ($i = 0; $i <= Count($Students); $i++) {
				if ($Students[$i]["NoControl"] == $Student["NoControl"]) {
					$Students[$i]["Name"] = $Student["Name"];
					$Students[$i]["Paternal"] = $Student["Paternal"];
					$Students[$i]["Maternal"] = $Student["Maternal"];
					$Students[$i]["Semestre"] = $Student["Semestre"];
				}
			}
			$_SESSION["Students"] = $Students;
			$result["success"] = true;
			echo json_encode($result);
		}
		catch (Exception $e) {
			$result["success"] = false;	
			$result["Description"] = $e;
			echo json_encode($result);
		}
	}
	
	function delete() {
		$NoControl = $this->jsonParams["NoControl"];
		$Students  = $_SESSION["Students"];
		$StudentsWithOutItems  = array();
		try {
			for ($i = 0; $i <= Count($Students); $i++) {
				if ($Students[$i]["NoControl"] != $NoControl) {
					$Student["NoControl"] = $Students[$i]["NoControl"];
					$Student["Name"] = $Students[$i]["Name"];
					$Student["Paternal"] = $Students[$i]["Paternal"];
					$Student["Maternal"] = $Students[$i]["Maternal"];
					$Student["Semestre"] = $Students[$i]["Semestre"];
					$StudentsWithOutItems[] = $Student;
				}
			}
			$_SESSION["Students"] = $StudentsWithOutItems;
			$result["success"] = true;
			echo json_encode($result);
		}
		catch (Exception $e) {
			$result["success"] = false;	
			$result["Description"] = $e;
			echo json_encode($result);
		}
	}
}
?>

como podemos ver nuestro código tiene 4 metodos que son los que serán expuestos en el recurso GET,POST,PUT,DELETE, estos metodos serán llamados directamente por el index y seran redirigidos a la clase Student los metodos de entrada serán en GET y DELETE de la siguiente forma

GET /StudentWeb/service/Student/

DELETE /StudentWeb/service/Student/?NoControl=1

POST /StudentWeb/service/Student/

PUT /StudentWeb/service/Student/

En el caso de los metodos POST y PUT se debe enviar en los headers en el modelo de JSON un jemplo de esto lo veremos en la siguiente entrega cuando agregemos las llamadas de Ajax con JQuery, y veremos como hacer pruebas de nuestro servicio.

En la proxima entrega veremos como hacer llamadas javascript y ensamblaremos las vistas.

Download

Anuncios

Programando Clon MVC y WebApi en PHP (Parte 1)


Como muchos desarrolladores .NET saben el MVC de Visual Studio tiene un patron bastante organizado, lo suficientemente organizado como para copiarlo a PHP y tratar de organizar nuestro código de una manera más comoda, en las entradas anteriores vimos como crear un patron de este tipo con Visual Studio, ahora, haremos lo mismo pero para nuestros compañeros desarrolladores en PHP 😉 que tambien es uno de mis lenguajes favoritos.

Comenzaremos creando nuestro “Esqueleto” de aplicación dentro de una carpeta StudenWeb que debe quedar como la siguiente:

Explicación de las carpetas:

Controllers : Es una carpeta reservada para hacer llamadas post internas dentro de las vistas un ejemplo de esto es la subida de archivos, muestra de imagenes protegidas entre otras cosas.

css : Guardará todos los archivos de Estilos de html.

fonts : Donde se guardan los archivos de tipografias e iconos.

Helpers : Funciones que podriamos utilizar dentro de nuestro sistema.

img : Archivos y Carpetas de Imagenes necesrios para nuestras vistas.

js : Archivos de JavaScritp.

Views : Archivos PHP con el código minimo, y en su mayor parte html.

service : Archivo donde crearemos nuestro webApi

A partir de aquí buscaremos una plantilla Bootstrap, como muchos de los lectores de este blog saben no soy muy afecto a crear diseños web, podemos descargarlo de la siguiente ruta https://startbootstrap.com/template-overviews/sb-admin/ (Es de mis favoritos), ahora veremos como integrar nuestro diseño de bootstrap a nuestro cascaron en PHP, analicemos las carpetas que tiene nuestra plantilla:

Bien, podemos encontrar dentro de las carpetas que nos interesan css, fonts-awesome, fonts, js, estas carpetas deben ser copiadas a nuestro proyecto de MVC lo haremos de la siguiente manera:

  1. Todo el contenido de la carpeta css será copiado a la carpeta css de nuestra solucion.
  2. Todo el contenido de la carpeta js será copiado a la carpeta js de nuestra solución.
  3. En cuanto a la carpeta fonts-awesome encontraremos las siguientes carpetas css, less, scss y fonts.
    1. Tomaremos el contenido de css que esta dentro de la carpeta fonts y será copiado a nuestra carpeta css.
    2. Tomaremos el contenido de la carpeta fonts y lo pasaremos a nuestra carpeta fonts

 

Una vez realizados estos pasos crearemos nuestro arbol en la carpeta de vistas, ya que es necesario que tengamos nuestra iformación de los php con contenido de html dentro de carpetas el arbol de archivos es el siguiente:

  • Views
    • Home
    • Shared

Despues de esto en nuestra carpeta raiz, crearemos un index.php, en el cual pondremos nuestro siguiente código:

<?php 
error_reporting(5); 
include('Views/Shared/_Layout.php'); ?>

 

Este codigo nos permite evitar los multiples notices que nos mostrará el wamp e incluir el archivo _Layout.php, el cual debe contener la información del index.hml de nuestro template que acabamos de bajar:

La imagen anteroir contiene el codigo recortado y colapsado para que se pueda apreciar mejor, no agregaremos la información tal como esta haremos unos pequeños cambios, que son en las siguientes lineas:

 

Cambio 1

<link href="font-awesome/css/font-awesome.min.css" rel="stylesheet" type="text/css">

Será cambiado por:

<link href="css/font-awesome.css" rel="stylesheet" type="text/css">

Cambio 2

Se quitará el contenido dentro de la etiqueta <div class=”container-fluid”> (Guardalo en un notepad que lo usaremos despues)

Cambio 3

Se tomarán las referencias a los JavaScripts y se pasarán después de las referencias css, como se ve en la siguiente imagen:

Una vez realizado esto copiaremos nuestro código a nuestro archivo _Layout.php. Una vez copiado crearemos dentro de la etiqueta <div class=”container-fluid”> un switch como el siguiente

 

<?php 
switch ($_GET["Source"]) { 
case "Students": include('Views/Student/Student.php'); break; 
default: include('Views/Home/Dashboard.php'); break; 
} 
?>

Finalizando estos cambios el sistema ya se encuentra funcional, para finalizar vamos a crear un archivo en la ruta Views/Home/ que se llamará Dashboard.php en el cual agregaremos el contenido que anteriormente se encontraba dentro de

que debio ser guardado en algún notepad en el cambio 2.

Una vez hecho esto nuestro esqueleto PHP de MVC con webApi esta terminado y para poder visualizar que mejor que meterlo en el wamp para verlo funcionando:

Con este cambio finalizamos esta entrega, ya tenemos nuestro esqueleto MVC con Bootstrap, y en la proxima entrega veremos como configurar el webApi, esta información tambien es explicada en mi libro que sera puesto a la venta en Amazon en un par de meses.

Download

Programando con MVC y WebApi en C# (Parte 1)


MVC (Modelo Vista Controlador) es un patrón de diseño que separa los datos de y la lógica de negocio de una Aplicación cualquiera que sea su contexto, para esto el lenguaje de .NET Ya tiene una solución que se encuentra en ASP.NET Web Application (.NET Application)

Después de seleccionar el nombre de nuestra solución nos aparecerá la siguiente ventana:

Una vez seleccionado el Web API y cambiado el modo de autenticación podemos proceder a ver nuestra solución creada, como la siguiente:

En lo personal el modo en que Microsoft Arreglo el modelo no es de mi completo agrado comenzaremos explicado los contenidos de nuestras carpetas:

Content: en la carpeta content se encuentran los contenidos de plantillas de Estilos y las imagenes
Controllers: es la carpeta que contiene los contenidos de las llamadas a servidor, en mi caso solo es utilizado para la seguridad Login, Registro y Recuperación de Usuarios
fonts: Las fuentes que serán usadas en nuestro template
Models: Las clases para serializar y hablar entre los controllers
Scripts: Los JavaScripts que serán utilizados
View: Finalmente las Vistas que serán utilizadas para presentar nuestra pagina

Como ta habia escrito anteriormente no soy partidario de los nombres que microsoft le ha puesto a las carpetas por lo tanto procederé a borrar las siguientes carpetas y a crear unas nuevas

Carpetas a borrar:

  • Content
  • Scripts

Carpetas a crear:

  • css
  • js
  • img
  • service

Una vez realizado esto nuestro proyecto quedará así:

A partir de aquí buscaremos una plantilla Bootstrap, como muchos de los lectores de este blog saben no soy muy afecto a crear diseños web, podemos descargarlo de la siguiente ruta https://startbootstrap.com/template-overviews/sb-admin/ (Es de mis favoritos), ahora veremos como integrar nuestro diseño de bootstrap a nuestro desbalijado proyecto en .NET, analicemos las carpetas que tiene nuestra plantilla:

Bien, podemos encontrar dentro de las carpetas que nos interesan css, fonts-awesome, fonts, js, estas carpetas deben ser copiadas a nuestro proyecto de MVC lo haremos de la siguiente manera:

  1. Todo el contenido de la carpeta css será copiado a la carpeta css de nuestra solucion.
  2. Todo el contenido de la carpeta js será copiado a la carpeta js de nuestra solución.
  3. En cuanto a la carpeta fonts-awesome encontraremos las siguientes carpetas css, less, scss y fonts.
    1. Tomaremos el contenido de css que esta dentro de la carpeta fonts y será copiado a nuestra carpeta css.
    2. Tomaremos el contenido de la carpeta fonts y lo pasaremos a nuestra carpeta fonts
  4.  Regresaremos a visual studio.

En visual studio ya una vez copiados todos nuestros archivos es necesario dar click al icono Show All Files, para permitirnos ver todos los archivos e incluirlos en el código, si no hiciéramos esta operación, al momento de compilar no nos agregará los archivos en el modo de publicación. Para incluir a los archivos podemos dar click derecho en el archivo o los archivos que queremos incluir, y buscamos en el menú la sección incluir en proyecto:

Y así lo haremos con todos los archivos que hayamos copiado a nuestra solución.

Con esto tenemos nuestros archivos para usar listos, ahora hay que introducirnos en la carpeta App_Star esta carpeta contiene los siguientes Archivos:

  • BundleConfig.cs: Sirve para agrupar varios archivos JavaScript y en un mismo archivo. permitiendo un mejor performance.
  • FilterConfig.cs: Nos permite crear filtros de acción que son atributos que pueden asociarse a una acción de un controlador o al controlador en su totalidad.
  • RouteConfig.cs: Es la clase que se encarga de la configuración de las rutas de los controllers por defecto.
  • WebApiConfig.cs:  Esta clase es la encargada de configuración de las rutas de cualquier servicio expuesto en el webApi.

Ahora que sabemos esto vamos a reconstruir el BundleConfig, recordemos que hemos borrado todos los recursos css y javascript con los que venia nuestra solución por defecto, si abrimos el archivo nos mostrará algo como lo siguiente:

La información que nos interesa para el Registro de Bundles es ScriptBundle y StyleBundle que son las que tenemos que registrar para tener una idea de lo que tenemos que hacer, debemos abrir nuestro archivo index de nuestra plantilla de bootstrap que contiene algo como lo siguiente:

Así pues escribiremos nuestros Bundles de css de la siguiente manera:

Y del mismo modo cambiaremos crearemos nuestros Bundles de JavaScript que quedan del siguiente modo:

Esto nos permitirá obtener los js y css de una manera simple en .NET. ahora bien, vamos a incorporar la plantilla directamente a nuestras vistas, para esto nos dirigiremos a la carpeta View y dentro de la misma la carpeta Shared y dentro de ella un _Layout.cshtml en el cual encontraremos la vista principal de nuestro html el cual muestra algo como lo siguiente:

Bien borraremos algunas cosas para que queden de la siguiente manera:

Esta es la versión menor del archivo y es la manera en como yo lo ordeno cuando voy a pasar una plantilla nueva ahora abriremos nuevamente nuestro archivo index para ir copiando de poco en poco, primero copiaremos la información del head, desde el inicio del encabezado hasta la sección del title, y poniendo la información de nuestro bundle recién, creado quedando el código como el siguiente:

Después de esta parte la cosa se complica un poco, pero créanme que vale la pena verlo terminado, nos dirigiremos de nueva cuenta a nuestra plantilla de bootstrap y buscaremos la etiqueta div siguiente

, comenzaremos a copiar de ese div hasta el div

y esta información será copiada entre y la función @RenderBody() de nuestro archivo _Layout.cshtml  y después de @RenderBody() cerraremos tres etiquetas quedando como en la siguiente imagen:

En este caso la barra de Navegación se encuentra colapsada para no tener que poner una imagen tan grande, espero se entienda. A hora no dedicaremos a la sección que no hemos copiado, pero esta se encuentra en otro archivo, que esta en la carpeta raíz, View>Home el archivo se llama index.cshtml, primero borraremos todo respetando las siguientes lineas

@{
ViewBag.Title = “Home Page”;
}

después de esas lineas copiaremos toda la sección que no copiamos que se encontraba dentro de la etiqueta <div class=”container-fluid”> quedando el archivo de la siguiente manera:

La imagen no nos muestra todo para meter una imagen más pequeña pero para el caso es lo mismo.

Despues de haber hecho todas estas modificaciones tenemos un Layout en nuestra solución lista para trabajar corremos la aplicación y veremos que queda como la siguiente:

Por hoy terminamos con este apartado, también explicado en el libro que estoy haciendo que sera puesto a la venta en Amazon en un par de meses.

Descargar la Solucion

A %d blogueros les gusta esto: