From: Rich Bowen Date: Wed, 20 May 2026 00:08:16 +0000 (+0000) Subject: rebuild recent doc changes X-Git-Tag: 2.4.68-rc1-candidate~109 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d9fb4b8d254719fc6f964704481026c137a5b8c7;p=thirdparty%2Fapache%2Fhttpd.git rebuild recent doc changes git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1934417 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/bind.html.pt-br.utf8 b/docs/manual/bind.html.pt-br.utf8 new file mode 100644 index 0000000000..5a6a61ecce --- /dev/null +++ b/docs/manual/bind.html.pt-br.utf8 @@ -0,0 +1,254 @@ + + + + + + +Vinculando a Endereços e Portas - Servidor HTTP Apache Versão 2.4 + + + + + + + +
<-
+
+Apache > Servidor HTTP > Documentação > Versão 2.4

Vinculando a Endereços e Portas

+ +
+

Línguas Disponíveis:  de  | + en  | + fr  | + ja  | + ko  | + pt-br  | + tr 

+
+ +

Configurando o Servidor HTTP Apache para escutar em endereços e portas específicas.

+
+ +
top
+
+

Visão Geral

+ + + + + +

Quando o httpd inicia, ele se vincula a algumas portas e endereços na + máquina local e aguarda por requisições entrantes. Por padrão, + ele monitora todos os endereços na máquina. No entanto, pode ser necessário + monitoramento em portas específicas ou somente em + endereços selecionados, ou uma combinação dos dois. Isto é muitas vezes combinado com + o recurso de Host Virtual, que determina como o + httpd responde a endereços, nomes de hosts e portas + diferentes.

+ +

A diretiva Listen + informa ao servidor que ele deve aceitar + requisições entrantes apenas na(s) porta(s) especificada(s) ou + em combinações de endereço e porta. Se apenas um número de porta for + especificado na diretiva Listen, + o servidor monitora a porta informada em todas as interfaces. + Se um endereço IP é informado junto com uma porta, o servidor irá monitorar + na porta e na interface especificadas. Múltiplas diretivas Listen podem ser usadas para + especificar vários endereços e portas para monitoramento. O + servidor responderá a requisições de quaisquer dos endereços e + portas listados.

+ +

Por exemplo, para que o servidor aceite conexões tanto na + porta 80 quanto na 8000, em todas as interfaces, use:

+ +
Listen 80
+Listen 8000
+
+ +

Para que o servidor aceite conexões na porta 80 para uma interface + e na porta 8000 para outra, use:

+ +
Listen 192.0.2.1:80
+Listen 192.0.2.5:8000
+
+ +

Endereços IPv6 precisam ser envolvidos por colchetes, como no + exemplo a seguir:

+ +
Listen [2001:db8::a00:20ff:fea7:ccea]:80
+
+ +

A sobreposição de diretivas Listen resultará em um + erro fatal que irá impedir o servidor de iniciar.

+ +

+ (48)Address already in use: make_sock: could not bind to address [::]:80 +

+ +

Consulte esta discussão + na wiki para mais dicas de soluções de problemas.

+ +
+ +
top
+
+

Alterando a configuração de Listen no reinício

+ + +

Quando o httpd é reiniciado, uma consideração especial precisa ser feita para + alterações a diretivas Listen. Durante um reinício, o httpd mantém as portas + vinculadas (como na configuração original) para evitar a geração de erros + "Connection refused" (conexão recusada) para quaisquer novas tentativas de conexão + ao servidor. Se as alterações são feitas no conjunto de diretivas Listen + que conflitam com a configuração antiga, a configuração irá falhar + e o servidor irá terminar.

+ +

Por exemplo, alterando da configuração:

+ +
Listen 127.0.0.1:80
+
+ +

para a configuração a seguir pode falhar, porque a vinculação da porta 80 para + todos os endereços conflita com a vinculação da porta 80 somente para + 127.0.0.1.

+ +
Listen 80
+
+ +

Para que tal configuração tenha efeito, é necessário + parar e depois iniciar o servidor.

+ +
top
+
+

Considerações Especiais sobre IPv6

+ + +

Um número crescente de plataformas implementa IPv6 e o + APR suporta IPv6 na maioria delas, + permitindo que o httpd aloque soquetes IPv6 e manipule requisições enviadas + através de IPv6.

+ +

Um fator complicador para administradores de httpd é definir se + um soquete IPv6 pode lidar tanto com conexões IPv4 quanto com + IPv6. Lidar com conexões IPv4 com soquete IPv6 usa + endereços IPv6 mapeados para IPv4, o que é permitido por padrão na maioria + das plataformas mas é proibido por padrão no FreeBSD, NetBSD e + OpenBSD, para alinhamento com a política de sistema dessas + plataformas. Em sistemas onde isso é proibido por padrão, um + parâmetro especial do programa configure pode alterar este + comportamento para o httpd.

+ +

Por outro lado, em algumas plataformas como Linux e Tru64, a + única forma de lidar tanto com IPv6 quanto com IPv4 é usar + endereços mapeados. Se o httpd tiver que lidar com conexões IPv4 e IPv6 + com um mínimo de soquetes, que requerem o uso de endereços IPv6 mapeados + para IPv4, especifique a opção --enable-v4-mapped do programa configure.

+ +

--enable-v4-mapped é o padrão para todas as plataformas exceto + para FreeBSD, NetBSD e OpenBSD, portanto esta é provavelmente a forma como o seu httpd foi + compilado.

+ +

Se o httpd tiver que lidar somente com conexões IPv4, independente do que + a sua plataforma e APR irão suportar, especifique um endereço IPv4 em todas as + diretivas Listen, como nos + exemplos a seguir:

+ +
Listen 0.0.0.0:80
+Listen 192.0.2.1:80
+
+ +

Se a sua plataforma suporta e a intenção for lidar com conexões IPv4 e + IPv6 em soquetes separados (ou seja, desabilitar endereços mapeados + para IPv4), especifique a opção --disable-v4-mapped do programa configure. --disable-v4-mapped é o padrão + no FreeBSD, NetBSD, e OpenBSD.

+
top
+
+

Especificando o protocolo com Listen

+ +

O segundo argumento opcional protocol de + Listen + não é requerido para a maioria das + configurações. Se não especificado, https é o padrão para + a porta 443 e http é o padrão para todas as outras portas. O + protocolo é usado para determinar que módulo deve lidar com uma requisição e + para aplicar otimizações de protocolo específicas com a diretiva + AcceptFilter.

+ +

Somente é necessário definir o protocolo se o servidor estiver monitorando + portas não padrão. Por exemplo, para servir um site https na porta 8443:

+ +
Listen 192.170.2.1:8443 https
+
+
top
+
+

Como Isto Funciona com Hosts Virtuais

+ + +

A diretiva Listen não implementa + Hosts Virtuais - ela apenas informa ao + servidor principal quais endereços e portas devem ser monitorados. Se nenhuma + diretiva <VirtualHost> + for usada, o servidor se comportará + da mesma forma para todas as requisições aceitas. Entretanto, + <VirtualHost> + pode ser usada para especificar um comportamento diferente + para um ou mais dos enredeços e portas. Para implementar um + Host Virtual, o servidor primeiro precisa ser informado para monitorar o + endereço e a porta que serão usados. Depois, uma + seção <VirtualHost> + deve ser criada para o endereço e a porta especificados para definir o + comportamento desse host virtual. Observe que se a seção + <VirtualHost> + estiver definida para um endereço e uma porta que o + servidor não estiver monitorando, o host virutal não poderá ser acessado.

+
+
+

Línguas Disponíveis:  de  | + en  | + fr  | + ja  | + ko  | + pt-br  | + tr 

+
+ \ No newline at end of file diff --git a/docs/manual/filter.html.pt-br.utf8 b/docs/manual/filter.html.pt-br.utf8 new file mode 100644 index 0000000000..38bfeb6fc6 --- /dev/null +++ b/docs/manual/filter.html.pt-br.utf8 @@ -0,0 +1,191 @@ + + + + + + +Filtros - Servidor HTTP Apache Versão 2.4 + + + + + + + +
<-
+
+Apache > Servidor HTTP > Documentação > Versão 2.4

Filtros

+ +
+

Línguas Disponíveis:  en  | + es  | + fr  | + ja  | + ko  | + pt-br  | + tr 

+
+ +

Este documento descreve o uso de filtros no Apache.

+
+ +
top
+
+

Filtrando no Apache 2

+ + + +

A Cadeia de Filtros está disponível no Apache 2.0 e versões posteriores, +e permite que as aplicações processem dados de entrada e saída +de maneira altamente flexível e configurável, independentemente +de onde os dados vêm. Podemos pré-processar dados de entrada +e pós-processar dados de saída, conforme necessário. Isso é basicamente +independente das fases tradicionais de processamento de requisições.

+

+Filtros podem ser encadeados, em um Eixo de Dados ortogonal ao Processamento de Requisição +

+

Alguns exemplos de filtragem na distribuição padrão do Apache são:

+
    +
  • mod_include, implementa inclusões do lado do servidor.
  • +
  • mod_ssl, implementa criptografia SSL (https).
  • +
  • mod_deflate, implementa compressão/descompressão em tempo real.
  • +
  • mod_charset_lite, transcodifica entre diferentes conjuntos de caracteres.
  • +
  • mod_ext_filter, executa um programa externo como filtro.
  • +
+

O Apache também usa vários filtros internamente para executar +funções como fragmentação e manipulação de intervalos de bytes.

+ +

Uma gama mais ampla de aplicações é implementada por módulos de +filtro de terceiros. Alguns exemplos são:

+ +
    +
  • Processamento e reescrita de HTML e XML
  • +
  • Transformações XSLT e XIncludes
  • +
  • Suporte para namespace XML
  • +
  • Processamento de envio de arquivos e decodificação de formulários HTML
  • +
  • Processamento de imagem
  • +
  • Proteção de aplicações vulneráveis, como scripts PHP
  • +
  • Edição de busca e substituição de texto
  • +
+
top
+
+

Filtragem Inteligente

+ +

+A filtragem inteligente aplica diferentes fornecedores de filtros de acordo com o estado do processamento da solicitação +

+

O módulo mod_filter, incluído no Apache 2.1 e versões posteriores, +permite que a cadeia de filtros seja configurada dinamicamente no momento da execução. +Assim, por exemplo, você pode configurar um proxy para reescrever +HTML com um filtro HTML e imagens JPEG com um filtro completamente +separado, mesmo que o proxy não tenha nenhuma informação prévia +sobre o que o servidor de origem enviará. Isso funciona usando um +envoltório de filtros que direciona a requisição para diferentes provedores de acordo com +o conteúdo real no momento da execução. Qualquer filtro pode ser +inserido diretamente na cadeia e executado incondicionalmente ou +usado como um provedor e inserido dinamicamente. Por exemplo,

+
    +
  • um filtro de processamento HTML só será executado se o conteúdo for +text/html ou application/xhtml+xml
  • +
  • um filtro de compressão só será executado se a entrada for de um tipo +compressível e não estiver já comprimida.
  • +
  • um filtro de conversão de conjunto de caracteres será inserido se um documento +de texto ainda não estiver no conjunto de caracteres desejado.
  • +
+
top
+
+

Expondo Filtros como um Serviço HTTP

+ + +

Os filtros podem ser usados ​​para processar conteúdo originado do cliente, além +de processar conteúdo originado no servidor usando o módulo +mod_reflector.

+ +

O módulo mod_reflector aceita requisições POST de clientes e reflete +o conteúdo do corpo da requisição POST recebido de volta na resposta, +passando pela pilha de filtros de saída no caminho de volta para o cliente.

+ +

Essa técnica pode ser usada como uma alternativa a um serviço web executado dentro +de uma pilha de servidor de aplicativos, onde um filtro de saída fornece a transformação +necessária no corpo da requisição. Por exemplo, o módulo mod_deflate +pode ser usado para fornecer um serviço de compressão geral, ou um filtro de +transformação de imagem pode ser transformado em um serviço de transformação de imagem.

+ +
top
+
+

Usando Filtros

+ +

Existem dois métodos de uso de filtros: Simples e Dinâmico. +Em geral, deve ser usada apenas um ou outro; misturá-los pode +ter consequências inesperadas (embora a filtragem de entrada simples +possa ser misturada livremente com a filtragem de saída simples ou dinâmica).

+

O Método Simples é a única maneira de configurar filtros de entrada e é +suficiente para filtros de saída onde é necessária uma cadeia de filtros estática. +As diretivas relevantes são + SetInputFilter, + SetOutputFilter, + AddInputFilter, + AddOutputFilter, + RemoveInputFilter e + RemoveOutputFilter.

+ +

O Método Dinâmico permite a configuração estática e flexível/dinâmica +dos filtros de saída, conforme discutido na página mod_filter. +As diretivas relevantes são + FilterChain, + FilterDeclare e + FilterProvider.

+ +

Uma diretiva adicional, AddOutputFilterByType também é suportada, +porem obsoleta. Um a configuração dinâmica em seu lugar.

+ +
+
+

Línguas Disponíveis:  en  | + es  | + fr  | + ja  | + ko  | + pt-br  | + tr 

+
+ \ No newline at end of file diff --git a/docs/manual/howto/htaccess.html.pt-br.utf8 b/docs/manual/howto/htaccess.html.pt-br.utf8 new file mode 100644 index 0000000000..ef58788b46 --- /dev/null +++ b/docs/manual/howto/htaccess.html.pt-br.utf8 @@ -0,0 +1,457 @@ + + + + + + +Tutorial do Servidor HTTP Apache: arquivos .htaccess - Servidor HTTP Apache Versão 2.4 + + + + + + + +
<-
+
+Apache > Servidor HTTP > Documentação > Versão 2.4 > Como Fazer / Tutoriais

Tutorial do Servidor HTTP Apache: arquivos .htaccess

+ +
+

Línguas Disponíveis:  en  | + es  | + fr  | + ja  | + ko  | + pt-br 

+
+
Esta tradução pode estar desatualizada. + Confira a versão em inglês para mudanças recentes.
+ +

Arquivos .htaccess oferecem um meio de fazer alterações +nas configurações por diretório, sem modificar diretamente os arquivos +de configuração principais do servidor.

+
+ +
top
+
top
+
+

O que eles são / Como usá-los

+ + +

Os arquivos .htaccess (ou "arquivos de configuração distribuídos") + oferecem um meio de fazer alterações nas configurações por diretório. Um + arquivo, contendo uma ou mais diretivas de configurações, é colocado em um + diretório em particular e as diretivas se aplicam a este diretório e a + todos os seus subdiretórios.

+ +

Observação:

+

Se o nome do arquivo precisar ser diferente de .htaccess, + ele pode ser alterado através da diretiva AccessFileName. Por exemplo, + se a preferência for chamar o arquivo de .config, pode + ser adicionada a seguinte linha ao arquivo de configuração do servidor:

+ +
AccessFileName ".config"
+ +
+ +

Diretivas nos arquivos .htaccess usam a mesma sintaxe + que os arquivos principais + de configuração. O que pode ser colocado nesses arquivos é determinado pelas + diretivas AllowOverride E + AllowOverrideList. + AllowOverride especifica, em + categorias, quais diretivas serão honradas caso sejam encontradas em um + arquivo .htaccess, enquanto que AllowOverrideList nomeia diretivas + individuais a serem permitidas (consulte abaixo). Se uma diretiva + for permitida, a documentação para essa diretiva conterá uma seção Override, + especificando que valor precisa estar em AllowOverride para que essa diretiva + seja permitida.

+ +

Por exemplo, ao procurar na documentação pela diretiva AddDefaultCharset, + pode-se notar que ela é permitida nos arquivos .htaccess. + (Veja a linha Contexto no sumário das diretivas.) A + linha Override apresenta + FileInfo. Assim, deve-se ter pelo menos + AllowOverride FileInfo para que essa diretiva seja + honrada nos arquivos .htaccess.

+
top
+
+

Quando (não) usar arquivos .htaccess

+ +

Se for possível o acesso ao arquivo de principal de configuração do servidor, todas + as configurações devem ser colocadas lá em vez de inseri-las em arquivos + .htaccess. Isto inclui autenticação de usuários, + regras do mod_rewrite e qualquer outra coisa que você tenha + tentação de colocar no .htaccess. Diretivas na configuração + principal são carregadas assim que o servidor inicia, e não a cada + requisição, e o mod_rewrite em particular funciona melhor + no contexto de configuração do servidor.

+ +

Os arquivos .htaccess devem ser usados ​​nos casos em que os + provedores de conteúdo precisam fazer alterações de configuração no servidor + por diretório, mas não têm acesso "root" ao sistema do servidor. + Isto é comum com ambientes de hospedagem gerenciados, hospedagem baseada + em painel de controle (como cPanel ou Plesk), e sistemas de gerenciamento de conteúdo onde + a aplicação envia um arquivo .htaccess como parte de sua + distribuição. Caso o administrador do servidor não esteja disposto a fazer + alterações de configuração frequentes, pode ser desejável permitir que + usuários individuais façam essas alterações em arquivos .htaccess + por conta própria.

+ +

Existem dois motivos principais para preferir o arquivo principal de configuração + no lugar do .htaccess: desempenho e segurança.

+ +

Desempenho: Quando a diretiva AllowOverride + está configurada para permitir o uso de arquivos .htaccess, o httpd + procurará em todos os diretórios por arquivos .htaccess. Portanto, + permitir arquivos .htaccess causa uma queda de desempenho, + independentemente de serem realmente usados ou não! Além disso, o + arquivo .htaccess é carregado sempre que um documento é + solicitado.

+ +

Observe ainda que o httpd precisa procurar arquivos .htaccess + em todos os diretórios de nível superior, a fim de ter um conjunto completo de + diretivas que ele deve aplicar. (Consulte a seção sobre como + as diretivas são aplicadas.) Assim, se um arquivo for solicitado de um + diretório /www/htdocs/example, o httpd precisa procurar os + seguintes arquivos:

+ +
/.htaccess
+/www/.htaccess
+/www/htdocs/.htaccess
+/www/htdocs/example/.htaccess
+ + +

Assim, para cada acesso a um arquivo fora desse diretório, há 4 + acessos adicionais ao sistema de arquivos, mesmo que nenhum desses arquivos esteja + presente. (Observe que isso só ocorreria se + os arquivos .htaccess estivessem habilitados para o diretório /, o que + normalmente não acontece.)

+ +

Segurança: Você está permitindo + que usuários modifiquem a configuração do servidor, o que pode resultar em alterações sobre + as quais você não tem controle.Considere cuidadosamente se deseja conceder + esse privilégio aos usuários. Observe também que conceder aos usuários menos + privilégios do que o necessário levará a solicitações adicionais de suporte + técnico. Certifique-se de informar claramente aos usuários qual o nível de + privilégios que foi condedido a eles. Especificar exatamente o valor definido para + AllowOverride e direcioná-los + para a documentação relevante evitará muita confusão + posteriormente.

+ +

Se for necessário conceder acesso ao .htaccess porém limitando + a um conjunto específico de diretivas em vez de categorias inteiras, use a + diretiva AllowOverrideList. Isso + permite nomear diretivas individuais que são permitidas, fornecendo + um controle mais fino que a AllowOverride sozinha:

+ +
# Permite somente diretivas específicas, e não categorias inteiras
+AllowOverride None
+AllowOverrideList Redirect RedirectMatch RewriteEngine RewriteRule RewriteCond
+ + +

Com esta configuração, qualquer diretiva que não esteja explicitamente listada + causará um erro de servidor se encontrada em um arquivo .htaccess. + Isto é um meio termo útil entre o acesso total e nenhum + acesso.

+ +

Observe que é completamente equivalente colocar um arquivo .htaccess + em um diretório /www/htdocs/example contendo uma + diretiva, e colocar essa mesma diretiva em uma seção Directory + <Directory "/www/htdocs/example"> na configuração principal do + servidor:

+ +

Arquivo .htaccess em /www/htdocs/example:

+ +

Conteúdo do arquivo .htaccess em + /www/htdocs/example

AddType text/example ".exm"
+
+ +

Seção do arquivo httpd.conf +

<Directory "/www/htdocs/example">
+    AddType text/example ".exm"
+</Directory>
+
+ +

O uso de arquivos .htaccess pode ser completamente desativado + definindo a diretiva AllowOverride + como none:

+ +
AllowOverride None
+ +
top
+
+

Como as diretivas são aplicadas

+ +

As diretivas de configuração encontradas em um arquivo .htaccess + são aplicadas ao diretório em que o arquivo .htaccess + está localizado e a todos os seus subdiretórios. No entanto, é importante + lembrar também que pode haver arquivos .htaccess + em diretórios acima na árvore. As diretivas são aplicadas na ordem em que + são encontradas. Portanto, um arquivo .htaccess em um determinado + diretório pode sobrescrever diretivas encontradas em arquivos .htaccess + localizados acima na árvore de diretórios. E estes, por sua vez, podem ter + sobrescrito diretivas encontradas ainda acima na árvore, ou no próprio arquivo de + configuração principal do servidor.

+ +

Exemplo:

+ +

No diretório /www/htdocs/example1, considere + um arquivo .htaccess contendo o seguinte:

+ +
Options +ExecCGI
+ + +

(Observação: "AllowOverride Options" precisa estar em vigor + para permitir o uso da diretiva "Options" em + arquivos .htaccess.)

+ +

No diretório /www/htdocs/example1/example2, considere + um arquivo .htaccess contendo:

+ +
Options Includes
+ + +

Devido a este segundo arquivo .htaccess, no diretório + /www/htdocs/example1/example2, a execução de CGI não é + permitida, pois apenas Options Includes está em vigor, o que + sobrescreve completamente qualquer configuração anterior que possa ter estado + em vigor.

+ +

Mesclagem do .htaccess com os arquivos principais + de configuração

+ +

Conforme discutido na documentação sobre Seções de Configuração, + os arquivos .htaccess podem sobrescrever as seções <Directory> para + o diretório correspondente, mas serão sobrescritos por outros tipos + de seções de configuração dos arquivos de configuração principais. + Esse fato pode ser usado para impor certas configurações, mesmo na + presença de uma configuração AllowOverride permissiva. Por exemplo, para + impedir a execução de scripts, permitindo que qualquer outra configuração seja feita em + .htaccess, pode ser usado:

+ +
<Directory "/www/htdocs">
+    AllowOverride All
+</Directory>
+
+<Location "/">
+    Options +IncludesNoExec -ExecCGI
+</Location>
+ + +
Este exemplo pressupõe que DocumentRoot seja /www/htdocs.
+ + +
top
+
+

Exemplo de Autenticação

+ +

Como em qualquer caso de uso de .htaccess, inserir estas diretivas em + um bloco <Directory> é + preferido quando se tem acesso à configuração principal (consulte + above). O exemplo s seguir mostra o método + .htaccess:

+ +

Conteúdo de .htaccess:

+ +
AuthType Basic
+AuthName "Senha Requerida"
+AuthUserFile "/www/senhas/arquivo.senhas"
+AuthGroupFile "/www/senhas/arquivo.grupos"
+Require group admins
+ + +

Observe que AllowOverride AuthConfig deve estar em vigor + para que essas diretivas tenham algum efeito.

+ +

Consulte o tutorial de autenticação para uma + discussão mais completa sobre autenticação e autorização.

+
top
+
+

Exemplo de Server Side Includes

+ +

Outro uso comum de arquivos .htaccess é habilitar + inclusões do lado do servidor para um diretório específico. Isso pode ser feito com + as seguintes diretivas de configuração, colocadas em um + arquivo .htaccess no diretório desejado:

+ +
Options +Includes
+AddType text/html shtml
+AddHandler server-parsed shtml
+ + +

Observe que AllowOverride Options e AllowOverride + FileInfo devem estar ambos em vigor para que essas diretivas tenham algum + efeito.

+ +

Consulte o tutorial SSI para uma discussão mais + completa sobre includes do lado do servidor.

+
top
+
+

Regras de reescrita em arquivos .htaccess

+

Ao usar RewriteRule em + arquivos .htaccess, esteja ciente de que o contexto por diretório + muda um pouco as coisas. Em particular, as regras são consideradas relativas + ao diretório atual, em vez de serem o URI solicitado original. + Considere os seguintes exemplos:

+ +
# No arquivo httpd.conf
+RewriteRule "^/imagens/(.+)\.jpg" "/imagens/$1.png"
+
+# No arquivo .htaccess do diretório raiz
+RewriteRule "^imagens/(.+)\.jpg" "imagens/$1.png"
+
+# No arquivo .htaccess do diretório imagens/
+RewriteRule "^(.+)\.jpg" "$1.png"
+ + +

Em um arquivo .htaccess no diretório de documentos, a barra inicial + é removida do valor fornecido para RewriteRule, e no subdiretório + imagens, /imagens/ é removido + dele. Portanto, a expressão regular precisa omitir essa parte + também.

+ +

Observe também que no contexto do .htaccess, expressões regulares são + recompiladas a cada requisição, enquanto que na configuração principal do servidor elas + são compiladas apenas uma vez e armazenadas em cache.

+ +

Consulte a documentação do mod_rewrite para + obter mais detalhes sobre como usar o mod_rewrite.

+ +
top
+
+

Exemplo de CGI

+ +
Scripts CGI são um mecanismo legado para conteúdo dinâmico. Para novos + desenvolvimentos, considere o uso de mod_proxy_fcgi com um + servidor de aplicação FastCGI ou um manipulador específico para algum framework. A + informação abaixo permanece útil para ambientes que ainda dependem de + CGI tradicional.
+ +

Pode ser necessário usar um arquivo .htaccess para permitir + a execução de programas CGI em um diretório específico. Isso pode ser + implementado com a seguinte configuração:

+ +
Options +ExecCGI
+AddHandler cgi-script cgi pl
+ + +

Alternativamente, se for necessário que todos os arquivos no diretório especificado sejam + considerados programas CGI, isso pode ser feito com a seguinte + configuração:

+ +
Options +ExecCGI
+SetHandler cgi-script
+ + +

Observe que AllowOverride Options e AllowOverride + FileInfo devem estar ambos em vigor para que essas diretivas tenham algum + efeito.

+ +

Consulte o tutorial CGI para uma discussão mais + completa sobre programação e configuração CGI.

+ +
top
+
+

Resolvendo Problemas

+ +

Quando são colocadas diretivas de configuração em um arquivo .htaccess + e não é obtido o efeito desejado, há uma série de + coisas que podem estar dando errado.

+ +

O problema mais comum é que a diretiva AllowOverride não está + configurada de forma que suas diretivas de configuração sejam respeitadas. + Certifique-se de que não exista um AllowOverride None em vigor + para o escopo do arquivo em questão. Um bom teste para isso é colocar uma + palavra sem sentido no seu arquivo .htaccess e recarregar a + página:

+ +
TestMe
+ + +

Se um erro do servidor (HTTP 500) não + for gerado, é quase certeza que AllowOverride + None esteja em vigor.

+ +

Se, por outro lado, erros do servidor estiverem sendo gerados ao tentar + acessar documentos, verifique o registro de erros do httpd. Ele provavelmente informará + que a diretiva usada no arquivo .htaccess não é + permitida.

+ +
[Tue May 06 09:12:31.528374 2025] [core:alert] [pid 12345] [client 192.168.1.50:54321] /var/www/html/.htaccess: DirectoryIndex not allowed here
+ + +

Isso indicará que foi usada uma diretiva que + nunca é permitida em arquivos .htaccess, ou que simplesmente + não existe um AllowOverride definido para + um nível suficiente para a diretiva usada. Consulte a + documentação dessa diretiva específica para determinar qual + é o caso.

+ +

Alternativamente, pode aparecer um erro de sintaxe no + uso da própria diretiva.

+ +
[Tue May 06 09:14:02.946218 2025] [core:alert] [pid 12345] [client 192.168.1.50:54321] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
+ + +

Neste caso, a mensagem de erro deve ser específica para o + erro de sintaxe cometido.

+ +
+
+

Línguas Disponíveis:  en  | + es  | + fr  | + ja  | + ko  | + pt-br 

+
+ \ No newline at end of file diff --git a/docs/manual/index.html.pt-br.utf8 b/docs/manual/index.html.pt-br.utf8 new file mode 100644 index 0000000000..5080ad71a2 --- /dev/null +++ b/docs/manual/index.html.pt-br.utf8 @@ -0,0 +1,150 @@ + + + + + + +Documentação do Servidor HTTP Apache Versão +2.4 - Servidor HTTP Apache Versão 2.4 + + + + + + + + +
<-
+
+Apache > Servidor HTTP > Documentação
+

Documentação do Servidor HTTP Apache Versão +2.4

+ +
+

Línguas Disponíveis:  da  | + de  | + en  | + es  | + fr  | + ja  | + ko  | + pt-br  | + ru  | + tr  | + zh-cn 

+
+

+
+
+

Línguas Disponíveis:  da  | + de  | + en  | + es  | + fr  | + ja  | + ko  | + pt-br  | + ru  | + tr  | + zh-cn 

+
+ \ No newline at end of file diff --git a/docs/manual/mod/mod_actions.html.en b/docs/manual/mod/mod_actions.html.en index 4a1898b8f8..33e610e48f 100644 --- a/docs/manual/mod/mod_actions.html.en +++ b/docs/manual/mod/mod_actions.html.en @@ -69,15 +69,15 @@ content-type Status:Base Module:mod_actions Compatibility:The virtual modifier and handler passing were -introduced in Apache 2.1 +introduced in Apache httpd 2.1

This directive adds an action, which will activate cgi-script when action-type is triggered by - the request. The cgi-script is the URL-path to a + the request. The cgi-script is the URL-path to a resource that has been designated as a CGI script using ScriptAlias or AddHandler. The action-type can be either a handler or a MIME content type. It sends the URL and file path of the requested document using the standard CGI - PATH_INFO and PATH_TRANSLATED + PATH_INFO and PATH_TRANSLATED environment variables. The handler used for the particular request is passed using the REDIRECT_HANDLER variable.

@@ -87,14 +87,14 @@ Action image/gif /cgi-bin/images.cgi

In this example, requests for files with a MIME content type of image/gif will be handled by the - specified cgi script /cgi-bin/images.cgi.

+ specified CGI script /cgi-bin/images.cgi.

Example: File extension

# Files of a particular file extension
 AddHandler my-file-type .xyz
 Action my-file-type "/cgi-bin/program.cgi"

In this example, requests for files with a file extension of - .xyz are handled by the specified cgi script + .xyz are handled by the specified CGI script /cgi-bin/program.cgi.

The optional virtual modifier turns off the check diff --git a/docs/manual/mod/mod_actions.html.fr.utf8 b/docs/manual/mod/mod_actions.html.fr.utf8 index 143859d956..f76ecce918 100644 --- a/docs/manual/mod/mod_actions.html.fr.utf8 +++ b/docs/manual/mod/mod_actions.html.fr.utf8 @@ -34,6 +34,7 @@  ja  |  ko 

+
diff --git a/docs/manual/mod/mod_actions.xml.de b/docs/manual/mod/mod_actions.xml.de index 5fd9872132..cf22625970 100644 --- a/docs/manual/mod/mod_actions.xml.de +++ b/docs/manual/mod/mod_actions.xml.de @@ -1,7 +1,7 @@ - + + diff --git a/docs/manual/mod/mod_actions.xml.ja b/docs/manual/mod/mod_actions.xml.ja index 9199fb9678..1d6de83890 100644 --- a/docs/manual/mod/mod_actions.xml.ja +++ b/docs/manual/mod/mod_actions.xml.ja @@ -1,7 +1,7 @@ - + + + diff --git a/docs/manual/mod/mod_brotli.xml.meta b/docs/manual/mod/mod_brotli.xml.meta index 8c6376e8a0..e06ba08846 100644 --- a/docs/manual/mod/mod_brotli.xml.meta +++ b/docs/manual/mod/mod_brotli.xml.meta @@ -8,6 +8,6 @@ en - fr + fr diff --git a/docs/manual/new_features_2_0.html.pt-br.utf8 b/docs/manual/new_features_2_0.html.pt-br.utf8 new file mode 100644 index 0000000000..2d39991295 --- /dev/null +++ b/docs/manual/new_features_2_0.html.pt-br.utf8 @@ -0,0 +1,274 @@ + + + + + + +Visão Geral das novas funcionalidades do Servidor HTTP Apache 2.0 - Servidor HTTP Apache Versão 2.4 + + + + + + + +
<-
+

Visão Geral das novas funcionalidades do Servidor HTTP Apache 2.0

+ +
+

Línguas Disponíveis:  de  | + en  | + fr  | + ja  | + ko  | + pt-br  | + tr 

+
+ +

Esse documento descreve algumas das mudanças principais entre as + versões 1.3 e 2.0 do Servidor HTTP Apache.

+
+ +
top
+
+

Principais Melhorias

+ + +
+
Threads Unix
+ +
Em sistemas Unix com suporte a threads POSIX, o Apache httpd agora + pode funcionar em um modo híbrido multiprocessos e multithreads. Isto melhora + a escalabilidade para muitos mas não para todas as configurações.
+ +
Novo Sistema de Compilação
+ +
O sistema de compilação foi reescrito do zero para utilizar o + autoconf e o libtool, tornando o + sistema de configuração do Apache httpd mais similar a + de outros pacotes.
+ +
Suporte Multi-protocolo
+ +
O Servidor HTTP Apache possui agora infraestrutura para + suportar múltiplos protocolos. O módulo mod_echo é + exemplo ilustrativo de sua utilização.
+ +
Suporte aperfeiçoado para plataformas + não-Unix
+ +
O Servidor HTTP Apache 2.0 é mais rápido e mas estável em plataformas + não-Unix como BeOS, OS/2 e Windows. Com a + introdução de módulos de multi-processamento específicos por plataforma (MPMs) e o + Apache Portable Runtime (APR), essas plataformas agora estão + implementadas em suas API nativas, evitando as camadas de emulação POSIX que muitas vezes se + defeituosas e com baixo desempenho.
+ +
Nova API httpd Apache
+ +
A API para módulos mudou significativamente na versão 2.0. + Muitos dos problemas de ordenação/prioridade de módulos da versão + 1.3 foram resolvidos. A 2.0 faz muito disso automaticamente e a ordenação de módulos + agora é feita através de ganchos para permitir mais flexibilidade. Além disso, novas chamadas + foram adicionadas para fornecer capacidades adicionais de módulos + sem a necessidade de se aplicar patches ao núcleo do Servidor HTTP Apache.
+ +
Suporte IPv6
+ +
Em sistemas onde o IPv6 é suportado pela biblioteca subjacente + do Apache Portable Runtime, o httpd Apache monitora sockets + IPv6 por padrão. Adicionalmente, as diretivas Listen, NameVirtualHost e VirtualHost suportam strings de + endereço numérico IPv6 (ex.: "Listen + [2001:db8::1]:8080").
+ +
Filtros
+ +
Os módulos do Apache agora podem ser escritos como filtros que atuam + no fluxo de conteúdo à medida que este é entregue ou recebido do + do servidor. Isto permite, por exemplo, que a saída de scripts CGI seja + analisada para encontrar diretivas "Server Side Include" usando o + filtro INCLUDES de mod_include. O + módulo mod_ext_filter permite que programas externos + atuem como filtros do mesmo modo que aplicações CGI podem atuar como + manipuladores.
+ +
Respostas de Erro Multi-linguais
+ +
Mensagens de respostas de erro para o navegador agora são fornecidas em + diversas línguas, usando documentos SSI. Podem ser personalizadas + pelo administrador para atingir uma aparência consistente.
+ +
Configuração Simplificada
+ +
Muitas diretivas confusas foram simplificadas. Entre elas, + Port e BindAddress não existem + mais; apenas a diretiva Listen + é usada para vinculação de endereço IP; a diretiva ServerName especifica o + nome do servidor e o número da porta apenas para redirecionamento e reconhecimento + de hosts virtuais.
+ +
Suporte Nativo ao Unicode do Windows NT
+ +
O Apache httpd 2.0 para Windows NT agora usa UTF-8 para codificação + de todos os nomes de arquivos que são traduzidos diretamente para o sistemas de Arquivos + Unicode subjacente, fornecendo suporte multi-lingual para todas + as versões Windows da família NT, incluindo Windows 2000 e Windows XP. + Este suporte não se estende ao Windows 95, 98 ou ME, que + continuam usando o código de página local da máquina para + acesso ao sistema de arquivos.
+ +
Biblioteca de Expressões Regulares Atualizada
+ +
O Apache httpd 2.0 inclui a Biblioteca + de Expressões Regulares Compatível com Perl (PCRE). Todas as + análises de expressões regulares agoram usam a sintaxe mais poderosa + do Perl 5.
+ +
+
top
+
+

Melhorias nos Módulos

+ + +
+
mod_ssl
+ +
Novo módulo no Apache httpd 2.0. Este módulo é uma interface + para os protocolos de codificação SSL/TLS fornecidos pelo + OpenSSL.
+ +
mod_dav
+ +
Novo módulo no Apache httpd 2.0. Este módulo implementa as + especificações de Autoria e Versionamento Distribuídas (DAV) para + para publicação e manutenção de conteúdo web.
+ +
mod_deflate
+ +
Novo módulo no Apache httpd 2.0. Este módulo permite suporte + a navegadores que solicitam que o conteúdo seja comprimido antes da entrega, + economizando tráfego de rede.
+ +
mod_auth_ldap
+ +
Novo módulo no Apache httpd 2.0.41. Este módulo permite que + um banco de dados LDAP seja usados para armazenar credenciais para Autenticação + Básica Básica HTTP. Um módulo que o acompanha, mod_ldap, + fornece o gerenciamento de grupos de conexões e armazenamento de resultados em cache.
+ +
mod_auth_digest
+ +
Inclui suporte adicional para armazenamento de sessões em cache + através de processos que usam memória compartilhada.
+ +
mod_charset_lite
+ +
Novo módulo no Apache httpd 2.0. Este módulo experimental permite + tradução ou recodificação de conjuntos de caracteres.
+ +
mod_file_cache
+ +
Novo módulo no Apache httpd 2.0. Esse módulo inclui a + funcionalidade do mod_mmap_static do Servidor HTTP + Apache versão 1.3 e disponibiliza outras habilidades de armazenamento em cache.
+ +
mod_headers
+ +
Este módulo é muito mais flexível no Apache httpd 2.0. Ele pode agora + modificar cabeçalhos de requisição usados pelo mod_proxy e + pode ajustar cabeçalhos de resposta sob certas condições.
+ +
mod_proxy
+ +
O módulo de proxy foi totalmente reescrito para tomar + vantagem da nova infraestrutura de filtros e para implementar um + proxy mais confiável e compatível com o padrão HTTP/1.1. Além disso, novas + seções de configuração <Proxy> + fornecem controles mais legíveis (e internamente + mais rápidos) de sites com proxies; configurações + sobrecarregadas <Directory "proxy:..."> não são suportadas. + O módulo agora é dividido módulos de suporte a protocolos específicos + incluindo proxy_connect, proxy_ftp e + proxy_http.
+ +
mod_negotiation
+ +
A nova diretiva ForceLanguagePriority pode ser usada para assegurar que + o cliente receba um único documento em todos os casos, em vez de + respostas como "NOT ACCEPTABLE" ou "MULTIPLE CHOICES". Adicionalmente, os algoritmos + de negociação e visualizações múltiplas foram organizados para + fornecer resultados mais consistentes e foi disponibilizado uma nova forma de + mapa de tipo que pode incluir conteúdo de documentos.
+ +
mod_autoindex
+ +
As listagens de diretórios autoindexadas agora podem ser configuradas + para usar tabelas HTML para formatações mais limpas e permitir controles + mais finos de ordenação, incluindo ordenação por versão e filtragem da listagem de + diretórios através de caracteres-coringa.
+ +
mod_include
+ +
Novas diretivas permitem que as tags padrões de início e fim para elementos + SSI possam ser alteradas e permitem que a configuração de formato de erro e horário + ocorra no arquivo de configuração principal em vez de ocorrerem + no documento SSI. Resultados de análises de expressões regulares e agrupamento + (agora baseadas na sintaxe de expressões regulares do Perl) podem ser obtidas + usando as variáveis do módulo mod_include: $0 + .. $9.
+ +
mod_auth_dbm
+ +
Agora suporta múltiplos tipos de banco de dados similares ao DBM usando a + diretiva AuthDBMType.
+ +
+
+
+

Línguas Disponíveis:  de  | + en  | + fr  | + ja  | + ko  | + pt-br  | + tr 

+
+ \ No newline at end of file diff --git a/docs/manual/new_features_2_2.html.pt-br.utf8 b/docs/manual/new_features_2_2.html.pt-br.utf8 new file mode 100644 index 0000000000..481864d737 --- /dev/null +++ b/docs/manual/new_features_2_2.html.pt-br.utf8 @@ -0,0 +1,311 @@ + + + + + + +Visão geral das novas funcionalidades no Servidor HTTP Apache 2.2 - Servidor HTTP Apache Versão 2.4 + + + + + + + +
<-
+

Visão geral das novas funcionalidades no Servidor HTTP Apache 2.2

+ +
+

Línguas Disponíveis:  en  | + fr  | + ko  | + pt-br  | + tr 

+
+ +

Este documento descreve algumas das principais mudanças entre as + versões 2.0 e 2.2 do servidor HTTP Apache. Para obter informações sobre os novos + recursos desde a versão 1.3, consulte o documento Novos + recursos da versão 2.0.

+
+ +
top
+
+

Melhorias do Núcleo

+ +
+ +
Authn/Authz
+
Os módulos de autenticação e autorização incluídos foram + refatorados. O novo módulo mod_authn_alias (já removido das versões 2.3/2.4) + pode simplificar bastante certas configurações de autenticação. + Consulte alterações nos nomes dos módulos e + as alterações para desenvolvedores para obter mais + informações sobre como essas alterações afetam usuários e + desenvolvedores de módulos.
+ +
Cache
+
mod_cache, mod_cache_disk e + mod_mem_cache (já removido das versões 2.3/2.4) tiveram muitas mudanças e + agora são considerados de qualidade de produção. htcacheclean + foi introduzido para limpar as configurações de + mod_cache_disk.
+ +
Configuração
+
O layout de configuração padrão foi simplificado e + modularizado. Trechos de configuração que podem ser usados ​​para + habilitar recursos comumente utilizados agora estão incluídos no Apache e + podem ser facilmente adicionados à configuração principal do servidor.
+ +
Parada graciosa
+
Os MPMs prefork, worker e + event agora permitem que o httpd + seja desligado graciosamente através do sinal + graceful-stop. + A diretiva GracefulShutdownTimeout + foi adicionada para especificar um tempo limite ótimo, após o qual + httpd terminará independentemente do status + de quaisquer requisições sendo servidas.
+ +
Proxy
+
O novo módulo mod_proxy_balancer fornece + serviços de balanceamento de carga para mod_proxy. + O novo módulo mod_proxy_ajp adiciona suporte para o + Protocolo Apache JServ versão 1.3 usado pelo + Apache Tomcat.
+ +
Biblioteca de Expressões Regulares Atualizada
+
A versão 5.0 da + Biblioteca de Expressões Regulares Compatíveis + com Perl (PCRE) agora está incluída. O httpd pode ser + configurado para usar uma instalação do PCRE no sistema, passando a opção + --with-pcre para o comando de configuração.
+ +
Filtragem Inteligente
+
mod_filter introduz configuração dinâmica + à cadeia de filtros de saída. Ele permite que filtros sejam inseridos condicionalmente, + com base em qualquer cabeçalho "Request" ou "Response" ou variável de ambiente, + e dispensa as dependências mais problemáticas e + os problemas de ordenação na arquitetura 2.0.
+ +
Suporte a Arquivos Grandes
+
httpd agora é construído com suporte a arquivos maiores + que 2GB em sistemas Unix modernos de 32 bits. Também foi adicionado suporte + para lidar com corpos de requisição com mais de 2GB.
+ +
MPM de Eventos
+
O módulo MPM event usa um thread separado para lidar com + solicitações "Keep Alive" e aceitar conexões. As solicitações "Keep Alive" + tradicionalmente exigiam que o httpd dedicasse um trabalhador para processá-las. + Esse trabalhador dedicado não podia ser usado novamente até que o tempo limite do "Keep Alive" + fosse atingido.
+ +
Suporte a Banco de Dados SQL
+
mod_dbd, em conjunto com o framework apr_dbd, + traz suporte direto a SQL para os módulos que precisam. + Suporte grupos de conexões em MPMs com threads.
+ +
+
top
+
+

Melhorias nos Módulos

+ +
+
Authn/Authz
+
Módulos no diretório "aaa" foram renomeados e oferecem + um suporte melhor para autenticação "digest". Por exemplo, + mod_auth agora está dividido em + mod_auth_basic e + mod_authn_file; mod_auth_dbm agora é + chamado de mod_authn_dbm; mod_access foi + renomeado para mod_authz_host. Também existe um novo + módulo mod_authn_alias (já removido da versão 2.3/2.4) para simplificar + certas configurações de autenticação. +
+ +
mod_authnz_ldap
+
Este módulo é uma adaptação do módulo + mod_auth_ldap da versão para o framework Authn/Authz + da versão 2.2. Os novos recursos incluem o uso de valores de atributos LDAP e + filtros de pesquisa complexos na + diretiva Require.
+ +
mod_authz_owner
+
Um novo módulo que autoriza o acesso a arquivos com base + no proprietário do arquivo no sistema de arquivos.
+ +
mod_version
+
Um novo módulo que permite habilitar blocos de configuração com base no + número da versão do servidor em execução.
+ +
mod_info
+
Adicionado um novo argumento ?config que mostrará + as diretivas de configuração analisadas pelo Apache, incluindo + o nome do arquivo e o número da linha. O módulo também + mostra a ordem de todos os ganchos de requisição e informações adicionais + de construção, similar a httpd -V.
+ +
mod_ssl
+ +
Adicionado suporte à + RFC 2817, que + permite que conexões sejam atualizadas de texto puro para criptografia TLS.
+ +
mod_imagemap
+
mod_imap foi renomeado para + mod_imagemap para evitar confusão pelo usuário.
+
+ +
top
+
+

Melhorias na Aplicação

+ +
+
httpd
+
Uma nova opção de linha de comando -M foi adicionada. Ela + lista todos os módulos carregados com base na configuração atual. + Diferentemente da opção -l, esta lista + inclui DSOs carregados via mod_so.
+ +
httxt2dbm
+
Um novo programa usado para gerar arquivos dbm a partir de entrada de texto, + para uso em RewriteMap + com o tipo de mapa dbm.
+
+
top
+
+

Alterações para Desenvolvedor de Módulos

+ +
+
API APR 1.0
+ +
Apache 2.2 usa a API APR 1.0. Todas as funções e símbolos + descontinuados foram removidas do APR e do + APR-Util. Para detalhes, consulte o + Website do APR.
+ +
Authn/Authz
+
Os módulos de autenticação e autorização foram + renomeados da seguinte forma: +
    +
  • mod_auth_* -> Módulos que implementam um mecanismo + de autenticação HTTP
  • +
  • mod_authn_* -> Módulos que fornecem um provedor + de autenticação de backend
  • +
  • mod_authz_* -> Módulos que implementam + autorização (ou acesso)
  • +
  • mod_authnz_* -> Módulos que implementam tanto + autenticação quanto autorização
  • +
+ Existe um novo esquema de provedor de backend de + autenticação que facilita bastante a construção de + novos backends de autenticação.
+ +
Registro de Erros de Conexão
+ +
Uma nova função, ap_log_cerror, foi adicionada para registrar + erros que ocorrem com a conexão do cliente. Quando registrada, + a mensagem inclui o endereço IP do cliente.
+ +
Gancho de Configuração de Teste Adicionado
+ +
Um novo gancho, test_config, foi adicionado para auxiliar + módulos que desejam executar código especial somente quando o usuário passar + -t para httpd.
+ +
Definindo o Tamanho da Pilha de MPMs com Threads
+ +
Uma nova diretiva, ThreadStackSize foi adicionada para + definir o tamanho da pilha em todos os MPMs com threads. Isso é necessário + para alguns módulos de terceiros em plataformas com tamanho de pilha de + threads padrão pequeno.
+ +
MAnipulação de protocolo para filtros de saída
+ +
No passado, cada filtro era responsável por garantir + a geração de cabeçalhos de resposta corretos que os afetasse. + Os filtros agora podem delegar o gerenciamento de protocolos comuns para + mod_filter, usando as chamadas + ap_register_output_filter_protocol ou + ap_filter_protocol.
+ +
Gancho de monitoramento adicionado
+
O gancho de monitoramento permite que os módulos executem tarefas regulares/agendadas + no processo pai (raiz).
+ +
Alterações na API de expressões regulares
+ +
O cabeçalho pcreposix.h não está mais disponível; + ele foi substituído pelo novo cabeçalho ap_regex.h. + A implementação POSIX.2 regex.h exposta pelo antigo + cabeçalho agora está disponível no namespace ap_ + a partir de ap_regex.h. Chamadas para regcomp, + regexec e assim por diante podem ser substituídas por chamadas para + ap_regcomp, ap_regexec.
+ +
Framework DBD (API de banco de dados SQL)
+ +

Com o Apache 1.x e 2.0, os módulos que exigiam um backend SQL + tinham que assumir a responsabilidade de gerenciá-lo por conta própria. Além de + reinventar a roda, isso pode ser muito ineficiente, por + exemplo, quando vários módulos mantêm suas próprias conexões.

+ +

O Apache 2.1 e versões posteriores fornecem a API ap_dbd para + gerenciar conexões de banco de dados (incluindo estratégias otimizadas + para MPMs com e sem threads), enquanto o APR 1.2 e versões posteriores fornecem + a API apr_dbd para interagir com o banco de dados.

+ +

Novos módulos DEVEM agora usar essas APIs para todas as operações de banco de dados SQL. + Os aplicativos existentes DEVEM ser atualizados para usá-las + sempre que possível, seja de forma transparente ou como uma opção recomendada + aos seus usuários.

+
+
+
+

Línguas Disponíveis:  en  | + fr  | + ko  | + pt-br  | + tr 

+
+ \ No newline at end of file diff --git a/docs/manual/new_features_2_4.html.pt-br.utf8 b/docs/manual/new_features_2_4.html.pt-br.utf8 new file mode 100644 index 0000000000..2f41d6fb97 --- /dev/null +++ b/docs/manual/new_features_2_4.html.pt-br.utf8 @@ -0,0 +1,482 @@ + + + + + + +Visão geral das novas funcionalidades do Servidor HTTP Apache 2.4 - Servidor HTTP Apache Versão 2.4 + + + + + + + +
<-
+

Visão geral das novas funcionalidades do Servidor HTTP Apache 2.4

+ +
+

Línguas Disponíveis:  en  | + fr  | + pt-br  | + tr 

+
+ +

Este documento descreve algumas das principais mudanças entre as + versões 2.2 e 2.4 do servidor HTTP Apache. Para obter informações sobre os novos recursos + desde a versão 2.0, consulte o documento Novos recursos + da versão 2.2.

+
+ +
top
+
+

Melhorias no Núcleo

+ +
+
MPMs carregáveis no momento da execução
+
Múltiplos MPMs agora podem ser compilados + como módulos carregáveis no momento da compilação. + O MPM escolhido pode ser configurado no momento da execução através da + diretiva LoadModule.
+ +
MPM de Eventos
+
O MPM de Eventos não é mais experimental + e agora é totalmente suportado.
+ +
Suporte assíncrono
+
Melhoria no suporte para leitura/escrita assíncronas para suportar MPMs e + plataformas.
+ +
Configuração de LogLevel por módulo e por diretório
+
A diretiva LogLevel agora pode ser + configurada por módulo e por diretório. Os novos modos trace1 + a trace8 foram adicionados acima do nível + debug.
+ +
Seções de configuração por requisição
+
Seções <If>, + <ElseIf> + e <Else> + podem ser usadas para definir a configuração baseada em critérios + por requisição.
+ +
Analisador de expressão de propósito geral
+
Um novo analisador de expressão permite especificar + condições complexas usando uma sintaxe comum + em diretivas como + SetEnvIfExpr, + RewriteCond, + Header, + <If> + e outras. +
+ +
KeepAliveTimeout em milissegundos
+
Agora é possível especificar KeepAliveTimeout em milissegundos. +
+ +
Diretiva NameVirtualHost
+
Não é mais necessária e tornou-se obsoleta.
+ +
Configuração de Override
+
A nova diretiva AllowOverrideList + permite controle mais fino de quais diretivas são + permitidas em arquivos .htaccess.
+ +
Variáveis do arquivo de configuração
+
Agora é possível definir variáveis na configuração através da diretiva + Define, permitindo uma representação + mais clara se o mesmo valor for usado em vários lugares na configuração. +
+ +
Uso reduzido de memória
+
Mesmo com várias novas funcionalidades, a versão 2.4.x tende a + usar menos memória que a 2.2.x.
+ +
+
top
+
+

Novos Módulos

+ +
+
mod_proxy_fcgi
+
Backend do protocolo FastCGI para mod_proxy.
+ +
mod_proxy_scgi
+
Backend do protocolo SCGI para mod_proxy.
+ +
mod_proxy_express
+
Fornece proxies reversos em massa configurados dinamicamente para + mod_proxy.
+ +
mod_remoteip
+
Substitui o endereço IP remoto e o nome do host do cliente aparentes para a requisição, + com a lista de endereços IP apresentada por um proxy ou um balanceador de carga por meio + dos cabeçalhos da requisição.
+ +
mod_heartmonitor, + mod_lbmethod_heartbeat
+
Permite que o módulo mod_proxy_balancer baseie suas decisões + de balanceamento de carga no número de conexões ativas nos servidores de backend.
+ +
mod_proxy_html
+
Anteriormente um módulo de terceiros, este suporta a correção de links + HTML em uma situação de proxy reverso, onde o backend gera URLs que não + são válidos para os clientes do proxy.
+ +
mod_sed
+
Uma substituição avançada de mod_substitute, permite + editar o corpo da resposta com todo o poder do sed.
+ +
mod_auth_form
+
Permite a autenticação baseada em formulário.
+ +
mod_session
+
Permite o uso do estado da sessão para clientes, usando cookies ou + armazenamento em banco de dados.
+ +
mod_allowmethods
+
Novo módulo para restringir certos métodos HTTP sem interferir na + autenticação ou autorização.
+ +
mod_lua
+
Incorpora a linguagem Lua no httpd, + para configuração e funções de lógica de pequenos negócios (experimental).
+ +
mod_log_debug
+
Permite a adição de registros de depuração personalizáveis ​​em + diferentes fases do processamento da requisição.
+ +
mod_buffer
+
Fornece recursos para o armazenamento em buffer das pilhas de filtros de entrada e saída.
+ +
mod_data
+
Converte o corpo da resposta em um URL de dados RFC2397.
+ +
mod_ratelimit
+
Oferece limitação de largura de banda para clientes.
+ +
mod_request
+
Fornece filtros para manipular e disponibilizar corpos de requisição HTTP.
+ +
mod_reflector
+
Fornece a reflexão do corpo de uma solicitação como resposta por meio da pilha de filtros de saída.
+ +
mod_slotmem_shm
+
Fornece um provedor de memória compartilhada baseado em slots.
+ +
mod_xml2enc
+
Anteriormente um módulo de terceiros, suporta a internacionalização + em módulos de filtro baseados em libxml2 (com reconhecimento de marcação).
+ +
mod_macro (disponível desde a versão 2.4.5)
+
Fornece macros dentro dos arquivos de configuração.
+ +
mod_proxy_wstunnel (disponível desde a versão 2.4.5)
+
Suporta túneis web-socket.
+ +
mod_authnz_fcgi (disponível desde a versão 2.4.10)
+
Permite que aplicativos autorizadores FastCGI autentiquem e/ou + autorizem clientes.
+ +
mod_http2 (disponível desde a versão 2.4.17)
+
Suporte para a camada de transporte HTTP/2.
+ +
mod_proxy_http2 (disponível desde a versão 2.4.19)
+
Backend do protocolo HTTP/2 para mod_proxy
+ +
mod_proxy_hcheck (disponível desde a versão 2.4.21)
+
Suporta verificações de integridade dinâmicas e independentes para servidores backend proxy remotos.
+ +
mod_brotli (disponível desde a versão 2.4.26)
+
Suporta o algoritmo de compressão Brotli.
+ +
mod_md (disponível desde a versão 2.4.30)
+
Suporta o protocolo ACME para automatizar o fornecimento de certificados.
+ +
mod_proxy_uwsgi (disponível desde a versão 2.4.30)
+
Módulo de gateway UWSGI para mod_proxy.
+ +
mod_socache_redis (disponível desde a versão 2.4.39)
+
Suporta provedor de cache de objetos compartilhados baseado em Redis.
+ +
mod_systemd (disponível desde a versão 2.4.42)
+
Integração com systemd. Permite que o httpd seja usado em um serviço com o + Type=notify do systemd.
+ +
+
top
+
+

Melhorias em Módulos

+ +
+
mod_ssl
+ +
O módulo mod_ssl agora pode ser configurado para usar um + servidor OCSP para verificar o status de validação de um certificado de cliente. + O servidor de resposta padrão é configurável, assim como + a decisão de priorizar o servidor de resposta designado no + próprio certificado do cliente.
+ +
mod_ssl agora também suporta grampeamento OCSP, onde o + servidor obtém proativamente uma verificação OCSP de seu certificado e + a transmite ao cliente durante a comunicação inicial.
+ +
mod_ssl agora pode ser configurado para compartilhar dados de sessão SSL + entre servidores através do memcached
+ +
Agora, além de RSA e DSA, também são suportadas chaves EC.
+ +
Suporte para TLS-SRP (disponível na versão 2.4.4 e posteriores).
+ +
mod_proxy
+ +
A diretiva ProxyPass + agora é configurada de forma mais otimizada dentro de um bloco + Location ou + LocationMatch + e oferece uma vantagem de desempenho significativa em relação à sintaxe tradicional de dois parâmetros + quando presente em grande número.
+
O endereço de origem usado para solicitações de proxy agora é configurável.
+
Suporte para sockets de domínio Unix para o backend (disponível na versão 2.4.7 + e posteriores).
+ +
mod_proxy_balancer
+ +
Mais alterações de configuração em tempo de execução para BalancerMembers via balancer-manager.
+ +
BalancerMembers adicionais podem ser adicionados em tempo de execução através do balancer-manager.
+ +
Configuração em tempo de execução de um subconjunto de parâmetros do Balanceador.
+ +
Os membros do BalancerMembers podem ser configurados como 'Drain' para que respondam apenas a sessões + persistentes existentes, permitindo que sejam desconectados corretamente.
+ +
As configurações do balanceador podem persistir após reinicializações.
+ +
mod_cache
+ +
O filtro CACHE do módulo mod_cache pode ser inserido opcionalmente + em um determinado ponto da cadeia de filtros para fornecer um controle preciso sobre o cache. +
+ +
O módulo mod_cache agora pode armazenar em cache as solicitações HEAD.
+ +
Sempre que possível, as diretivas mod_cache agora podem ser definidas + por diretório, em vez de por servidor.
+ +
O URL base dos URLs em cache pode ser personalizado, de forma que um grupo de + caches possa compartilhar o mesmo prefixo de URL de endpoint.
+ +
O módulo mod_cache agora é capaz de fornecer dados em cache desatualizados + quando um backend estiver indisponível (erro 5xx).
+ +
mod_cache agora pode inserir HIT/MISS/REVALIDATE em + um cabeçalho X-Cache.
+ +
mod_include
+
Suporte para o atributo 'onerror' dentro de um elemento 'include', + permitindo que um documento de erro seja exibido em caso de erro, em vez da + string de erro padrão.
+ +
mod_cgi, mod_include, + mod_isapi, ...
+
A tradução de cabeçalhos para variáveis ​​de ambiente é mais rigorosa do que + antes para mitigar possíveis ataques de "cross-site scripting" via injeção de cabeçalho. + Nomes de cabeçalho contendo caracteres inválidos (incluindo sublinhados) + não são mais convertidos em variáveis ​​de ambiente. A seção Variáveis ​​de Ambiente + no Apache contém algumas dicas sobre como contornar problemas com clientes legados + que exigem esses cabeçalhos. (Isso afeta todos os módulos que + usam essas variáveis ​​de ambiente.)
+ +
Contêineres de Lógica de Autorização do mod_authz_core
+ +
Agora é possível especificar lógica de autorização avançada usando a + diretiva Require + e as diretivas de contêiner relacionadas, como + <RequireAll>.
+ +
mod_rewrite
+
mod_rewrite adiciona as opções [QSD] + (Query String Discard) e [END] para a diretiva + RewriteRule para + simplificar cenários comuns de reescrita.
+
Adiciona a possibilidade de usar expressões booleanas complexas em RewriteCond.
+
Permite o uso de consultas SQL como funções RewriteMap.
+ +
mod_ldap, mod_authnz_ldap
+
mod_authnz_ldap adiciona suporte para grupos aninhados.
+
mod_ldap adiciona as diretivas + LDAPConnectionPoolTTL, + LDAPTimeout e + outras melhorias no gerenciamento de limites de tempo. + Isso é especialmente útil para configurações onde um + firewall com estados descarta conexões ociosas com o servidor LDAP.
+
mod_ldap adiciona a diretiva + LDAPLibraryDebug para registrar + informações de depuração fornecidas pelo kit de ferramentas LDAP utilizado.
+ +
mod_info
+
mod_info agora pode despejar a configuração pré-analisada + para stdout durante a inicialização do servidor.
+ +
mod_auth_basic
+
Novo mecanismo genérico para falsificar autenticação básica (disponível em + 2.4.5 e versões posteriores).
+ +
+
top
+
+

Melhorias em Programas

+ +
+
fcgistarter
+
Novo utilitário inicializador de daemon FastCGI
+ +
htcacheclean
+
Agora é possível listar os URLs armazenados em cache, com metadados opcionais + incluídos.
+
Permite excluir explicitamente, do cache, URLs individuais + armazenadas.
+
Os tamanhos dos arquivos agora podem ser arredondados para o tamanho de bloco fornecido, fazendo com que + os limites de tamanho correspondam mais de perto ao tamanho real no disco.
+
O tamanho do cache agora pode ser limitado pelo número de inodes, em vez de, + ou além de, ser limitado pelo tamanho dos arquivos no + disco.
+ +
rotatelogs
+
Agora é possível criar uma atalho para o arquivo de registro atual.
+
Agora é possível invocar um script pós-rotação personalizado.
+ +
htpasswd, htdbm
+
Suporte para o algoritmo bcrypt (disponível na versão 2.4.4 e posteriores). +
+
+
top
+
+

Documentação

+ +
+
mod_rewrite
+
A documentação do mod_rewrite foi + reorganizada e quase completamente reescrita, com foco em + exemplos e uso comum, além de mostrar quando outras + soluções são mais apropriadas. O Guia de + Reescrita agora é uma seção de nível superior com muito mais + detalhes e melhor organização.
+ +
mod_ssl
+
A documentação do mod_ssl foi bastante + aprimorada, com mais exemplos para iniciantes, + além do foco anterior em detalhes técnicos.
+ +
Guia de Cache
+
O Guia de Cache foi reescrito + para distinguir adequadamente entre os recursos de cache HTTP/1.1 da RFC2616 + fornecidos pelo mod_cache e o cache genérico + de chave/valor fornecido pela interface socache + bem como para abranger o cache especializado fornecido por + mecanismos como o mod_file_cache.
+ +
+
top
+
+

Mudanças no Desenvolvedor de Módulos

+ +
+
Adicionado o Gancho de Verificação de Configuração
+ +
Um novo gancho, check_config, foi adicionado e é executado + entre os ganchos pre_config e open_logs. + Ele também é executado antes do gancho test_config + quando a opção -t é passada para o + httpd. O gancho check_config + permite que módulos revisem os valores de diretivas de configuração + interdependentes e os ajustem enquanto as mensagens ainda possam ser registradas + no console. Dessa forma, o usuário pode ser alertado sobre problemas de configuração incorreta + antes que a função principal do gancho open_logs redirecione + a saída do console para o log de erros.
+ +
Adicionado o Analisador de Expressões
+ +
Agora temos um analisador de expressões de propósito geral, cuja API é + exposta em ap_expr.h. Este é adaptado do + analisador de expressões implementado anteriormente em + mod_ssl.
+ +
Contêineres de Lógica de Autorização
+ +
Os módulos de autorização agora se registram como um provedor, por meio de + ap_register_auth_provider(), para oferecer suporte à lógica de autorização avançada, + como <RequireAll>.
+ +
Interface de Cache de Objetos Pequenos
+ +
O cabeçalho ap_socache.h expõe uma interface baseada em provedor + para armazenamento em cache de pequenos objetos de dados, baseada na implementação anterior + do cache de sessão do mod_ssl. + Provedores que utilizam um buffer cíclico de memória compartilhada, arquivos dbm baseados + em disco e um cache distribuído memcache são atualmente + suportados.
+ +
Adicionado o Gancho de Status de Cache
+ +
O módulo mod_cache agora inclui um novo + gancho cache_status, que é chamado quando a decisão de cache + se torna conhecida. Uma implementação padrão fornecida + adiciona à resposta um cabeçalho opcional X-Cache e + X-Cache-Detail.
+
+ +

A documentação do desenvolvedor contém uma + lista detalhada de alterações na API.

+
+
+

Línguas Disponíveis:  en  | + fr  | + pt-br  | + tr 

+
+ \ No newline at end of file
:Exécution des scripts CGI en fonction du type de média ou de la méthode de requête.
: