4D v16.3

WEB SET OPTION

Página Inicial

 
4D v16.3
WEB SET OPTION

WEB SET OPTION 


 

WEB SET OPTION ( seletor ; valor ) 
Parâmetro Tipo   Descrição
seletor  Inteiro longo in Código da opção a modificar
valor  Inteiro longo, Texto in Valor da opçã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:

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

 
PROPRIEDADES 

Produto: 4D
Tema: Web Server
Número 1210

This command can be run in preemptive processes

 
HISTÓRIA 

Criado por: 4D v13
Modificado: 4D v13.2
Modificado: 4D v14 R3
Modificado: 4D v15
Modificado: 4D v15 R2

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16.3)

Inherited from : WEB SET OPTION ( 4D v16)