cgi.pris

 * 
 * Prisma cgi-0.2  by Adalberto Amorim Felipe
 * linguagemprisma.br4.biz
 * linguagemprisma@gmail.com
 * 
 * Caso encontre um bug reporte em: 
 * 
 * https://linguagemprisma.br4.biz/prisma_forum/index.php?board=6.0
 * 
 * ----------------------------
 * Licença: 
 * Livre para usar como bem entender, não há garantias, 
 * use por conta e risco, o autor não poderá ser
 * responsabilizado.
 * 
 * ----------------------------
 * 
 * funções com facilidades para programas cgi web em Prisma:
 * 
 * leitura de variaveis do servidor
 * decodificação de post e Get.
 * obtenção de variaveis do post e Get. 
 * conversao de variaveis do post e get para tabela prisma
 *

Funções:

Voltar ao início

funcao cgi.va.serv_soft ( )

Função cgi.va.serv_soft() retorna a variável de ambiente 'SERVER_SOFTWARE'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.serv_nome ( )

Função cgi.va.serv_nome() retorna a variável de ambiente 'SERVER_NAME'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.serv_assinatura ( )

Função cgi.va.serv_assinatura() retorna a variável de ambiente 'SERVER_SIGNATURE'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.serv_protocolo ( )

Função cgi.va.serv_protocolo() retorna a variável de ambiente 'SERVER_PROTOCOL'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.serv_porta ( )

Função cgi.va.serv_porta() retorna a variável de ambiente 'SERVER_PORT'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.gateway_interface ( )

Função cgi.va.gateway_interface() retorna a variável de ambiente 'GATEWAY_INTERFACE'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.metodo ( )

Função cgi.va.metodo() retorna a variável de ambiente 'REQUEST_METHOD'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

O retorno pode ser 'GET' ou 'POST', por exemplo.

Voltar ao início

funcao cgi.va.path_info ( )

Função cgi.va.path_info() retorna a variável de ambiente 'PATH_INFO'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.path_translated ( )

Função cgi.va.path_translated() retorna a variável de ambiente 'PATH_TRANSLATED'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.nome_script ( )

Função cgi.va.nome_script() retorna a variável de ambiente 'SCRIPT_NAME'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.var_string ( )

Função cgi.va.var_string() retorna a variável de ambiente 'QUERY_STRING'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.host_remoto ( )

Função cgi.va.host_remoto() retorna a variável de ambiente 'REMOTE_HOST'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.ip_remoto ( )

Função cgi.va.ip_remoto() retorna a variável de ambiente 'REMOTE_ADDR'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.tipo_autent ( )

Função cgi.va.tipo_autent() retorna a variável de ambiente 'AUTH_TYPE'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.usuario_remoto ( )

Função cgi.va.usuario_remoto() retorna a variável de ambiente 'REMOTE_USER'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.remote_ident ( )

Função cgi.va.remote_ident() retorna a variável de ambiente 'REMOTE_IDENT'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.tipo_conteudo ( )

Função cgi.va.tipo_conteudo() retorna a variável de ambiente 'CONTENT_TYPE'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.tamanho_conteudo ( )

Função cgi.va.tamanho_conteudo() retorna a variável de ambiente 'CONTENT_LENGTH'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

O tamanho em bytes...

Voltar ao início

funcao cgi.va.http_aceito ( )

Função cgi.va.http_aceito() retorna a variável de ambiente 'HTTP_ACCEPT'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.http_nav ( )

Função cgi.va.http_nav() retorna a variável de ambiente 'HTTP_USER_AGENT'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.http_url_atual ( )

Função cgi.va.http_url_atual() retorna a variável de ambiente 'HTTP_REFERER'

Esta função foi modificada para http_url_referencia(), está aqui somente para compatibilidade com a versão anterior, e possivelmente no futuro será excluída.

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.http_url_referencia()

Função cgi.va.http_url_referencia() retorna a variável de ambiente 'HTTP_REFERER'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.pasta_servidor ( )

Função cgi.va.pasta_servidor() retorna a variável de ambiente 'DOCUMENT_ROOT'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.http_de ( )

Função cgi.va.http_de() retorna a variável de ambiente 'HTTP_FROM'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.https ( )

Função cgi.va.https() retorna a variável de ambiente 'HTTPS'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.path ( )

Função cgi.va.path() retorna a variável de ambiente 'PATH'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.http_cookie ( )

Função cgi.va.http_cookie() retorna a variável de ambiente 'HTTP_COOKIE'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.script_abs ( )

Função cgi.va.script_abs() retorna a variável de ambiente 'SCRIPT_FILENAME'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.va.serv_admin ( )

Função cgi.va.serv_admin() retorna a variável de ambiente 'SERVER_ADMIN'

Parâmetros:

sem parâmetros;

Retornos:

(string) - retorna a variável de ambiente ou string vazia caso não esteja definida.

Voltar ao início

funcao cgi.decod(str)

Função cgi.decod(s) retorna uma string decodificada a partir de uma string obtida pelo método GET ou POST.

Parâmetros:

s(string) - é a string obtida do GET ou POST para ser processada e decodificada os caracteres com escape %%nn

Retornos:

(string) - retorna a string decodificada

Esta função geralmente é usada internamente, mas pode ser usada normalmente caso precise trocar os %%nn pelos caracteres equivalentes. Por exemplo, o '%20' é trocado por um espaço, o '+' também é trocado por um espaço. e o '%22' é trocado por uma aspa "

Voltar ao início

funcao cgi.obt_var(str,var)

funcao cgi.obt_var(str, var) - obtem o valor de uma chave especifica a partir do GET ou POST

Parâmetros:

str(string) - a string obtida pelo GET ou POST para ser analisada a fim de buscar o valor de uma chave específica.

var(string) - a chave a ser buscada pelo seu valor na string obtida pelo GET ou POST.

Retornos:

(string) - o valor da chave buscada na string obtida pelo GET ou POST.

Veja o exemplo abaixo:

Supondo uma string: 'nome_user=manoel&telefone=66xxxxx-xxxx'

📋

   
local cgi = inclua'cgi';
local querystr = cgi.va.var_string(); //o mesmo que sis.obtvarambiente('QUERY_STRING');
local nome_user = cgi.obt_var(querystr, 'nome_user');
local telefone = cgi.obt_var(querystr, 'telefone');
imprima('Nome do usuário:', nome_user);
imprima('Telefone do usuário:', telefone);

   
local cgi = inclua'cgi';
local querystr = cgi.va.var_string(); //o mesmo que sis.obtvarambiente('QUERY_STRING');
local nome_user = cgi.obt_var(querystr, 'nome_user');
local telefone = cgi.obt_var(querystr, 'telefone');
imprima('Nome do usuário:', nome_user);
imprima('Telefone do usuário:', telefone);

Voltar ao início

funcao cgi.obt_tabvar(str)

funcao cgi.obt_tabvar(str) -- retorna uma tabela com todos as chaves e valores obtidos pelo método GET ou POST.

Parâmetros:

str(string) -- é a string obtida pelo método GET ou POST.

Retornos:

(tabela) -- o retorno é uma tabela com todas as chaves obtidas por GET ou POST.

Veja o exemplo abaixo, supondo uma string: 'nome_user=manoel&telefone=66xxxxx-xxxx'

📋

Exemplo Prisma

local cgi = inclua'cgi';
local querystr = cgi.va.var_string();
local tab = cgi.obt_tabvar(querystr);
imprima('Nome do usuário:', tab.nome_user);
imprima('Telefone do usuário:', tab.telefone);


local cgi = inclua'cgi';
local querystr = cgi.va.var_string();
local tab = cgi.obt_tabvar(querystr);
imprima('Nome do usuário:', tab.nome_user);
imprima('Telefone do usuário:', tab.telefone);

Lembrando que esses exemplos devem rodar apropriadamente em um ambiente servidor no modo cgi. Veja: https://linguagemprisma.br4.biz/blog/?s=cgi

Variáveis

Voltar ao início

local cgi = {};

cgi(tabela) - variável contendo os métodos desta biblioteca.

Voltar ao início

cgi.va = {};

cgi.va(tabela) - variável contendo os métodos para obter as variáveis de ambiente.

Voltar ao início

cgi.GET = {};

cgi.GET (tabela) - é a tabela que torna possível acessar diretamente os dados do cliente pelo método GET;

Veja o exemplo:

📋

Prisma

  local cgi = inclua'cgi';
  imprima('Nome do cliente:', cgi.GET['nome']);

  1
  2

  local cgi = inclua'cgi';
  imprima('Nome do cliente:', cgi.GET['nome']);

Voltar ao início

cgi.POST = {};

cgi.POST (tabela) - é a tabela que torna possível acessar diretamente os dados do cliente pelo método POST;

Veja o exemplo:

📋

  local cgi = inclua'cgi';
  imprima('Nome do cliente:', cgi.POST['nome']);

  1
  2
  3


  local cgi = inclua'cgi';
  imprima('Nome do cliente:', cgi.POST['nome']);

cgi.pris

Adalberto

24 nov 2023

Funções:

Variáveis:

cgi.pris

Funções:

funcao cgi.va.serv_soft ( )

Parâmetros:

Retornos:

funcao cgi.va.serv_nome ( )

Parâmetros:

Retornos:

funcao cgi.va.serv_assinatura ( )

Parâmetros:

Retornos:

funcao cgi.va.serv_protocolo ( )

Parâmetros:

Retornos:

funcao cgi.va.serv_porta ( )

Parâmetros:

Retornos:

funcao cgi.va.gateway_interface ( )

Parâmetros:

Retornos:

funcao cgi.va.metodo ( )

Parâmetros:

Retornos:

funcao cgi.va.path_info ( )

Parâmetros:

Retornos:

funcao cgi.va.path_translated ( )

Parâmetros:

Retornos:

funcao cgi.va.nome_script ( )

Parâmetros:

Retornos:

funcao cgi.va.var_string ( )

Parâmetros:

Retornos:

funcao cgi.va.host_remoto ( )

Parâmetros:

Retornos:

funcao cgi.va.ip_remoto ( )

Parâmetros:

Retornos:

funcao cgi.va.tipo_autent ( )

Parâmetros:

Retornos:

funcao cgi.va.usuario_remoto ( )

Parâmetros:

Retornos:

funcao cgi.va.remote_ident ( )

Parâmetros:

Retornos:

funcao cgi.va.tipo_conteudo ( )

Parâmetros:

Retornos:

funcao cgi.va.tamanho_conteudo ( )

Parâmetros:

Retornos:

funcao cgi.va.http_aceito ( )

Parâmetros:

Retornos:

funcao cgi.va.http_nav ( )

Parâmetros:

Retornos:

funcao cgi.va.http_url_atual ( )

Parâmetros:

Retornos:

funcao cgi.va.http_url_referencia()

Parâmetros:

Retornos:

funcao cgi.va.pasta_servidor ( )

Parâmetros:

Retornos:

funcao cgi.va.http_de ( )

Parâmetros:

Retornos:

funcao cgi.va.https ( )