Your IP : 216.73.217.79
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="pt-br"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="width=device-width, initial-scale=1" name="viewport">
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Atualizando da versão 2.2 para 2.4 - Servidor HTTP Apache Versão 2.4</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
<script src="../style/scripts/prettify.min.js">
</script>
<link href="../images/favicon.png" rel="shortcut icon"></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/index.html">Módulos</a> | <a href="./mod/quickreference.html">Diretivas</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">Perguntas Frequentes</a> | <a href="./glossary.html">Glossário</a> | <a href="./sitemap.html">Mapa do Site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Relate um problema</a></p>
<p class="apache">Servidor HTTP Apache Versão 2.4</p>
<img alt="" src="../images/feather.png"></div>
<div class="up"><a href="./index.html"><img title="<-" alt="<-" src="../images/left.gif"></a></div>
<div id="path">
<a href="https://www.apache.org/">Apache</a> > <a href="https://httpd.apache.org/">Servidor HTTP</a> > <a href="https://httpd.apache.org/docs/">Documentação</a> > <a href="./index.html">Versão 2.4</a></div><div id="page-content"><div id="preamble"><h1>Atualizando da versão 2.2 para 2.4</h1>
<button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button>
<div class="toplang">
<p><span>Línguas Disponíveis: </span><a href="../en/upgrading.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/upgrading.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../../pt-br/upgrading.html" title="Português (Brasil)"> pt-br </a></p>
</div>
<p>Para auxiliar os usuários na atualização, mantemos um documento
que descreve informações essenciais para usuários existentes do Servidor HTTP
Apache. Estas notas são breves e você poderá encontrar
mais informações no documento <a href="new_features_2_4.html">Novas Funcionalidades</a> ou no
arquivo <code>src/CHANGES</code>. Desenvolvedores de aplicações e módulos
podem encontrar um resumo das alterações da API na <a href="developer/new_api_2_4.html">Visão geral de atualizações da API</a>.</p>
<p>Este documento descreve alterações no comportamento do servidor que podem
exigir que você altere sua configuração ou a forma como usa o servidor
para continuar usando a versão 2.4 da mesma forma que usa a versão 2.2.
Para aproveitar os novos recursos da versão 2.4, consulte o documento sobre Novas
Funcionalidades.</p>
<p>Este documento descreve apenas as alterações da versão 2.2 para a 2.4. Se você
estiver atualizando da versão 2.0, também deverá consultar o <a href="http://http://httpd.apache.org/docs/2.2/upgrading.html">Documento de Atualização
da versão 2.0 para 2.2</a>.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif"> <a href="#compile-time">Alterações na Configuração no Momento da Compilação</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#run-time">Alterações na Configuração no Momento da Execução</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#misc">Alterações Miscelâneas</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#third-party">Módulos de Terceiros</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#commonproblems">Problemas comuns ao atualizar</a></li>
</ul><h3>Veja também</h3><ul class="seealso"><li><a href="new_features_2_4.html">Visão geral das novas funcionalidades
no Servidor HTTP Apache 2.4</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="compile-time">Alterações na Configuração no Momento da Compilação <a title="Link permanente" href="#compile-time" class="permalink">¶</a></h2>
<p>O processo de compilação é muito semelhante ao usado na
versão 2.2. Sua antiga linha de comando <code>configure</code>
(encontrada em <code>build/config.nice</code> no diretório do servidor
instalado) pode ser usada na maioria dos casos. Há algumas alterações nas
configurações padrão. Alguns detalhes das alterações:</p>
<ul>
<li>Estes módulos foram removidos: mod_authn_default,
mod_authz_default, mod_mem_cache. Se você estava usando
mod_mem_cache na versão 2.2, consulte <code class="module"><a href="./mod/mod_cache_disk.html">mod_cache_disk</a></code>
na versão 2.4.</li>
<li>Todas as implementações de balanceamento de carga foram movidas para
submódulos individuais e independentes do mod_proxy, por exemplo:
<code class="module"><a href="./mod/mod_lbmethod_bybusyness.html">mod_lbmethod_bybusyness</a></code>. Você pode precisar
compilar e carregar qualquer um desses que sua configuração
utiliza.</li>
<li>O suporte à plataforma foi removido para BeOS, TPF e
até mesmo plataformas mais antigas, como A/UX, Next e Tandem. Acredita-se
que estas já não estivessem funcionando corretamente.</li>
<li>configure: módulos dinâmicos (DSO) são compilados por padrão.</li>
<li>configure: por padrão, apenas um conjunto básico de módulos é carregado. As
outras diretivas <code class="directive">LoadModule</code> estão comentadas
no arquivo de configuração.</li>
<li>configure: o conjunto de módulos "most" ("maioria") é compilado por padrão</li>
<li>configure: o conjunto de módutos "reallyall" ("realmente todos") adiciona os módulos de desenvolvedor
ao conjunto "all" ("todos")</li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="run-time">Alterações na Configuração no Momento da Execução <a title="Link permanente" href="#run-time" class="permalink">¶</a></h2>
<p>Houve mudanças significativas na configuração de autorização e outras
pequenas alterações de configuração que podem exigir alterações em seus arquivos
de configuração da versão 2.2 antes de usá-los na versão 2.4.</p>
<h3 id="authz">Autorização</h3>
<p>Qualquer arquivo de configuração que utilize autorização provavelmente
precisará de alterações.</p>
<p>Você deve revisar a seção <a href="howto/auth.html">Como Fazer: Autenticação,
Autorização e Controle de Acesso</a>, especialmente a parte
<a href="howto/auth.html#beyond">Além da simples autorização</a>
que explica os novos mecanismos para controlar a ordem
em que as diretivas de autorização são aplicadas.</p>
<p>As diretivas que controlam como os módulos de autorização respondem quando
não correspondem ao usuário autenticado foram removidas: Isso inclui
AuthzLDAPAuthoritative, AuthzDBDAuthoritative, AuthzDBMAuthoritative,
AuthzGroupFileAuthoritative, AuthzUserAuthoritative,
e AuthzOwnerAuthoritative. Essas diretivas foram substituídas pelas
diretivas mais expressivas <code class="directive"><a href="./mod/mod_authz_core.html#requireany">RequireAny</a></code>,
<code class="directive"><a href="./mod/mod_authz_core.html#requirenone">RequireNone</a></code> e
<code class="directive"><a href="./mod/mod_authz_core.html#requireall">RequireAll</a></code>.</p>
<p>Se você usa <code class="module"><a href="./mod/mod_authz_dbm.html">mod_authz_dbm</a></code>, você deve migrar sua
configuração para usar <code>Require dbm-group ...</code> em vez de
<code>Require group ...</code>.</p>
<h4 id="access">Controle de acesso</h4>
<p>Na versão 2.2, o controle de acesso baseado no nome do host do cliente, no endereço IP,
e em outras características das solicitações do cliente era feito usando as
diretivas <code class="directive"><a href="./mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code> e <code class="directive"><a href="./mod/mod_access_compat.html#satisfy">Satisfy</a></code>.</p>
<p>Na versão 2.4, esse controle de acesso é feito da mesma forma que outras
verificações de autorização, usando o novo módulo
<code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code>. Os antigos padrões de controle de acesso
devem ser substituídos pelos novos mecanismos de autenticação,
embora, para compatibilidade com configurações antigas, o novo
módulo <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> seja fornecido.</p>
<div class="note"><h3>Misturando diretivas antigas com novas</h3>
<p>Misturar diretivas antigas como <code class="directive"><a href="./mod/mod_access_compat.html#order">Order</a></code>, <code class="directive"><a href="./mod/mod_access_compat.html#allow">Allow</a></code> ou <code class="directive"><a href="./mod/mod_access_compat.html#deny">Deny</a></code> com novas como
<code class="directive"><a href="./mod/mod_authz_core.html#require">Require</a></code> é possível tecnicamente porém
não é recomendado. <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> foi criado para suportar
configurações que contêm somente diretivas antigas para facilitar a migração para a versão 2.4.
Favor verificar os exemplos abaixo para ter uma ideia melhor sobre os problemas que podem surgir.
</p>
</div>
<p>Aqui estão alguns exemplos de maneiras antigas e novas de fazer o mesmo
controle de acesso.</p>
<p>Neste exemplo, não há autenticação e todas as solicitações são negadas.</p>
<div class="example"><h3>Configuração na versão 2.2:</h3><pre class="prettyprint lang-config">Order deny,allow
Deny from all</pre>
</div>
<div class="example"><h3>Configuração na versão 2.4:</h3><pre class="prettyprint lang-config">Require all denied</pre>
</div>
<p>Neste exemplo, não há autenticação e todas as solicitações são permitidas.</p>
<div class="example"><h3>Configuração na versão 2.2:</h3><pre class="prettyprint lang-config">Order allow,deny
Allow from all</pre>
</div>
<div class="example"><h3>Configuração na versão 2.4:</h3><pre class="prettyprint lang-config">Require all granted</pre>
</div>
<p>No exemplo a seguir, não há autenticação e todos os hosts no domínio example.org
têm acesso permitido; todos os outros têm acesso negado.</p>
<div class="example"><h3>Configuração na versão 2.2:</h3><pre class="prettyprint lang-config">Order Deny,Allow
Deny from all
Allow from example.org</pre>
</div>
<div class="example"><h3>Configuração na versão 2.4:</h3><pre class="prettyprint lang-config">Require host example.org</pre>
</div>
<p>No exemplo a seguir, misturar diretivas antigas e novas leva a
resultados inesperados.</p>
<div class="example"><h3>Misturando diretivas antigas e novas: NÃO FUNCIONA COMO ESPERADO</h3><pre class="prettyprint lang-config">DocumentRoot "/var/www/html"
<Directory "/">
AllowOverride None
Order deny,allow
Deny from all
</Directory>
<Location "/server-status">
SetHandler server-status
Require local
</Location>
access.log - GET /server-status 403 127.0.0.1
error.log - AH01797: client denied by server configuration: /var/www/html/server-status</pre>
</div>
<p>Por que o httpd nega acesso a server-status mesmo quando a configuração parece permitir?
Porque as diretivas <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> tem precedência
sobre as <code class="module"><a href="./mod/mod_authz_host.html">mod_authz_host</a></code> neste cenário de
<a href="sections.html#merging">mesclagem</a> de configurações.</p>
<p>Este exemplo, por outro lado, funciona como esperado:</p>
<div class="example"><h3>Misturando diretivas antigas e novas: FUNCIONA COMO ESPERADO</h3><pre class="prettyprint lang-config">DocumentRoot "/var/www/html"
<Directory "/">
AllowOverride None
Require all denied
</Directory>
<Location "/server-status">
SetHandler server-status
Order deny,allow
Deny from all
Allow From 127.0.0.1
</Location>
access.log - GET /server-status 200 127.0.0.1</pre>
</div>
<p>Portanto, mesmo se a mistura de configurações ainda seja
possível, tente evitar na atualizaçao: mantenha diretivas antigas e somente
migre para as novas em um estágio posterior ou migre tudo de uma vez.
</p>
<p>Em muitas configurações com autenticação, onde o valor de
<code class="directive">Satisfy</code> tinha o padrão de <em>ALL</em>, trechos
que simplesmente desligavam o controle de acesso baseado em host são omitidos:</p>
<div class="example"><h3>Configuração na versão 2.2:</h3><pre class="prettyprint lang-config"># configuração na versão 2.2 que desliga o controle de acesso baseado em host e usa somente autenticação
Order Deny,Allow
Allow from all
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<div class="example"><h3>Configuração na versão 2.4:</h3><pre class="prettyprint lang-config"># Não é necessário substituir o controle de acesso baseado em host
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<p>Em configurações onde a autenticação e o controle de acesso eram adequadamente combinados, as
diretivas de controle de acesso devem ser migradas. Este exemplo permite que as solicitações atendam a <em>ambos</em> os critérios:</p>
<div class="example"><h3>Configuração na versão 2.2:</h3><pre class="prettyprint lang-config">Order allow,deny
Deny from all
# Satisfy ALL is the default
Satisfy ALL
Allow from 127.0.0.1
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<div class="example"><h3>Configuração na versão 2.4:</h3><pre class="prettyprint lang-config">AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
<RequireAll>
Require valid-user
Require ip 127.0.0.1
</RequireAll></pre>
</div>
<p>Em configurações onde a autenticação e o controle de acesso eram adequadamente combinados, as
diretivas de controle de acesso devem ser migradas. Este exemplo permite que as solicitações atendam a <em>qualquer</em> um dos critérios:</p>
<div class="example"><h3>Configuração na versão 2.2:</h3><pre class="prettyprint lang-config">Order allow,deny
Deny from all
Satisfy any
Allow from 127.0.0.1
AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
Require valid-user</pre>
</div>
<div class="example"><h3>Configuração na versão 2.4:</h3><pre class="prettyprint lang-config">AuthType Basic
AuthBasicProvider file
AuthUserFile /example.com/conf/users.passwd
AuthName secure
# <RequireAny> (implícito)
Require valid-user
Require ip 127.0.0.1</pre>
</div>
<h3 id="config">Outras mudanças na configuração</h3>
<p>Alguns outros pequenos ajustes podem ser necessários para configurações
em particular como discutido abaixo.</p>
<ul>
<li><code class="directive">MaxRequestsPerChild</code> foi renomeada para
<code class="directive"><a href="./mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>,
descrevendo com maior precisão o que ela faz. O nome antigo ainda
é suportado.</li>
<li><code class="directive">MaxClients</code> foi renomeada para
<code class="directive"><a href="./mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>,
que descreve melhor o que ela faz. Para MPMs assíncronos, como
<code class="module"><a href="./mod/event.html">event</a></code>, o número máximo de clientes não é
equivalente ao número de threads. O nome antigo ainda
é suportado.</li>
<li>A diretiva <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code>
não tem mais nenhum efeito além de emitir um
alerta se for usada com algum valor diferente de
<code>none</code>. É necessário usar outras configurações
para substituí-la na versão 2.4.
</li>
<li>O padrão para <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
agora é <code>None</code>.</li>
<li>O padrão para <code class="directive"><a href="./mod/core.html#enablesendfile">EnableSendfile</a></code>
agora é Off.</li>
<li>O padrão para <code class="directive"><a href="./mod/core.html#fileetag">FileETag</a></code>
agora é "MTime Size" (sem INode).</li>
<li><code class="module"><a href="./mod/mod_dav_fs.html">mod_dav_fs</a></code>: O formato do arquivo de <code class="directive"><a href="./mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> foi alterado para
sistemas com inodes. o arquivos antigo de <code class="directive"><a href="./mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> precisa ser apagado na
atualização.
</li>
<li><code class="directive"><a href="./mod/core.html#keepalive">KeepAlive</a></code> somente
aceita valores de <code>On</code> ou <code>Off</code>.
Anteriormente, qualquer valor diferente de "Off" ou "0" era tratado como
"On".</li>
<li>As diretivas AcceptMutex, LockFile, RewriteLock, SSLMutex,
SSLStaplingMutex e WatchdogMutexPath foram substituídas
por uma única diretiva <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.
É necessário avaliar o uso dessas diretivas
removidas na configuração 2.2 para determinar se elas podem
ser apenas removidas ou se precisam ser substituídas usando <code class="directive"><a href="./mod/core.html#mutex">Mutex</a></code>.</li>
<li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>: <code class="directive"><a href="./mod/mod_cache.html#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></code>
agora faz uma correspondência exata com a string de consulta em vez de
um correspondência parcial. Se a configuração estava usando strings
parciais, por exemplo, usando <code>sessionid</code> para corresponder a
<code>/someapplication/image.gif;jsessionid=123456789</code>,
então será necessário alterar para a string completa
<code>jsessionid</code>.
</li>
<li><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code>: O segundo parâmetro para
<code class="directive"><a href="./mod/mod_cache.html#cacheenable">CacheEnable</a></code> somente
corresponde ao conteúdo do proxy direto se ele começar com o protocolo
correto. Na versão 2.2 e anteriores, um parâmetro de '/' correspondia a todo o
conteúdo.</li>
<li><code class="module"><a href="./mod/mod_ldap.html">mod_ldap</a></code>: <code class="directive"><a href="./mod/mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></code> agora é,
consistentemente, uma configuração apenas por diretório. Se esta diretiva
for usada, revise a configuração para garantir que ela está
presente em todos os contextos de diretório necessários.</li>
<li><code class="module"><a href="./mod/mod_filter.html">mod_filter</a></code>: a sintaxe de <code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code> foi alterada e
agora usa uma expressão booleana para determinar se um filtro está aplicado.
</li>
<li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code>:
<ul>
<li>O elemento <code>#if expr</code> agora usa o novo <a href="expr.html">analisador de expressões</a>. A sintaxe antiga pode ser
restaurada com a nova diretiva <code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code>.
</li>
<li>Uma diretiva de configuração SSI* em escopo de diretório não faz mais
com que todas as outras diretivas SSI* por diretório sejam redefinidas para seus
valores padrão.</li>
</ul>
</li>
<li><code class="module"><a href="./mod/mod_charset_lite.html">mod_charset_lite</a></code>: A opção <code>DebugLevel</code>
foi removida em favor da configuração <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> por módulo.
</li>
<li><code class="module"><a href="./mod/mod_ext_filter.html">mod_ext_filter</a></code>: A opção <code>DebugLevel</code>
foi removida em favor da configuração <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> por módulo.
</li>
<li><code class="module"><a href="./mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>: A configuração padrão para
<code>PATH_INFO</code> foi alterada em relação à versão 2.2 e
algumas aplicações web não irão mais operar adequadamente com a
nova configuração de <code>PATH_INFO</code>. A configuração anterior
pode ser restaurada através da configuração da variável
<code>proxy-scgi-pathinfo</code>.</li>
<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>: A verificação de revogação baseada em CRL
agora precisa ser configurada explicitamente através de <code class="directive"><a href="./mod/mod_ssl.html#sslcarevocationcheck">SSLCARevocationCheck</a></code>.
</li>
<li><code class="module"><a href="./mod/mod_substitute.html">mod_substitute</a></code>: O comprimento máximo de linha agora
é limitado a 1MB.
</li>
<li><code class="module"><a href="./mod/mod_reqtimeout.html">mod_reqtimeout</a></code>: Se o módulo for carregado, ele
agora definirá alguns limites de tempo padrões.</li>
<li><code class="module"><a href="./mod/mod_dumpio.html">mod_dumpio</a></code>: <code class="directive">DumpIOLogLevel</code>
não é mais suportado. Os dados são sempre registrados com <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> no nível <code>trace7</code>.</li>
<li>Em plataformas Unix, comandos de registro encadeados configurados com
<code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> ou
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> eram chamados usando
<code>/bin/sh -c</code> na versão 2.2 e anteriores. Na versão 2.4 e posteriores,
comandos de registro encadeados são executados diretamente. Para restaurar o
comportamento antigo, consulte a <a href="logs.html#piped">documentação sobre
registros encadeados</a>.</li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="misc">Alterações Miscelâneas <a title="Link permanente" href="#misc" class="permalink">¶</a></h2>
<ul>
<li><code class="module"><a href="./mod/mod_autoindex.html">mod_autoindex</a></code>: agora extrai títulos e
exibe descrições para arquivos .xhtml, que antes eram
ignorados.</li>
<li><code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>: O formato padrão das variáveis <code>*_DN</code>
foi alterado. O formato antigo ainda pode ser usado com o novo argumento
<code>LegacyDNStringFormat</code> da diretiva <code class="directive"><a href="./mod/mod_ssl.html#ssloptions">SSLOptions</a></code>. O protocolo SSLv2
não é mais suportado. <code class="directive"><a href="./mod/mod_ssl.html#sslproxycheckpeercn">SSLProxyCheckPeerCN
</a></code> e <code class="directive"><a href="./mod/mod_ssl.html#sslproxycheckpeerexpire">SSLProxyCheckPeerExpire
</a></code> agora são ativadas por padrão, fazendo com que as solicitações de proxy para hosts HTTPS
com certificados inválidos ou desatualizados falhem com código de status 502 (Bad
gateway)</li>
<li><code class="program"><a href="./programs/htpasswd.html">htpasswd</a></code> agora usa hash MD5 por padrão em
todas as plataformas.</li>
<li>A diretiva <code class="directive"><a href="./mod/core.html#namevirtualhost">NameVirtualHost</a></code>
não tem mais efeito, além de emitir um
alerta. Qualquer combinação de endereço/porta que apareça em vários
hosts virtuais é implicitamente tratada como um host virtual baseado em nome.
</li>
<li><code class="module"><a href="./mod/mod_deflate.html">mod_deflate</a></code> agora irá ignorar a compressão se souber
que a sobrecarga de tamanho adicionada pela compressão será maior que os dados
a serem comprimidos.
</li>
<li>Documentos de erro multilíngues da versão 2.2.x podem não funcionar a menos que
sejam ajustados à nova sintaxe do elemento <code>#if expr=</code> do
módulo <code class="module"><a href="./mod/mod_include.html">mod_include</a></code> ou que a diretiva
<code class="directive"><a href="./mod/mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></code> esteja
habilitada para o diretório que contém os documentos de erro.
</li>
<li>A funcionalidade fornecida por <code>mod_authn_alias</code>
em versões anteriores (ou seja, a diretiva <code class="directive"><a href="./mod/mod_authn_core.html#authnprovideralias">AuthnProviderAlias</a></code>)
foi movida para <code class="module"><a href="./mod/mod_authn_core.html">mod_authn_core</a></code>.
</li>
<li>As diretivas RewriteLog e RewriteLogLevel foram removidas.
Esta funcionalidade agora é disponibilizada configurando o nível adequado
de registro para o módulo <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> usando a
diretiva <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code>.
Consulte também a seção sobre <a href="mod/mod_rewrite.html#logging">registros de
mod_rewrite</a>.</li>
<li>A etiqueta <code><set></code> do módulo <code class="module"><a href="./mod/mod_include.html">mod_include</a></code> não
realiza mais a decodificação de entidades no valor que está sendo definido.</li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="third-party">Módulos de Terceiros <a title="Link permanente" href="#third-party" class="permalink">¶</a></h2>
<p>Todos os módulos devem ser recompilados para a versão 2.4 antes de serem carregados.</p>
<p>Muitos módulos de terceiros projetados para a versão 2.2
funcionarão sem alterações com a versão 2.4 do Apache HTTP Server.
Alguns exigirão alterações; consulte a <a href="developer/new_api_2_4.html">Visão geral da
atualização da API</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="commonproblems">Problemas comuns ao atualizar <a title="Link permanente" href="#commonproblems" class="permalink">¶</a></h2>
<ul><li>Erros na inicialização:
<ul>
<li><code>Invalid command 'User', perhaps misspelled or defined by a module not included in the server configuration</code> - carregue o módulo <code class="module"><a href="./mod/mod_unixd.html">mod_unixd</a></code></li>
<li><code>Invalid command 'Require', perhaps misspelled or defined by a module not included in the server configuration</code>, ou
<code>Invalid command 'Order', perhaps misspelled or defined by a module not included in the server configuration</code>
- carregue o módulo <code class="module"><a href="./mod/mod_access_compat.html">mod_access_compat</a></code> ou atualize a configuração para as diretivas de autorização da versão 2.4.</li>
<li><code>Ignoring deprecated use of DefaultType in line NN of /path/to/apache2.conf</code> - remova a diretiva <code class="directive"><a href="./mod/core.html#defaulttype">DefaultType</a></code>
e substitua por outra configuração.</li>
<li><code>Invalid command 'AddOutputFilterByType', perhaps misspelled
or defined by a module not included in the server configuration
</code> - <code class="directive"><a href="./mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code>
foi movida do núcleo para o módulo mod_filter, que precisa ser carregado.</li>
</ul></li>
<li>Erros ao servir requisições:
<ul>
<li><code>configuration error: couldn't check user: /path</code> -
carregue o módulo <code class="module"><a href="./mod/mod_authn_core.html">mod_authn_core</a></code>.</li>
<li>arquivos <code>.htaccess</code> são estão sendo processados - Verifique uma
diretiva <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> apropriada;
o padrão mudou para <code>None</code> na versão 2.4.</li>
</ul>
</li>
</ul>
</div></div>
<div class="bottomlang">
<p><span>Línguas Disponíveis: </span><a href="../en/upgrading.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/upgrading.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../../pt-br/upgrading.html" title="Português (Brasil)"> pt-br </a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Licenciado sob a <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/index.html">Módulos</a> | <a href="./mod/quickreference.html">Diretivas</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">Perguntas Frequentes</a> | <a href="./glossary.html">Glossário</a> | <a href="./sitemap.html">Mapa do Site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Relate um problema</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
var langToggle = document.querySelector('.lang-toggle');
var topLang = document.querySelector('.toplang');
if (langToggle && topLang) {
langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); });
}
var qv = document.getElementById('quickview');
if (qv) {
document.body.appendChild(qv);
var qvBtn = document.createElement('button');
qvBtn.className = 'qv-toggle';
qvBtn.setAttribute('aria-label', 'Toggle page navigation');
qvBtn.innerHTML = '☰';
document.body.appendChild(qvBtn);
qvBtn.addEventListener('click', function() {
var isOpen = qv.classList.toggle('open');
if (isOpen) {
qv.style.top = window.scrollY + 10 + 'px';
}
});
window.addEventListener('scroll', function() { qv.classList.remove('open'); });
}
//--><!]]></script>
</body></html>