<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/migration71.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'migration71.windows-support.php',
    1 => 'Suporte ao Windows',
    2 => 'Suporte ao Windows',
  ),
  'up' => 
  array (
    0 => 'migration71.php',
    1 => 'Migrando do PHP 7.0.x para o PHP 7.1.x',
  ),
  'prev' => 
  array (
    0 => 'migration71.other-changes.php',
    1 => 'Outras altera&ccedil;&otilde;es',
  ),
  'next' => 
  array (
    0 => 'migration70.php',
    1 => 'Migrando do PHP 5.6.x para o PHP 7.0.x',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'appendices/migration71/windows-support.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="migration71.windows-support" class="sect1">
 <h2 class="title">Suporte ao Windows</h2>

 <div class="sect2" id="migration71.windows-support.long-and-utf8-path">
  <h3 class="title">Suporte a caminhos longos e codificados em UTF-8</h3>
  <p class="para">
    Se uma aplicação web for UTF-8, nenhuma ação adicional é necessária. Para
    aplicações que dependam de caminhos em codificações que não sejam UTF-8 para E/S, uma
    diretiva INI explícita precisa ser definida. A verificação de configuração INI para codificação
    é baseada na seguinte ordem:
  </p>
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     internal_encoding
    </span>
   </li>
    <li class="listitem">
    <span class="simpara">
     default_charset
    </span>
   </li>
   <li class="listitem">
    <span class="simpara">
     zend.multibyte
    </span>
   </li>
  </ul>
  <p class="para">
    Várias funções para manipulação de página de código foram introduzidas:
  </p>
      <ul class="itemizedlist">
       <li class="listitem">
        <span class="simpara">
         sapi_windows_cp_set() para definir a página de código padrão
        </span>
       </li>
       <li class="listitem">
        <span class="simpara">
         sapi_windows_cp_get() para obter a página de código atual
        </span>
       </li>
       <li class="listitem">
        <span class="simpara">
         sapi_windows_cp_is_utf8() para verificar se a página de código é UTF-8
        </span>
       </li>
       <li class="listitem">
        <span class="simpara">
         sapi_windows_cp_conv() para converter entre páginas de código, usando assinatura compatível com iconv()
        </span>
       </li>
      </ul>
  <p class="para">
   Estas funções são seguras para threads.
  </p>
  <p class="para">
    A página de códigos de saída do console é ajustada dependendo da codificação usada no
    PHP. Dependendo da página real de códigos OEM do sistema, a saída visível
    pode ou não estar correta. Por exemplo, no cmd.exe padrão e em um
    sistema com a página de códigos OEM 437, as saídas nas páginas de códigos 1251, 1252, 1253
    e algumas outras podem ser mostradas corretamente ao usar UTF-8. No mesmo sistema,
    caracteres na página de códigos como 20932 provavelmente não serão mostrados corretamente.
    Isso se refere às regras específicas do sistema para página de código, compatibilidade de fontes e ao
    programa de console específico usado. O PHP define automaticamente a página de códigos
    do console de acordo com as regras de codificação do php.ini. Usar consoles alternativos
    em vez de cmd.exe diretamente pode trazer uma experiência melhor em alguns casos.
  </p>
  <p class="para">
    No entanto, esteja ciente de que a troca de página de código em tempo de execução após o início da solicitação
    pode trazer efeitos colaterais inesperados no CLI. A forma preferível é o php.ini.
    Quando o PHP CLI é usado em um emulador de console, que não suporta Unicode,
    isto pode ser necessário, para evitar a alteração da página de códigos do console. A
    melhor maneira de conseguir isso é definindo a codificação padrão ou interna para
    corresponder à página de códigos ANSI. Outro método é definir as diretivas INI
    output_encoding e input_encoding para a página de código necessária; nesse caso,
    entretanto, a diferença entre a página de código interna e de E/S provavelmente causará
    mojibake. Em casos raros, se o PHP falhar normalmente, a página de códigos original
    do console poderá não ser restaurada. Neste caso, o comando chcp
    pode ser usado para restaurá-lo manualmente.
  </p>
  <p class="para">
    Atenção especial para os sistemas DBCS - a mudança da página de código no tempo de execução
    usando <span class="function"><a href="function.ini-set.php" class="function">ini_set()</a></span> provavelmente causará problemas de exibição. A diferença para os
    sistemas não DBCS é que os caracteres estendidos exigem que duas células do console
    sejam exibidas. Em certos casos, apenas o mapeamento dos caracteres no
    conjunto de glifos da fonte poderia acontecer, sem nenhuma alteração real da fonte. Esta é a
    natureza dos sistemas DBCS, a maneira mais simples de evitar problemas de exibição é
    evitar o uso de <span class="function"><a href="function.ini-set.php" class="function">ini_set()</a></span> para a alteração da página de código.
  </p>
  <p class="para">
    Como resultado do suporte UTF-8 nos fluxos, os scripts PHP não estão mais limitados
    a nomes de arquivos ASCII ou ANSI. Isso é diretamente compatível com o CLI.
    Para outros SAPI, a documentação do servidor correspondente
    é útil.
  </p>
  <p class="para">
    O suporte a caminhos longos é transparente. Caminhos com mais de 260 bytes são
    automaticamente prefixados com <code class="literal">\\?\</code>. O comprimento máximo do caminho é limitado a
    2.048 bytes. Esteja ciente de que o limite do segmento do caminho (comprimento do nome base) ainda
    persiste.
  </p>
  <p class="para">
    Para a melhor portabilidade, é altamente recomendável gerenciar nomes de arquivos,
    E/S e outros tópicos relacionados com UTF-8. Além disso, para aplicativos de console,
    o uso de uma fonte TrueType é preferível e o uso de ini_set() para
    a troca da página de códigos é desencorajado.
  </p>
  <p class="para">
  </p>
  <p class="para">
  </p>
 </div>

 <div class="sect2" id="migration71.windows-support.readline">
  <h3 class="title">readline</h3>

  <p class="para">
   A <a href="book.readline.php" class="link">extensão readline</a> é suportada
   através da <a href="http://mingweditline.sourceforge.net/" class="link external">&raquo;&nbsp;biblioteca
   WinEditLine</a>. Assim, o shell <abbr title="Command Line Interpreter/Interface">CLI</abbr> interativo é
   também é suportado (<code class="literal">php.exe -a</code>).
  </p>
 </div>

 <div class="sect2" id="migration71.windows-support.php-fcgi-children">
  <h3 class="title">PHP_FCGI_CHILDREN</h3>
  <p class="para">
   <var class="varname">PHP_FCGI_CHILDREN</var> agora é respeitado. Se esta variável de ambiente for
   definida, o primeiro processo <var class="filename">php-cgi.exe</var> executará o número
   especificado de filhos. Eles compartilharão o mesmo soquete TCP.
  </p>
 </div>

 <div class="sect2" id="migration71.windows-support.ftok">
  <h3 class="title">ftok()</h3>
  <p class="para">
   Adicionado suporte para <span class="function"><a href="function.ftok.php" class="function">ftok()</a></span>
  </p>
 </div>

</div><?php manual_footer($setup); ?>