Saltar para o conteúdo principal
Versão: Próximo

WEB GET OPTION

WEB GET OPTION ( seletor ; valor )

ParâmetroTipoDescrição
seletorIntegerCódigo da opção a modificar
valorInteger, Text, CollectionValor da opção

Descrição

O comando WEB GET OPTION permite ler o valor atual de uma opção de funcionamento do servidor web de 4D.

O parâmetro seletor indica a opção web a ler. Passe neste parâmetro uma constante do tema Web Server:

ConstanteValorComentário
Web character set17Alcance: 4D local, 4D Server
Descrição: conjunto de caracteres que o servidor Web 4D (com 4D em modo local e 4D Server) utiliza para comunicar-se com os navegadores web que se conectam a base. O valor por defeito depende da linguagem do sistema operativo. Este parâmetro se define nas Propriedades da base.
Valores: os valores possíveis dependem do modo de execução da base relativos ao conjunto de caracteres.
Modo Unicode: quando a aplicação é executada em modo Unicode, os valores a ser passados para este parâmetro são os identificadores de conjunto de caracteres (MIBEnum longint ou nome de cadeia de caracteres, identificadores definidos por IANA, consulte: http://www.iana.org/assignments/character-sets). Está é a lista dos identificadores correspondentes aos conjuntos de caracteres que admite o servidor Web de 4D:
4=ISO-8859-1
12=ISO-8859-9
13=ISO-8859-10
17=Shift-JIS
2024=Windows-31J
2026=Big5
38=euc-kr
106=UTF-8
2250=Windows-1250
2251=Windows-1251
2253=Windows-1253
2255=Windows-1255
2256=Windows-1256Modo compatibilidade ASCII:
0: Ocidental
1: Japonês
2: Chinês
3: Coreano
4: Definido pelo usuário
5: Reservado
6: Europa central
7: Cirílico
8: Árabe
9: Grego
10: Hebraico
11: Turco
12: Nórdico
Web Client IP address to listen23Escopo: Todas máquinas remotas 4D
Mantido entre duas sessões: Sim
Valores possíveis: Ver seletor 16
Descrição: Usado para especificar este parâmetro para todas as máquinas remotas 4D usadas como servidores Web. Os valores definidos usando o seletor são aplicadas a todas as máquinas remotas usadas como servidores WEb. Se quiser definir valores apenas para certas máquinas remotas, use a caixa de diálogo Configurações de banco de dados de 4D em modo remoto.
Web CORS enabled92Escopo: Servidor Web Local
Description: CORS (Cross-origin resource sharing) estado serviço para servidor Web. Se ativdo, XHR (por exemplo. REST) chamdas de páginas Web de fora do domínimo podem ser permitidas na aplicação. (Nota: uma lista de endereços e métodos permitidos para usar o serviço CORS também deve ser definida, ver Web CORS settings). Quando o serviço CORS estiver desativado, petições CORS são ignoradas. Quando o serviço CORS estiver ativado e um domínio ou método não permitido enviar uma petição crosssite, será rejeitada com uma respota de erro "403 - forbidden". Valores possíveis: 0 (desativado, normal) ou 1 (ativado)
Web CORS settings93Escopo: Servidor Web Local
Descripção: Lista de hosts e métodos permitidos para o serviço CORS.
Valores possíveis: Coleção d eobjetos CORS com as propriedades abaixo:
PropriedadeTipoDescrição
[ ].hostTextoObrigatório -- Se host não estiver presente, ou vazio, o objeto é ignorado
Nome de domínio ou endereço IP do qual páginas externas são permitidas de enviar petições de dados para o Servirdor via CORS. Atribútos múltiplos de domínio podem ser adicionados para criar uma white list. Várias sintaxes são compatíveis:
192.168.5.17:8081
192.168.5.17
192.168.*
192.168.*:8081
http://192.168.5.17:8081
http://*.myDomain.com
http://myProject.myDomain.com
*.myDomain.com
myProject.myDomain.com
*
[ ].methodsTextoMétodos de HTTP aceitos para o host CORS correspondente
Separe cada método com ";" (por exemplo.: "post;get")
Se métodos for vazio, null, ou indefinido: todos os métodos estão ativados.
Web debug log84Alcance: servidor web local
Descrição: lhe permite obter ou definir o estado do arquivo de histórico de petições HTTP do servidor Web 4D. Quando for ativado, este arquivo, chamado "HTTPDebugLog_nn.txt", é guardado na pasta "Logs" do aplicativo (nn é o número de arquivo). É útil para problemas de depuração relacionados com o servidor web. Registra cada petição e cada resposta em modo raw. A totalidade das petições, cabeçalhos, se registram; opcionalmente, também se podemn registrar partes do corpo.Para maior informação sobre arquivos HTTPDebugLog, consulte a seção Descrição de arquivos de log.
Valores: uma das constantes com o prefixo "wdl" (consulte as descrições destas constantes neste tema).
Valor por padrão: 0 (não ativado)
Web HSTS enabled86Escopo: 4D local, 4D Server.
Descrição: status HTTP Strict Transport Security (HSTS). HSTS permite que 4D Web server declare que browsers devem interagir apenas com as conexões HTTPS seguras. Quando for ativado, o web server 4D vai adicionar automaticamente informação HSTS-relacionada para todos os cabeçalhos de resposta. Os navegadores vão gravar a informação HSTS na primeiva vez que recebam a resposta do servidor 4D Web, então qualquer petições futuras HTTP vão automaticamente ser transformadas em petições HTTPS. O tamanho de tempo que essa informação será armazenada pelo navegador está especificada com o seletor Web HSTS max age.
HSTS exige que HTTPS esteja ativado no servidor. HTTP também deve estar ativado para permitir conexões iniciais do cliente.
Valores possíveis: 0 (desativado, default) ou 1 (ativado)
Nota: o servidor 4D Web deve ser reiniciado para esta configuração ser aplicada
Web HSTS max age87EScopo: 4D local, 4D Server
Descrição: Especifica o tamanho máximo de tempo (em segundos) que HSTS está ativado para cada nova conexão cliente. Essa informação é armazenada no lado do cliente para a duração especificada.
Valores possíveis: Longint (segundos)
Valor Default: 63072000 (2 anos)

Aviso: Assim que HSTS for ativado, conexões cliente vão continuar a usar esse mecanismo para a duração especificada. Quando estiver testando suas aplicações, é recomendado estabelecer uma duração pequena para poder trocar entre modos de conexão seguro e não seguro se necessário.
Web HTTP compression level50Alcance: Servidor web local**
** Descrição: nível de compreensão para todos os intercâmbios HTTP comprimidos efetuados para o servidor HTTP de 4D (pedidos cliente ou respostas servidor, Web e serviço web). Este seletor permite otimizar os intercâmbios com um enfoque na velocidade de execução (menor compreensão) ou a quantidade de compreensão (menor velocidade). A escolha de um valor depende do tamanho e a natureza dos dados trocados . Passe de 1 a 9 no parâmetro valor, 1 é a compreensão mais rápida e 9 a mais alta. Também pode passar -1 para obter um compromisso entre velocidade e taxas de compreensão. O nível de compreensão por padrão é 1 (compreensão rápida).
Valores possíveis: 1 a 9 (1 = mais rápido, mais comprimido = 9) o -1 = melhor compromisso.
Web HTTP compression threshold51Alcance: Servidor HTTP local
Descrição: em intercâmbios HTTP otimizados, limite de tamanho de petição por debaixo do qual os intercâmbios no devem comprimir-se. Esta opção é útil para evitar perder tempo de máquina para comprimir intercâmbios muito pequenos.
Passe em valor um tamanho em bytes. Por defeito, o limite de compreensão é estabelecido em 1024 bytes.
Valores possíveis: todo valor de tipo inteiro largo. O parâmetro valor contém um tamanho expressado em bytes. Por defeito, o limiar de compreensão está definido em 1024 bytes.
Web HTTP enabled88Escopo: 4D local, 4D Server
Descrição: Status para comunicação vai HTTP.
Valores possíveis: 0 (desativado) ou 1 (ativado)
Web HTTP TRACE85Escopo: Servidor Web Local
Mantido entre duas sessões: Não
Descrição: Permite que ative ou desative o método HTTP TRACE no 4D Web server. Por razões de segurança, a partir de 4D v15 R2, o servidor 4D Web rejeita, como padrão, resquisições HTTP TRACE com um erro 405 (ver HTTP TRACE desativado). Se necessário, pode ativar o método HTTP TRACE para a sessão passando a constante com valor 1. Quando esta opção estiver ativada, o servidor 4D Web responde às requisições HTTP TRACE com a linha de requisição, cabeçalho e corpo.
Possíveis valores: 0 (desativado) ou 1 (ativado)
Valor padrão: 0 (desativado)
Web HTTPS enabled89Alcance: 4D local, 4D Server
Descrição: estado para comunicação sobre HTTPS.
Valores possíveis: 0 (desativado) ou 1 (ativado)
Web HTTPS port ID39Alcance: 4D local, 4D Server
Valores possíveis: 0 a 65535
Descrição: número da porta TCP utilizado pelo servidor web de 4D em modo local e de 4D Server para conexões seguras via TLS (protocolo HTTPS). O número de porta HTTPS se define na página "Web/Configuração" da caixa de diálogo Propriedades da base.
Por defeito, o valor é 443 (valor padrão). Pode utilizar as constantes do tema Números de puerto TCP para o parâmetro valor.
Web inactive process timeout78Alcance: servidor web local
Descrição: permite modificar o timeout do processo utilizado para la sessão (opção relativa ao processo). Depois do timeout, o processo se elimina no servidor, se chama ao Método de banco de dados On Web Legacy Close Session e logo o contexto da sessão é destruída.
Valores: Inteiro longo (minutos)
Valores por defeito: 480 minutos (passe 0 para restabelecer o valor por defeito)
Web inactive session timeout72Alcance: servidor web local
Descrição: permite modificar a duração de vida das sessões inativas (duração definida em cookie). Ao final de este período, a cookie de sessão expira e não se envia mais ao cliente HTTP.
Valores: Inteiro longo (minutos)
Valores por defeito: 480 minutos (passe 0 para restabelecer o valor por defeito)
Web IP address to listen16Escopo: 4D local, 4D Server
Mantido entre sessões: Sim
Descrição: endereços IP nos quais o servidor 4D Web vai receber petições HTTP com 4D em modo local e Servidor 4D. Como padrão, nenhum endereço específico é definido. Este parâmetro pode ser estabelecido nas configurações de Banco de Dados. Este seletor é útil para servidores 4D Web compilados e fusionados com 4D Desktop (no qula não há acesso ao modo design ).
Valores possíveis: endereço IP em forma de string. Ambos formatos string IPv6 (por exemplo, "2001:0db8:0000:0000:0000:ff00:0042:8329") e os formatos string IPv4 (por exemplo, "123.45.67.89") são compatíveis.
Nota: por compatibilidade,os endereços IPv4 expressos como longitudes hexadecimais (obsoletas) ainda são compatíveis
Web legacy session70Alcance: servidor web local
Descrição: permite ativar ou desativar o modo de gestão das sessões (descrito na seção Web Sessions Management (Legacy)).
Valores: 1 (ativar modo) ou 0 (desativar modo)
Valor por defeito: 1 para bases criadas na versão 13, 0 para bases convertidas. Note que este modo ativa igualmente o mecanismo de reutilizar os contextos temporais em modo remoto. Para maior informação sobre este mecanismo, consulte a descrição desta opção na seção Web Server Settings.
Web log recording29Alcance: 4D local 4D Server
Descrição: inicia ou detém o registro de petições solicitações Web recebida pelo servidor web de 4D em modo local ou 4D Server. Por defeito, o valor é 0 (não têm registro de petições).
O registro das petições web é guardado em um arquivo texto chamado "logweb.txt" que encontra automaticamente na pasta Logs da base, junto ao arquivo de estrutura. O formato deste arquivo é determinado pelo valor que seja passado. Para mais informação sobre os diferentes formatos de registro das petições, consulte a seção [#title id= "2833"/]. A ativação deste arquivo também pode ser definido na página "Web/Avanzado" das Preferências de 4D.
Valores possíveis: 0 = Não guardar (por defeito), 1 = Registrar em formato CLF, 2 = Registrar em formato DLF, 3 = Registrar em formato DLF, 4 = Guardar em formato WLF.
Atenção: os formatos 3 e 4 formatos são formatos personalizados, os conteúdos devem ser definidos de antemão nas Preferências da aplicação, página "Web/Formato do registro". Se você utilizar um destes formatos sem que seus campos sejam selecionados, o arquivo das petições não será gerado.
Web max concurrent processes18Alcance: 4D local, 4D Server
Descrição: limite estritamente superior no número de processos de web de todos os tipos aceitos pelo servidor web com o 4D Server e 4D em modo local. Quando o número atinge limite (menos um), 4D não cria um novo processo e retorna a mensagem "Servidor não disponível" (estado HTTP 503 - Serviço indisponível) para qualquer nova solicitação.
Este parâmetro impede a saturação do servidor Web 4D que podem ocorrer durante um envio maciço de solicitações ou uma demanda excessiva para a criação de contextos. Ele também pode ser definido nas propriedades da caixa de diálogo base.
Em teoria, o número máximo de processos de web é o resultado de dividir a memória disponível / tamanho de um pilha de um processo web. Outra solução é para exibir informações sobre os processos de web mostrado no desempenho Explore: indica o número atual de processos da web e o número máximo alcançado desde o início do servidor web.
Valores: todo valor entre 10 y 32 000. O valor por defeito é 100.
Web max sessions71Alcance: servidor web local**
** Descrição: permite limitar o número de sessões simultâneas. Quando é alcançado o número definido, a seção mais antiga é fechada (e se chama ao Método de banco de dados On Web Legacy Close Session se o servidor web necessita criar uma nova.
Valores possíveis: Intero longo.O número de sessões simultâneas não pode superar o número total de processos web (opção Web max concurrent processes, 100 por defeito)
Valores por defeito: 100 (passe 0 para restabelecer o valor por defeito)
Web maximum requests size27Alcance: 4D local, 4D Server
Descrição: tamanho máximo (em bytes) das petições HTTP de entrada (POST) que o servidor web está autorizado a tratar. Por padrão, o valor predeterminado é 2 000 000, ou seja, um pouco menos de 2 MB. O valor máximo (2 147 483 648) significa na prática que nenhum limite é estabelecido.
Esta configuração evita la saturação do servidor web, causadas por petições de entrada muito grandes. Quando uma petição chega ao limite, o servidor web de 4D rechaça.
Valores possíveis: 500 000 a 2 147 483 647.
Web port ID15Alcance: 4D em modo local e 4D Server.
Descrição: estabelece ou obtém o número da porta TCP utilizado pelo servidor web 4D com 4D em modo local e 4D Server. Por padrão, o valor é 80. O número de porta TCP se define na página "Web/Configuração" da caixa de diálogo Propriedades da base. Pode utilizar uma das constantes do tema Números de porta TCP para o parâmetro valor. Este seletor é útil no marco de servidores web 4D que se compilam e fundem utilizando 4D de escritório (sem acesso ao ambiente Desenho).
Valores possíveis: para obter mais informação sobre o número de porta TCP, consulte a seção Web Server Settings.
Valor por padrão: 80
Web scalable session90Alcance: servidor Web local
Descripción: ativa ou desativa o modo de gestão de sessões escalável (descrito na página Sessões de usuário em developer.4d.com)
Valores possíveis: 1 (modo de ativação) ou 0 (modo de desativação). Se modificar o valor, o servidor web deve ser reiniciado para que leve em consideração a mudança. Quando se habilitar este modo, as opções a seguir são ignoradas: Web inactive process timeout, Web max concurrent processes, Web session cookie name e Web inactive session timeout.
Web session cookie domain81Alcance: Servidor web local
Descrição: define ou obtém o valor do campo "domínio" da cookie de sessão. Este seletor (assim como o seletor 82) é útil para controlar o alcance das cookies de sessão: se configura, por exemplo, o valor "/*.4d.fr" para este seletor, o cliente só enviará uma cookie quando a petição se dirige ao domínio ".4d.fr", que exclui os servidores que alojam os dados estáticos externos.
Valores possíveis: Texto
Web session cookie name73Alcance: servidor web local
Descrição: permite definir o nome da cookie utilizada para armazenar o ID da sessão.
Valores: Texto
Valores por defeito: "4DSID" (passe uma cadeia vazia para restabelecer o valor por defeito)
Web session cookie path82Alcance: Servidor web local
Descrição: define ou obtém o valor do campo "path" da cookie de sessão. Este seletor (assim como o seletor 81) é útil para controlar o alcance das cookies de sessão: se configura, por exemplo, o valor"/4DACTION" para este seletor, o cliente deverá enviar só uma cookie para petições dinâmicas que comecem com 4DACTION, e não para as imagens, páginas estáticas, etc.
Valores possíveis: Texto
Web session enable IP address validation83Alcance: servidorWeb Local
Descrição: Ativa ou desativa a validação dos endereços IP para as cookies de sessão. Por razões de segurança, por padrão, o servidor web de 4D verifica o endereço IP de cada solicitação que contém uma cookie de sessão e a rejeita se este endereço não coincide com o endereço IP utilizado para criar a cookie. Em algumas aplicações específicas, é possível que deseje desativar esta validação e aceitar as cookies de sessão, inclusive quando seus endereços IP não coincidam. Por exemplo, quando os dispositivos móveis mudam entre redes WiFi e 3G/4G, seu endereço IP muda. Neste caso, deve passar 0 nesta opção para permitir que os clientes podam seguir utilizando seus sessões web inclusive quando as endereços IP mudem. Tenha em conta que esta configuração reduz o nível de segurança da aplicação.
Quando se modifica, esta configuração é efetiva imediatamente (não é necessário reiniciar o servidor HTTP).
Valores possíveis: 0 (desativado) ou 1 (ativado)
Valor por padrão: 1 (os endereços IP são verificados)

Quando usar o seletor web debug log, pode receber uma das constantes abaixo no parâmetro valor:

ConstanteTipoValorComentário
wdl disable web logInteiro longo0O arquivo de histórico de petições HTTP Web está desativado
wdl enable with all body partsInteiro longo7O arquivo de histórico de petições Web está ativado com o corpo da resposta e a resposta
wdl enable with request bodyInteiro longo5O arquivo de histórico de petições Web está ativado apenas com o corpo da resposta
wdl enable with response bodyInteiro longo3O arquivo de histórico de petições HTTP Web está ativado com o corpo da resposta unicamente
wdl enable without bodyInteiro longo1O arquivo de histórico de petições Web está desativado sem o corpo (o tamanho do corpo é entregue neste caso)

Ver também

WEB SET OPTION

Propriedades

Número do comando1209
Thread-seguro