MSR Develop Blog

Posts Tagged ‘tutorial

En esta sección, lo guiaremos para que pueda crear su primer aplicación PRADO, el famoso “Hola Mundo”.

“Hola Mundo” quizas es la aplicación interactiva mas simple que se pueda crear con PRADO. Muestra al usuario final una página con un botón de submit que tiene de titulo Clickeame. Luego que el usuario hace click, el titulo del botón se cambia por “Hola Mundo”

Hay muchas maneras de hacer esto. Una de ellas seria hacerle submit de la página al servidor, examinar la variablede POST y generar una nueva página con el titulo del botón actualizado. O simplemente usar JavaScript para actualizar el título del boton usando el evento OnClick.

PRADO promueve una programacion web basada en componentes y eventos. El botón es representado por un objeto del tipo TButton. Encapsula el titulo del boton en la propiedad Text y la asocia la accion de click en el botón con un evento OnClick del lado del servidor. Para responder al click del usuario en el botón, uno simplemente necesita adjuntarle una función al evento OnClick del botón.

Y en la función, la propiedad Text del botón es modificada a “Hola Mundo”. El siguiente diagrama muestra la secuencia de funcionamiento de todo esto:

sequenciaNuestra aplicación PRADO consiste de estos tres archivos, index.phpHome.page y Home.php, los cuales son reconocidos de la siguiente manera:

directory

Cada directorio (los cuales estan nombrados en ingles) los vamos a explicar ahora. Note que la estructura de directorios de mas arriba pueden ser modificiados. Por ejemplo, usted puede mover el directorio protected para afuera del directorio Web. Usted sabrá hacer esto luego de terminar este tutorial.

  • assets – directorio que guarda los archivos publicados privados. Ver la sección assets para mas detalles.Este directorio debe ser escribible  por el servidor Web.
  • protected – ruta de la aplicación donde se guarda los datos y los scripts privados. Este directorio debe ser configurado como inaccesible a los usuarios finales.
  • runtime – ruta de la aplicación donde se guarda la informacion de runtime(tiempo de ejecución), como el estado de la aplicación, data guardada, etc. Este directorio debe ser escribible por el servidor Web.
  • pages – ruta base para guardar todas las paginas PRADO

Consejo: Usted puede usar framework/prado-cli.php script de linea de comando para crear la estructura de projecto PRADO, como la que se muestra en la imagen de mas arriba. Por ejemplo, puede ejecutar el siguiente comando: php /ruta/hacia/prado-cli.php -c helloworld  ,  o en español /ruta/hacia/prado-cli.php -c holamundo

Los tres archivos necesarios son los siguientes:

  • index.php – el script de entrada para la aplicacion PRADA. Este archivo es requerido por todas las aplicaciones PRADO y es el único script accesible por los usuarios finales. El contenido de index.php consiste basicamente de estas siguientes tres lineas:
require_once('path/to/prado.php');  // incluye el script prado

$application=new TApplication;      // crea una instancia que hace referencia al objeto de la clase TApplication

$application->run();                // corre la aplicacion
  • Home.page – el template para la pagina por defecto retornado cuando los usuarios no especifican la pagina pedida. Un template especifica la capa de presentacion de componentes. En este ejemplo, usamos dos componentes, TForm y TButton los cuales corresponden a los tags HTML <form> e <input> respectivamente. El template tiene el siguiente contenido:
<html>
  <body>
    <com:TForm>
      <com:TButton Text="Clickeame" OnClick="buttonClicked" />
    </com:TForm>
  </body>
</html>

 

  • Home.php -Class para la pagina Home page. Basicamente contiene el método que responde al evento OnClick del botón.
class Home extends TPage
{
    public function buttonClicked($sender,$param)
    {
        // $sender refers to the button component
        $sender->Text="Hola Mundo!";
    }
}

Esta aplicación esta ahora lista para ser accesible desde: http://direccion-servidor-web/helloworld/index.php, asumiendo que el directorio helloworld esta dentro del directorio principal raiz del servidor. Pruebe como práctica cambiar el TButton en Home.page a TLinkButton y ver que pasa 🙂

Consejo : Generalmente la dirección del servidor web es Localhost si esta trabajando en su computador personal y tiene apache corriendo. Pruebe acceder desde : http://localhost/helloworld/ o http://localhost/helloworld/index.php

Puede probar este ejemplo online.

Artóculo: My first PRADO application
Traducción: Martin Sagastume Rue (msr)
Fuente: http://www.pradosoft.com/demos/quickstart/index.php?page=GettingStarted.HelloWorld

Correcciones, comentarios o sugerencias.. déjelo en este post.

Anuncios