granicus.if.org Git - apache/blob - docs/manual/upgrading.xml.pt-br

   1 <?xml version='1.0' encoding='UTF-8' ?>
   2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="./style/manual.pt-br.xsl"?>
   4 <!-- English Revision: 151408:420990 (outdated) -->
   5
   6 <!--
   7  Licensed to the Apache Software Foundation (ASF) under one or more
   8  contributor license agreements.  See the NOTICE file distributed with
   9  this work for additional information regarding copyright ownership.
  10  The ASF licenses this file to You under the Apache License, Version 2.0
  11  (the "License"); you may not use this file except in compliance with
  12  the License.  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <manualpage metafile="upgrading.xml.meta">
  24
  25 <title>Atualizando da vers&#227;o 1.3 para 2.0</title>
  26
  27 <summary>
  28   <p>Com a finalidade de ajudar as pessoas na atualiza&#231;&#227;o do servidor,
  29   n&#243;s mantemos um documento que descreve informa&#231;&#245;es cr&#237;ticas para
  30   os usu&#225;rios j&#225; existentes do Apache. Essas informa&#231;&#245;es tem o
  31   intuito de serem breves notas e voc&#234; dever&#225; encontrar mais
  32   informa&#231;&#245;es no documento <a
  33   href="new_features_2_0.html">Novas Funcionalidades</a>, ou no
  34   arquivo <code>src/CHANGES</code>.</p>
  35 </summary>
  36 <seealso><a href="new_features_2_0.html">Descri&#231;&#227;o das novas
  37   funcionalidades do Apache 2.0</a></seealso>
  38
  39   <section id="compile-time">
  40     <title>Mudan&#231;as na Configura&#231;&#227;o em tempo de Compila&#231;&#227;o</title>
  41
  42     <ul>
  43       <li>O Apache agora usa o sistema <code>autoconf</code>
  44       e <code>libtool</code> para <a href="install.html">
  45       configurar o processo de constru&#231;&#227;o</a>.
  46       A utiliza&#231;&#227;o desse sistema &#233; similar, mas n&#227;o o
  47       mesmo, a usar o sistema APACI do Apache 1.3</li>
  48
  49       <li>Al&#233;m da sele&#231;&#227;o habitual de m&#243;dulos que voc&#234;
  50       pode escolher para compilar, o Apache 2.0 mudou a parte
  51       principal de processamentos de pedidos para os <a
  52       href="mpm.html">M&#243;dulos Multi-Processamento</a> (MPMs).</li>
  53     </ul>
  54   </section>
  55
  56   <section id="run-time">
  57     <title>Mudan&#231;as na Configura&#231;&#227;o em tempo de Execu&#231;&#227;o</title>
  58
  59     <ul>
  60       <li>Muitas diretrizes que estavam no n&#250;cleo do servidor
  61       no Apache 1.3 est&#227;o agora nos MPMs. Se voc&#234; desejar que
  62       o funcionamento do servidor seja o mais similar poss&#237;vel ao
  63       do Apache 1.3, voc&#234; deve selecionar o MPM <module>prefork</module>.
  64       Os outros MPMs ter&#227;o diretrizes diferentes para controlar
  65       a cria&#231;&#227;o de processos e o processamento de pedidos.</li>
  66
  67       <li>O <a href="mod/mod_proxy.html">m&#243;dulo proxy</a> foi reconstru&#237;do
  68       para o padr&#227;o HTTP/1.1. Ao longo das mudan&#231;as importantes,
  69       o controle de acesso ao proxy agora fica dentro de um bloco
  70       <directive type="section" module="mod_proxy">Proxy</directive>,
  71       ao inv&#233;s de um bloco <code>&lt;Directory proxy:&gt;</code>.</li>
  72
  73       <li>A opera&#231;&#227;o com <code>PATH_INFO</code> (informa&#231;&#227;o de
  74       caminho procedente depois do nome do arquivo verdadeiro) mudou
  75       para alguns m&#243;dulos. M&#243;dulos que eram previamente implementados
  76       como manipuladores mas agora s&#227;o implementados como filtros
  77       n&#227;o podem mais aceitar pedidos com <code>PATH_INFO</code>.
  78       Filtros como <a href="mod/mod_include.html">INCLUDES</a>
  79       ou <a href="http://www.php.net/">PHP</a> s&#227;o implementados
  80       no topo dos manipuladores principais, rejeitando pedidos
  81       com <code>PATH_INFO</code>. Voc&#234; pode usar a diretriz
  82       <directive module="core">AcceptPathInfo</directive>
  83       para for&#231;ar o manipulador principal a aceitar pedidos
  84       com <code>PATH_INFO</code> e assim restaurar a habilidade
  85       de us&#225;-lo em inclus&#245;es por parte do servidor (SSI).</li>
  86
  87       <li>A diretriz <directive
  88       module="mod_negotiation">CacheNegotiatedDocs</directive> agora aceita
  89       o argumento <code>on</code> ou <code>off</code>. Inst&#226;ncias
  90       existentes de <directive>CacheNegotiatedDocs</directive> dever&#227;o
  91       ser substitu&#237;das por <code>CacheNegotiatedDocs on</code>.</li>
  92
  93       <li>
  94         A diretriz <directive module="core">ErrorDocument</directive>
  95         n&#227;o usa mais aspas no come&#231;o do argumento para indicar
  96         mensagens de texto. Ao inv&#233;s disso, voc&#234; deve colocar
  97         a mensagem inteira entre aspas. Por exemplo, inst&#226;ncias
  98         existentes de
  99
 100         <example>
 101           ErrorDocument 403 "Alguma mensagem
 102         </example>
 103         devem ser substitu&#237;das por
 104
 105         <example>
 106           ErrorDocument 403 "Alguma mensagem"
 107         </example>
 108
 109         Contanto que o segundo argumento n&#227;o seja uma
 110         URL v&#225;lida ou um caminho de arquivo, ir&#225; ser
 111         tratado como uma mensagem de texto.
 112       </li>
 113
 114       <li>As diretrizes <code>AccessConfig</code> e
 115       <code>ResourceConfig</code> n&#227;o existem mais.
 116       Inst&#226;ncias existentes dessas diretrizes podem ser substitu&#237;das
 117       com a diretriz <directive module="core">Include</directive>
 118       que possui uma funcionalidade equivalente. Se voc&#234; estava
 119       fazendo uso dos valores padr&#245;es dessas diretrizes sem inclu&#237;-las
 120       nos arquivos de configura&#231;&#227;o, voc&#234; provavelmente ter&#225;
 121       que adicionar <code>Include conf/access.conf</code> e
 122       <code>Include conf/srm.conf</code> ao seu <code>httpd.conf</code>.
 123       Com o fim de assegurar que o Apache leia os arquivos de
 124       configura&#231;&#227;o na mesma ordem que as diretrizes velhas usavam,
 125       a diretriz <directive module="core">Include</directive> deve ser colocada
 126       no final do <code>httpd.conf</code>, com uma entrada para
 127       <code>srm.conf</code> antes de <code>access.conf</code>.</li>
 128
 129       <li>As diretrizes <code>BindAddress</code> and <code>Port</code>
 130       n&#227;o existem mais. Uma funcionalidade equivalente &#233; fornecida com
 131       uma diretriz mais flex&#237;vel <directive
 132       module="mpm_common">Listen</directive>.</li>
 133
 134       <li>Outro uso da diretriz <code>Port</code> no Apache-1.3
 135       era ajustar o n&#250;mero da porta usada em URLs auto-referenci&#225;veis.
 136       O equivalente no Apache-2.0 &#233; a nova sintaxe <directive
 137       module="core">ServerName</directive>: ela foi modificada para permitir que
 138       sejam especificados ambos "hostname" <em>e</em> o n&#250;mero da porta
 139       para URLs auto-referenci&#225;veis em uma s&#243; diretriz.</li>
 140
 141       <li>A diretriz <code>ServerType</code> n&#227;o existe mais.
 142       O m&#233;todo usado para atender pedidos &#233; determinado pela
 143       sele&#231;&#227;o de MPM. Atualmente n&#227;o existe nenhuma MPM projetada
 144       para ser executada pelo inetd.</li>
 145
 146       <li>Os m&#243;dulos <code>mod_log_agent</code> e <code>mod_log_referer</code>
 147       que forneciam as diretrizes <code>AgentLog</code>,
 148       <code>RefererLog</code> e <code>RefererIgnore</code> foram removidas.
 149       Registros de agentes e refer&#234;ncias ainda est&#227;o dispon&#237;veis
 150       usando a diretriz <directive
 151       module="mod_log_config">CustomLog</directive> do
 152       <module>mod_log_config</module>.</li>
 153
 154       <li>As diretrizes <code>AddModule</code> e
 155       <code>ClearModuleList</code> n&#227;o existem mais.
 156       Essas diretrizes eram usadas para garantir que m&#243;dulos
 157       pudessem ser habilitados na ordem correta. A nova API do
 158       Apache 2.0 permite que os m&#243;dulos especifiquem explicitamente
 159       a sua ordem, eliminando a necessidade dessas diretrizes.</li>
 160
 161       <li>A diretriz <code>FancyIndexing</code> foi removida.
 162       A mesma funcionalidade est&#225; dispon&#237;vel atrav&#233;s da
 163       op&#231;&#227;o <code>FancyIndexing</code> da diretriz <directive
 164       module="mod_autoindex">IndexOptions</directive>.</li>
 165
 166       <li>A t&#233;cnica de negocia&#231;&#227;o de conte&#250;do (content-negotiation)
 167       MultiViews fornecida pelo <module>mod_negotiation</module>
 168       se tornou mais rigorosa em sua combina&#231;&#227;o de arquivo
 169       padr&#227;o. Ela ir&#225; selecionar apenas arquivos negoci&#225;veis
 170       (<em>negotiable</em>). O comportamento antigo pode ser restaurado usando a
 171       diretriz <directive module="mod_mime">MultiviewsMatch</directive>.</li>
 172
 173       <li>(<em>desde a vers&#227;o 2.0.51</em>)
 174       <p>A funcionalidade da diretriz <code>ErrorHeader</code>
 175       foi colocada em conjunto com a diretriz <directive
 176       module="mod_headers">Header</directive>, j&#225; que era um
 177       uso de um nome impr&#243;prio. Utilize</p>
 178
 179       <example>
 180         Header always set foo bar
 181       </example>
 182
 183       <p>para obter o comportamento desejado.</p></li>
 184     </ul>
 185   </section>
 186
 187   <section id="misc">
 188     <title>Mudan&#231;as Gerais</title>
 189
 190     <ul>
 191       <li>O m&#243;dulo <module>mod_auth_digest</module>, que era
 192       experimental no Apache 1.3, &#233; agora um m&#243;dulo padr&#227;o.</li>
 193
 194       <li>O m&#243;dulo <code>mod_mmap_static</code>, que era experimental no
 195       Apache 1.3, foi substitu&#237;do com <module>mod_file_cache</module>.</li>
 196
 197       <li>A distribui&#231;&#227;o foi completamente reorganizada para
 198       n&#227;o conter mais um diret&#243;rio <code>src</code> independente.
 199       Em seu lugar, os fontes s&#227;o organizados
 200       logicamente no diret&#243;rio principal da distribui&#231;&#227;o e
 201       a instala&#231;&#227;o do servidor compilado deve ser direcionada
 202       &#224; um diret&#243;rio separado.</li>
 203     </ul>
 204   </section>
 205
 206   <section id="third-party">
 207     <title>M&#243;dulos de Terceiros</title>
 208
 209     <p>Mudan&#231;as extensivas foram feitas na API do servidor
 210     no Apache 2.0. M&#243;dulos existentes projetados para a API
 211     do Apache 1.3, <strong>n&#227;o</strong> funcionar&#227;o no Apache
 212     2.0 sem modifica&#231;&#245;es. Detalhes ser&#227;o fornecidos na
 213     <a href="developer/">documenta&#231;&#227;o do desenvolvedor</a>.</p>
 214   </section>
 215 </manualpage>