From a089aaf20249f4a9a3ffade6f1acb3ea353dd0a4 Mon Sep 17 00:00:00 2001 From: leonardolara Date: Mon, 9 Sep 2024 08:30:40 -0300 Subject: [PATCH] sync with en rev --- install/unix/apache2.xml | 440 ++++++++++++------------ language/enumerations.xml | 4 +- reference/array/functions/array-map.xml | 5 +- reference/gmp/book.xml | 9 +- reference/mysqlnd/config.xml | 6 +- 5 files changed, 229 insertions(+), 235 deletions(-) diff --git a/install/unix/apache2.xml b/install/unix/apache2.xml index 8c55842d5..c6e5b5e70 100644 --- a/install/unix/apache2.xml +++ b/install/unix/apache2.xml @@ -1,358 +1,358 @@ - - - Apache 2.0 em sistemas Unix - - Esta seção contém notas e dicas específicas para a instalação do PHP em Apache 2.x - em sistemas Unix. - + + + Apache 2.0 em sistemas Unix + + Esta seção contém notas e dicas específicas para a instalação do PHP no Apache 2.x + em sistemas Unix. + - &warn.apache2.compat; + &warn.apache2.compat; - - A documentação do Apache - é a fonte mais importante sobre o servidor Apache 2.x. - Mais informações sobre opções de instalação podem ser encontradas - lá. - + + A documentação do Apache + é a fonte mais importante sobre o servidor Apache 2.x. + Mais informações sobre opções de instalação podem ser encontradas + lá. + - - A versão mais recente do servidor Apache HTTP pode ser obtida do - site de download Apache, - e uma versão correspondente do PHP pode ser obtida dos locais mencionados anteriormente. - Esse guia rápido cobre apenas o básico para iniciar o Apache 2.x - e PHP. Para mais informações leia a - documentação do Apache. - Os números de versão estão omitidos aqui, para garantir que - as instruções não fiquem desatualizadas. Nos exemplos abaixo 'NN' deve - ser substituído com a versão específica do Apache utilizado. - + + A versão mais recente do servidor Apache HTTP pode ser obtida do + site de download Apache, + e uma versão correspondente do PHP pode ser obtida dos locais mencionados anteriormente. + Esse guia rápido cobre apenas o básico para iniciar o Apache 2.x + e PHP. Para mais informações leia a + documentação do Apache. + Os números de versão estão omitidos aqui, para garantir que + as instruções não fiquem desatualizadas. Nos exemplos abaixo 'NN' deve + ser substituído com a versão específica do Apache utilizado. + - - Atualmente há duas versões do Apache 2.x. - 2.4 e 2.2. - Embora haja razões para escolher entre elas, 2.4 é a versão mais - atual, e aquela recomendada, se essa opção lhe for - possível. Entretanto as instruções aqui funcionarão para - ambas as versões 2.4 e 2.2. Importante notar que o Apache httpd 2.2 está em End Of Life, - e nenhum novo desenvolvimento ou correções serão realizados nele. - + + Atualmente há duas versões do Apache 2.x. - 2.4 e 2.2. + Embora haja razões para escolher entre elas, 2.4 é a versão mais + atual, e aquela recomendada, se essa opção lhe for + possível. Entretanto as instruções aqui funcionarão para + ambas as versões 2.4 e 2.2. Importante notar que o Apache httpd 2.2 está no final de sua vida, + e nenhum novo desenvolvimento ou correções serão realizados nele. + - - - Obter o Apache HTTP do endereço acima e - descompactar: + + + Obter o Apache HTTP do endereço acima e + descompactar: - - + + - - - + + + - - Da mesma forma, obter e descompactar os fontes do PHP: + + Da mesma forma, obter e descompactar os fontes do PHP: - - + + - - - + + + - - - Compilar e instalar o Apache. Consulte a documentação de instalação do Apache - para mais detalhes/opções de compilação. - + + + Compilar e instalar o Apache. Consulte a documentação de instalação do Apache + para mais detalhes/opções de compilação. + - - + + - - - + + + - - - Você agora tem um Apache 2.x.NN disponível em /usr/local/apache2, + + + Agora existe um Apache 2.x.NN disponível em /usr/local/apache2, configurado com módulos carregáveis e o MPM prefork padrão. Para testar a instalação utilize o procedimento de inicialização do servidor Apache. Por exemplo: - + - + e depois pare o servidor para configurar o PHP: - + - + - - + + - + - -Agora configure e compile o PHP. Aqui você pode personalizar o PHP -com várias opções, por exemplo quais extensões estarão disponíveis. Rode -./configure --help para uma lista de opções disponíveis. Em nosso exemplo -nós iremos configurar apenas com suporte ao Apache 2 e MySQL. - + + Agora configure e compile o PHP. Aqui pode-se personalizar o PHP + com várias opções, por exemplo quais extensões estarão disponíveis. Execute + ./configure --help para uma lista de opções disponíveis. Em nosso exemplo, + iremos configurar apenas com suporte ao Apache 2 e MySQL. + - -Se você compilou o Apache a partir dos fontes como descrito acima os exemplos abaixo terão -caminhos coincidentes do apxs, mas se instalou de outra forma você terá de -ajustar o caminho para o apxs. Algumas distribuições renomeiam -apxs para apxs2. - - - + + Se o Apache foi compilado a partir do código-fonte como descrito acima, os exemplos abaixo terão + caminhos coincidentes do apxs, mas se foi instalado de outra forma, o caminho para o apxs + precisará ser ajustado. Algumas distribuições renomeiam + apxs para apxs2. + + + - - + + - - Se decidir modificar suas configurações depois da instalação você - terá de rodar novamente o configure, make e make install. - Terá também de - reiniciar o Apache para que o novo módulo seja carregado. Uma recompilação do + + Se for decidido modificar as configurações depois da instalação, + os comandos 'configure', 'make' e 'make install' precisarão ser executados novamente. + Além disso, + o Apache precisará ser reinicializado para que o novo módulo seja carregado. Uma recompilação do Apache não é necessária. - + - + Note que por padrão 'make install' também instalará o PEAR, - várias ferramentas do PHP como phpize, instalar o PHP CLI, entre outros. - + várias ferramentas do PHP como phpize, o PHP CLI, entre outros. + - + - - Configure seu php.ini: - + + Configure o php.ini: + - - + + - - + + - - Você pode editar seu arquivo .ini para configurar o PHP. Se preferir ter + + Pode-se de editar o arquivo .ini para configurar o PHP. Se for desejado ter um php.ini em outra localização, utilize --with-config-file-path=/some/path no passo 5. - + + + Se for preferível utilizar o php.ini-production, leia atentamente + esse arquivo, já que ele modifica o comportamento do PHP. + + + + + + + + Edite o httpd.conf para carregar o módulo do PHP. O caminho à direita + da instrução LoadModule precisa apontar para o caminho do módulo do PHP + no sistema. O 'make install' acima pode ter feito isso + automaticamente, mas é bom confirmar. + + + - Se preferir utilizar o php.ini-production leia atentamente - esse arquivo, dado que ele modifica o comportamento do PHP. + No PHP 8: - - - - - - - Edite seu httpd.conf para carregar o módulo do PHP. O caminho a direita - da instrução LoadModule precisa apontar para o caminho do módulo do PHP - em seu sistema. O 'make install' acima pode ter feito isso - por você, mas é bom confirmar. - - - - - No PHP 8: - - + - - + + - - - No PHP 7: - - + + + No PHP 7: + + - - + + - + - + - - Configure o Apache para interpretar certas extensões de arquivos do PHP. Por exemplo configurar - o Apache para interpretar arquivos .php. Em vez de utilizar apenas a diretiva Apache AddType + + Configure o Apache para interpretar certas extensões de arquivos do PHP. Por exemplo, configurar + o Apache para interpretar arquivos .php. Em vez de utilizar apenas a diretiva Apache AddType, é recomendado evitar uploads potencialmente perigosos e nomes de - arquivos como exploit.php.jpg de serem executados pelo PHP. Nesse exemplo - você pode ter qualquer extensão (ou extensões) configuradas. + arquivos como exploit.php.jpg que possam ser executados pelo PHP. Nesse exemplo, + pode-se ter qualquer extensão (ou extensões) configuradas. Adicionaremos .php como demonstração. - + - - + + SetHandler application/x-httpd-php ]]> - - + + - - Ou, pode-se acrescentar também .php, .php2, .php3, .php4, .php5, .php6 e + + Alternativamente, pode-se acrescentar também .php, .php2, .php3, .php4, .php5, .php6 e .phtml para ser executado como PHP, desta forma: - + - - + + SetHandler application/x-httpd-php ]]> - - + + - - Para permitir que arquivos .phps sejam interpretados pelo filtro de fontes do PHP e - exibidos como código fonte destacado, utilize isso: - + + Para permitir que arquivos .phps sejam interpretados pelo filtro de fontes do PHP e + exibidos como código fonte destacado, utilize isso: + - - + + SetHandler application/x-httpd-php-source ]]> - - + + - + mod_rewrite pode ser utilizado para permitir que qualquer arquivo .php seja exibido como código fonte destacado, sem ter de renomear ou copiar arquivos para a extensão .phps, assim: - - + + - - + + - + O filtro de fontes PHP não deve ser ativado em ambiente de produção, onde ele pode expor dados confidenciais ou de outra forma importantes, que estejam incluídos no código fonte. - + - + - + - Depois utilize a forma normal de iniciar o servidor Apache: + Depois utilize a forma normal de iniciar o servidor Apache: - + - - + + - ou + ou - + - - + + - - + + - - Seguindo os passos acima você terá um Apache2 rodando com - suporte ao PHP como um módulo SAPI. Existem muitas outras - opções de configuração disponíveis no Apache e PHP. Para mais - informações rode ./configure --help na código - fonte correspondente. - - - Apache pode ser construído com multithread através da seleção do MPM - worker, em vez do padrão MPM - prefork. Isso é possível - acrescentado-se o seguinte argumento no ./configure do - passo 3 acima: - - - + + Seguindo os passos acima, o Apache2 será executado com + suporte ao PHP como um módulo SAPI. Existem muitas outras + opções de configuração disponíveis para o Apache e para o PHP. Para mais + informações rode ./configure --help no código + fonte correspondente. + + + O Apache pode ser construído com multithread através da seleção do MPM + worker, em vez do padrão MPM + prefork. Isso é possível + acrescentado-se o seguinte argumento no ./configure do + passo 3 acima: + + + - - - - Isso não deve ser feito sem conhecer as consequências - dessa decisão, ou pelo menos ter uma boa noção de - suas implicações. A documentação do Apache - sobre MPM-Modules - discute essas questões em grandes detalhes. - - - - A Apache MultiViews - FAQ discute multiviews com o PHP. - - - - - Para construir uma versão multithread o sistema destino precisa suportar threads. - Nesse caso o PHP também deve ser compilado com o Zend Thread Safety (ZTS). - Nessa configuração nem todas as extensões estarão disponíveis. - A configuração recomendada é construir o Apache com o módulo MPM - prefork padrão. - - - + + + + Isso não deve ser feito sem conhecer as consequências + dessa decisão, ou pelo menos ter uma boa noção de + suas implicações. A documentação do Apache + sobre MPM-Modules + discute essas questões em grandes detalhes. + + + + A Apache MultiViews + FAQ discute multiviews com o PHP. + + + + + Para construir uma versão multithread o sistema destino precisa suportar threads. + Nesse caso o PHP também deve ser compilado com o Zend Thread Safety (ZTS). + Nessa configuração nem todas as extensões estarão disponíveis. + A configuração recomendada é construir o Apache com o módulo MPM + prefork padrão. + + + + Enumerações @@ -6,7 +6,7 @@ - Enumerações, ou "Enums" permitem um desenvolvedor definir um tipo personalizado que está limitado a um + Enumerações, ou "Enums", permitem que um desenvolvedor defina um tipo personalizado que está limitado a um número discreto de valores possíveis. Isso pode ser especialmente útil ao definir um modelo de domínio, pois permite "tornar estados inválidos irrepresentáveis." diff --git a/reference/array/functions/array-map.xml b/reference/array/functions/array-map.xml index 08b953caf..b95524852 100644 --- a/reference/array/functions/array-map.xml +++ b/reference/array/functions/array-map.xml @@ -1,5 +1,5 @@ - + array_map @@ -40,7 +40,8 @@ &null; pode ser passado como um valor para callback - para realizar uma operação zip em múltiplos arrays. + para realizar uma operação zip em múltiplos arrays e retornar um array + onde cada elemento é um array contendo os elementos dos arrays de entrada do mesmo índice (veja o exemplo abaixo). Se apenas array for fornecido, array_map retornará o array de entrada. diff --git a/reference/gmp/book.xml b/reference/gmp/book.xml index 81abcab9b..08f9b3bac 100644 --- a/reference/gmp/book.xml +++ b/reference/gmp/book.xml @@ -1,5 +1,5 @@ - + @@ -26,7 +26,7 @@ - A partir do PHP 5.6, os operadores + Os operadores aritméticos, binários e comparativos @@ -40,11 +40,6 @@ à força para o tipo float, resultando em perda de precisão. - - - Esta extensão está disponível em plataformas plataforma Windows. - - diff --git a/reference/mysqlnd/config.xml b/reference/mysqlnd/config.xml index 918fee78f..69c149606 100644 --- a/reference/mysqlnd/config.xml +++ b/reference/mysqlnd/config.xml @@ -1,5 +1,5 @@ - + &reftitle.runtime; @@ -248,9 +248,7 @@ d:t:x:O,/tmp/mysqlnd.trace - Este recurso está disponível apenas com uma compilação de depuração do PHP. Funciona - no Microsoft Windows se estiver usando uma compilação de depuração de PHP e o PHP foi - construído usando o Microsoft Visual C versão 9 ou superior. + Este recurso está disponível apenas com uma compilação de depuração do PHP.