Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
nefele:ocgi [17/03/2021 20:23] pedro |
nefele:ocgi [29/07/2024 09:03] (actual) pedro |
||
---|---|---|---|
Línea 4: | Línea 4: | ||
Como el oCGI es un MEMVAR que esta definido en Nefele.ch puede hacerse referencia a el desde cualquier parte de nuestra aplicación. | Como el oCGI es un MEMVAR que esta definido en Nefele.ch puede hacerse referencia a el desde cualquier parte de nuestra aplicación. | ||
+ | |||
+ | ===== Propiedades ===== | ||
+ | ^Nombre ^Init ^Descripción ^Versión ^ | ||
+ | |[[ocgi:aCookies]]| | Array de las cookies recibidas. | 0.1| | ||
+ | |[[ocgi:aParams]]| | Array de los parámetros recibidos. | 0.1| | ||
+ | |[[ocgi:aSharedParams]] | {} | [[propiedades:aParams]] que serán añadidos a todos los controles que realicen llamas al CGI| 0.3| | ||
+ | |[[ocgi:aRoutes]]| | Array con las rutas envidas como URL amigable. | 0.1| | ||
+ | |cFunction| "FUNCTION" | Nombre de la propiedad que recibimos que contendrá la función a llamar de nuestro CGI, todos controles que generan llamadas le asignaran este nombre a la propiedad. | 0.1| | ||
+ | |cFunctEndCookie| | Función a ejecutar cuando se recibe un cookie caducado. | 0.1| | ||
+ | |cMainFunction| "MainFunction" | Método del oCGI que sera llamada por defecto si no se indica otra | 0.1| | ||
+ | |cPathTmp| ".\tmp" | Carpeta temporal que utilizara nuestro CGI, por ejemplo para guardar los ficheros adjuntos | 0.1| | ||
+ | |cSameSitePolicy | "lax" | Protección de cookies ([[https://www.tarlogic.com/blog/same-site-cookies-ataques-csrf/|info]])| 0.3| | ||
+ | |lGetData | .t. | Admitimos parámetros pasados por GET | 0.1| | ||
+ | |lGetFunction | .t. | Admitimos funciones pasadas por GET | 0.1| | ||
+ | |lCheckNavigator| .t. | Comprobamos compatibilidad del navegador cliente | 0.1| | ||
+ | |lSendTTFB | .t. | Adjunta al final del HTML, enviado como respuesta, los milisegundos desde la llamada como un comentario, solo funciona en modo [[tecnicas:debugger|Debug]] | 0.1| | ||
+ | |lMsgSavePage| .f. | Nos graba en el fichero "SendPage.html" dentro de la carpeta cgi-bin de Apache, el código Html que se va ha enviar en [[ocgi:sendpage|SendPage()]], muy útil para depurar el código que se enviara al navegador, solo valida en [[tecnicas:debugger|modo Debuger]]. Cuando enviamos con [[ocgi:sendscript|SendScript()]] se guarda en SendScript.html y con [[ocgi:sendjson|SendJSon()]] como SendJSon.html | 0.3| | ||
+ | |nDuracionCookie| | Duración de los cookies por defecto. | 0.1| | ||
+ | |[[nefele:constantes#modos de llamada|nRequestMode]]| | Modo de llamada recibida desde el navegador ver valores posibles en [[nefele:constantes#modos de llamada|Constantes]] | 0.1| | ||
+ | |aSecurityPolicy | {} | Políticas de seguridad a incluir en la cabecera de la conexión | 0.4| | ||
+ | | **Tratamiento de variables de sesión** ||| | ||
+ | |UserData | { => } | Hash con los datos de sesión | 0.5| | ||
+ | |lServerSession | .t. | indica si guardamos las sesiones en un fichero del servidor o como cookies en el navegador del usuario | 0.5| | ||
+ | |cServerSession | | Nombre del fichero donde guardamos la sesión, se genera aleatoriamente cuando utilizamos sessiones | 0.5| | ||
+ | |nSessionExpire | 365 | Días a los que expira el cookie de sesión | 0.5| | ||
+ | |cSessionCookie | "APPDATA" | Nombre del cookie de sesión y extensión de los ficheros de sesión | 0.5| | ||
+ | |cPathSession | | Carpeta donde se guardan los ficheros de sesión ( por defecto: cgi-bin\sessions\ ) | 0.5| | ||
+ | |||
| | ||
===== Métodos ===== | ===== Métodos ===== | ||
Línea 11: | Línea 39: | ||
| **Tratamiento de parámetros recibidos** || | | | **Tratamiento de parámetros recibidos** || | | ||
|[[ocgi:GetCgiValue]] | Recuperación del valor de un parámetro recibido. | 0.1| | |[[ocgi:GetCgiValue]] | Recuperación del valor de un parámetro recibido. | 0.1| | ||
+ | |[[ocgi:GetCgiValue|GetValue]] | | 0.5| | ||
|[[ocgi:GetCgiArray]] | Recuperación del array de selecciones de un parámetro recibido. | 0.1| | |[[ocgi:GetCgiArray]] | Recuperación del array de selecciones de un parámetro recibido. | 0.1| | ||
+ | |[[ocgi:GetCgiArray|GetArray]] | | 0.5| | ||
|[[ocgi:GetCgiType]] | Recuperación del tipo de valor de un parámetro recibido. | 0.1| | |[[ocgi:GetCgiType]] | Recuperación del tipo de valor de un parámetro recibido. | 0.1| | ||
+ | |[[ocgi:GetCgiType|GetType]] | | 0.5| | ||
|[[ocgi:GetCgiFile]] | Recuperación del fichero temporal recibido en un parámetro recibido. | 0.1| | |[[ocgi:GetCgiFile]] | Recuperación del fichero temporal recibido en un parámetro recibido. | 0.1| | ||
+ | |[[ocgi:GetCgiFile|GetFile]] | | 0.5| | ||
+ | |[[ocgi:GetCgiMethod]] | Recuperación el método de recepción del Param (rmGET o rmPOST). | 0.4| | ||
+ | |[[ocgi:GetCgiMethod|GetMethod]] | | 0.5| | ||
+ | |[[ocgi:GetCgiBuffer]] | Recuperación del valor en Bruto sin tratar. | 0.5| | ||
+ | |[[ocgi:GetCgiBuffer|GetBuffer]] | | 0.5| | ||
|[[ocgi:aParamsToHash]] | Nos retorna un Hash con todos los parámetros recibidos. | 0.1| | |[[ocgi:aParamsToHash]] | Nos retorna un Hash con todos los parámetros recibidos. | 0.1| | ||
| **Tratamiento de Cookies** || | | | **Tratamiento de Cookies** || | | ||
Línea 33: | Línea 69: | ||
|[[ocgi:GetSharedParam]] | Recupera el valor de un aSharedParams. | 0.3| | |[[ocgi:GetSharedParam]] | Recupera el valor de un aSharedParams. | 0.3| | ||
|[[ocgi:DelSharedParam]] | Elimina un aSharedParams. | 0.3| | |[[ocgi:DelSharedParam]] | Elimina un aSharedParams. | 0.3| | ||
+ | | **Tratamiento de variables de sesión** || | | ||
+ | |[[ocgi:GetUserData]] | Obtiene el valor de una variable de sesión del conjunto de variables almacenado en el Hash ::UserData | 0.5| | ||
+ | |[[ocgi:GetUserDatas]] | Obtiene un array de {NombreVariable,Valor} con todas las variables de sesión del Hash ::UserData | 0.5| | ||
+ | |[[ocgi:HasUserData]] | Devuelve si existe la variable en el hash ::UserData | 0.5| | ||
+ | |[[ocgi:Params2UserData]] | Establece un valor Userdata para cada aParams del CGI | 0.5| | ||
+ | |[[ocgi:ResetUserData]] | Borra todos los elementos del hash | 0.5| | ||
+ | |[[ocgi:SetUserData]] | Añade al conjunto de variables de sesión una nueva variable | 0.5| | ||
+ | |[[ocgi:UnsetUserData]] | Borra un elemento del hash | 0.5| | ||
| **Otros Métodos** || | | | **Otros Métodos** || | | ||
|[[ocgi:Console]] | Podemos enviar mensajes a [[utilidades:nefeleconsole|Néfele Console]] para facilitar la depuración. | 0.1| | |[[ocgi:Console]] | Podemos enviar mensajes a [[utilidades:nefeleconsole|Néfele Console]] para facilitar la depuración. | 0.1| | ||
Línea 39: | Línea 83: | ||
|[[ocgi:Tiempos]] | Utilidad para poner puntos de control de tiempo de ejecución en nuestro CGI. | 0.1| | |[[ocgi:Tiempos]] | Utilidad para poner puntos de control de tiempo de ejecución en nuestro CGI. | 0.1| | ||
|[[ocgi:AddDeprecated]] | Añade un mensaje a la lista de "Deprecated". | 0.1| | |[[ocgi:AddDeprecated]] | Añade un mensaje a la lista de "Deprecated". | 0.1| | ||
- | |||
- | |||
- | ===== Propiedades ===== | ||
- | ^Nombre ^Init ^Descripción ^Versión ^ | ||
- | |[[ocgi:aCookies]]| | Array de las cookies recibidas. | 0.1| | ||
- | |[[ocgi:aParams]]| | Array de los parámetros recibidos. | 0.1| | ||
- | |[[ocgi:aSharedParams]] | {} | [[propiedades:aParams]] que serán añadidos a todos los controles que realicen llamas al CGI| 0.3| | ||
- | |[[ocgi:aRoutes]]| | Array con las rutas envidas como URL amigable. | 0.1| | ||
- | |cFunction| "FUNCTION" | Nombre de la propiedad que recibimos que contendrá la función a llamar de nuestro CGI, todos controles que generan llamadas le asignaran este nombre a la propiedad. | 0.1| | ||
- | |cFunctEndCookie| | Función a ejecutar cuando se recibe un cookie caducado. | 0.1| | ||
- | |cMainFunction| "MainFunction" | Método del oCGI que sera llamada por defecto si no se indica otra | 0.1| | ||
- | |cPathTmp| ".\tmp" | Carpeta temporal que utilizara nuestro CGI, por ejemplo para guardar los ficheros adjuntos | 0.1| | ||
- | |cSameSitePolicy | "lax" | Protección de cookies ([[https://www.tarlogic.com/blog/same-site-cookies-ataques-csrf/|info]])| 0.3| | ||
- | |lGetData | .t. | Admitimos parámetros pasados por GET | 0.1| | ||
- | |lGetFunction | .t. | Admitimos funciones pasadas por GET | 0.1| | ||
- | |lCheckNavigator| .t. | Comprobamos compatibilidad del navegador cliente | 0.1| | ||
- | |lSendTTFB | .t. | Adjunta al final del HTML, enviado como respuesta, los milisegundos desde la llamada como un comentario, solo funciona en modo [[tecnicas:debugger|Debug]] | 0.1| | ||
- | |lMsgSavePage| .f. | Nos graba en el fichero "SendPage.html" dentro de la carpeta cgi-bin de Apache, el código Html que se va ha enviar en [[ocgi:sendpage|SendPage()]], muy útil para depurar el código que se enviara al navegador, solo valida en [[tecnicas:debugger|modo Debuger]]. Cuando enviamos con [[ocgi:sendscript|SendScript()]] se guarda en SendScript.html y con [[ocgi:sendjson|SendJSon()]] como SendJSon.html | 0.3| | ||
- | |nDuracionCookie| | Duración de los cookies por defecto. | 0.1| | ||
- | |[[nefele:constantes#modos de llamada|nRequestMode]]| | Modo de llamada recibida desde el navegador ver valores posibles en [[nefele:constantes#modos de llamada|Constantes]] | 0.1| | ||
Línea 95: | Línea 119: | ||
~~DISCUSSION|Comentarios oCGI~~ | ~~DISCUSSION|Comentarios oCGI~~ | ||
+ | /* | ||
+ | |[[ocgi:Cookie2Session]] | Carga de un archivo en disco las variables de sesión | 0.5| | ||
+ | |[[ocgi:Session2Cookie]] | Graba las variables de sesión en un archivo en disco | 0.5| | ||
+ | |||
+ | |||
+ | */ |