WEB SET OPTION

4D v16.3

WEB SET OPTION


WEB SET OPTION ( seletor ; valor )

Parâmetro	Tipo	Descrição
seletor	Inteiro longo	Código da opção a modificar
valor	Inteiro longo, Texto	Valor da opção

Descrição

O comando WEB SET OPTION modifica o valor atual das diferentes opções de funcionamento do servidor web de 4D.

No parâmetro seletor, passe uma das constantes do tema Web Server e passe em valor o novo valor da opção: :

Constante	Tipo	Valor	Comentário
Web character set	Inteiro longo	17	Alcance: 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-1256 Modo 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 listen	Inteiro longo	23	Escopo: 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 debug log	Inteiro longo	84	Alcance: 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 Apêndice E: 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 HTTP compression level	Inteiro longo	50	Alcance: 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 threshold	Inteiro longo	51	Alcance: 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 TRACE	Inteiro longo	85	Escopo: 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 port ID	Inteiro longo	39	Alcance: 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 timeout	Inteiro longo	78	Alcance: 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 On Web Close Process database method 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 timeout	Inteiro longo	72	Alcance: 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 listen	Inteiro longo	16	Escopo: 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 keep session	Inteiro longo	70	Alcance: servidor web local Descrição: permite ativar ou desativar o modo de gestão das sessões (descrito na seção Web Sessions Management). 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 recording	Inteiro longo	29	Alcance: 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 processes	Inteiro longo	18	Alcance: 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 sessions	Inteiro longo	71	Alcance: 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 On Web Close Process database method 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 size	Inteiro longo	27	Alcance: 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 defeito, 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 648.
Web port ID	Inteiro longo	15	Alcance: 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 session cookie domain	Inteiro longo	81	Alcance: 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 name	Inteiro longo	73	Alcance: 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 path	Inteiro longo	82	Alcance: 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 validation	Inteiro longo	83	Alcance: servidor Web 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 Web debug log selector, pode pasasr uma das constantes abaixo no parâmetro valor:

Constante	Tipo	Valor	Comentário
wdl disable	Inteiro longo	0	O arquivo de histórico de petições HTTP Web está desativado
wdl enable with all body parts	Inteiro longo	7	O arquivo de histórico de petições Web está ativado com o corpo da resposta e a resposta
wdl enable with request body	Inteiro longo	5	O arquivo de histórico de petições Web está ativado apenas com o corpo da resposta
wdl enable with response body	Inteiro longo	3	O arquivo de histórico de petições HTTP Web está ativado com o corpo da resposta unicamente
wdl enable without body	Inteiro longo	1	O arquivo de histórico de petições Web está desativado sem o corpo (o tamanho do corpo é entregue neste caso)

Exemplo

A ativação do arquivo de histórico de depuração das petições HTTP sem as partes body:

WEB SET OPTION(Web debug log;wdl enable without body)

Uma entrada registrada se vê dessa maneira:

# REQUEST
# SocketID: 1592
# PeerIP: 127.0.0.1
# PeerPort: 54912
# TimeStamp: 39089388
#ConnectionID: 9808E3B4B06E4EB5A60E9A3FC69116BD
#SequenceNumber:5
GET /4DWEBTEST HTTP/1.1
Accept: text/html,(...)
Accept-Encoding: gzip, deflate
Connection: keep-alive
Host: 127.0.0.1
User-Agent: 4D_HTTP_Client/0.0.0.0

# RESPONSE
# SocketID: 1592
# PeerIP: 127.0.0.1
# PeerPort: 54912
# TimeStamp: 39089389 (tempo transcorrido: 1 minuto)
 #ConnectionID: 9808E3B4B06E4EB5A60E9A3FC69116BD
#SequenceNumber:6
HTTP/1.1 200 OK
Accept-Ranges: bytes
Connection: keep-alive
Content-Encoding: gzip
Content-Length: 3555
Content-Type: text/plain; charset=UTF-8
Date: Thu, 20 Apr 2017 10:51:29 GMT
Expires: Thu, 20 Apr 2017 10:51:29 GMT
Server: 4D/16.0.1

[Body Size: 3555]

Ver também

WEB GET OPTION
WEB GET SESSION EXPIRATION