diff --git a/install/pie.xml b/install/pie.xml index cdd34d7cb..0554fd78f 100644 --- a/install/pie.xml +++ b/install/pie.xml @@ -1,5 +1,5 @@ - + Instalação do PIE e extensões de terceiros @@ -29,7 +29,7 @@ pie install mongodb/mongodb-extension - A documentação "PIE + A documentação "PIE Usage" aborda isso com mais detalhes. diff --git a/language/predefined/attributes/allowdynamicproperties.xml b/language/predefined/attributes/allowdynamicproperties.xml index a7c56957b..eacab39eb 100644 --- a/language/predefined/attributes/allowdynamicproperties.xml +++ b/language/predefined/attributes/allowdynamicproperties.xml @@ -18,6 +18,7 @@ + #[\Attribute] final AllowDynamicProperties diff --git a/language/predefined/attributes/attribute.xml b/language/predefined/attributes/attribute.xml index 55420de0b..ecb474b95 100644 --- a/language/predefined/attributes/attribute.xml +++ b/language/predefined/attributes/attribute.xml @@ -1,4 +1,4 @@ - + O atributo Attribute Attribute @@ -23,6 +23,7 @@ + #[\Attribute] final Attribute diff --git a/language/predefined/attributes/deprecated.xml b/language/predefined/attributes/deprecated.xml index 27b85ccb7..5464f7316 100644 --- a/language/predefined/attributes/deprecated.xml +++ b/language/predefined/attributes/deprecated.xml @@ -1,4 +1,4 @@ - + O atributo Deprecated Deprecated @@ -18,6 +18,7 @@ + #[\Attribute] final Deprecated diff --git a/language/predefined/attributes/override.xml b/language/predefined/attributes/override.xml index ad0ed2d47..be2835444 100644 --- a/language/predefined/attributes/override.xml +++ b/language/predefined/attributes/override.xml @@ -1,4 +1,4 @@ - + O atributo Override Override @@ -29,6 +29,7 @@ + #[\Attribute] final Override diff --git a/language/predefined/attributes/returntypewillchange.xml b/language/predefined/attributes/returntypewillchange.xml index 433a9642a..fcfe72503 100644 --- a/language/predefined/attributes/returntypewillchange.xml +++ b/language/predefined/attributes/returntypewillchange.xml @@ -1,4 +1,4 @@ - + O atributo ReturnTypeWillChange ReturnTypeWillChange @@ -23,6 +23,7 @@ + #[\Attribute] final ReturnTypeWillChange diff --git a/language/predefined/attributes/sensitiveparameter.xml b/language/predefined/attributes/sensitiveparameter.xml index 36a84105e..9e6961daf 100644 --- a/language/predefined/attributes/sensitiveparameter.xml +++ b/language/predefined/attributes/sensitiveparameter.xml @@ -1,4 +1,4 @@ - + O atributo SensitiveParameter SensitiveParameter @@ -19,6 +19,7 @@ + #[\Attribute] final SensitiveParameter diff --git a/language/predefined/php-incomplete-class.xml b/language/predefined/php-incomplete-class.xml index c4b99e5bc..bd927419e 100644 --- a/language/predefined/php-incomplete-class.xml +++ b/language/predefined/php-incomplete-class.xml @@ -1,5 +1,5 @@ - + A classe __PHP_Incomplete_Class @@ -28,6 +28,7 @@ + #[\AllowDynamicProperties] final __PHP_Incomplete_Class diff --git a/language/predefined/stdclass.xml b/language/predefined/stdclass.xml index 964c6e5fb..194ef7959 100644 --- a/language/predefined/stdclass.xml +++ b/language/predefined/stdclass.xml @@ -1,5 +1,5 @@ - + A classe stdClass @@ -42,6 +42,7 @@ + #[\AllowDynamicProperties] stdClass diff --git a/language/types/array.xml b/language/types/array.xml index 7b36df022..68df68e65 100644 --- a/language/types/array.xml +++ b/language/types/array.xml @@ -1,8 +1,12 @@ - + Arrays + + Para uma lista de todas as funções de array, consulte o capítulo sobre funções de array na documentação. + + Um array no PHP é na verdade um mapa ordenado. Um mapa é um tipo que relaciona valores a chaves. Este tipo diff --git a/reference/array/functions/array-key-exists.xml b/reference/array/functions/array-key-exists.xml index 4eefb89d1..14451e398 100644 --- a/reference/array/functions/array-key-exists.xml +++ b/reference/array/functions/array-key-exists.xml @@ -1,5 +1,5 @@ - + array_key_exists @@ -69,6 +69,12 @@ + + 8.5.0 + + Usar null no parâmetro key foi descontinuado, use uma string vazia no lugar. + + 8.0.0 diff --git a/reference/dir/directory.xml b/reference/dir/directory.xml index 1a6d8b790..08c3ec98f 100644 --- a/reference/dir/directory.xml +++ b/reference/dir/directory.xml @@ -1,5 +1,5 @@ - + A classe Directory @@ -23,6 +23,7 @@ + final Directory @@ -91,6 +92,12 @@ As propriedades path e handle agora são somente-leitura. + + 8.5.0 + + A class agora é final. + + diff --git a/reference/mongodb/configure.xml b/reference/mongodb/configure.xml index c23974b09..c75a9ba6e 100644 --- a/reference/mongodb/configure.xml +++ b/reference/mongodb/configure.xml @@ -1,9 +1,25 @@ - +
&reftitle.install; +
+ Instalando a extensão MongoDB PHP com PIE + + &pecl.moving.to.pie; + + + Para instalar a extensão MongoDB usando PIE, execute o seguinte comando: + + + + + +
+
Instalando a extensão MongoDB PHP com PECL diff --git a/reference/mongodb/setup.xml b/reference/mongodb/setup.xml index 0d6f19ab5..26224e4c2 100644 --- a/reference/mongodb/setup.xml +++ b/reference/mongodb/setup.xml @@ -1,5 +1,5 @@ - + &reftitle.setup; @@ -7,7 +7,7 @@
&reftitle.required; - A partir da versão 1.16.0, a extensão requer PHP 7.2 ou superior. Versões + A partir da versão 1.21.0, a extensão requer PHP 8.1 ou superior. Versões anteriores da extensão permitem compatibilidade com versões mais antigas do PHP. diff --git a/reference/network/functions/setcookie.xml b/reference/network/functions/setcookie.xml index 4a1222834..c6c25b60a 100644 --- a/reference/network/functions/setcookie.xml +++ b/reference/network/functions/setcookie.xml @@ -1,5 +1,5 @@ - + setcookie @@ -18,27 +18,27 @@ boolsecure&false; boolhttponly&false; - Assinatura alternativa disponível a partir do PHP 7.3.0 (sem suporte a parâmetros nomeados): + Assinatura alternativa disponível a partir do PHP 7.3.0 (sem suporte a parâmetros nomeados): boolsetcookie stringname stringvalue"" arrayoptions[] - + A função setcookie define um cookie para ser enviado juntamente com os cabeçalhos HTTP. Como outros cabeçalhos, os cookies devem ser enviados antes de qualquer saída do script (isso é - uma restrição do protocolo). Isso significa que as chamadas a essa função devem ser colocadas antes de qualquer + uma restrição do protocolo). Isso requer que esta função seja chamada antes de qualquer saída, incluindo as tags <html> e <head>, assim como espaços em branco. - - + + Uma vez que os cookies foram definidos, eles podem ser acessados no próximo carregamento da página através do array $_COOKIE. Os valores dos cookies também podem existir no array $_REQUEST. - + @@ -51,26 +51,26 @@ name - + O nome do cookie. - + value - + O valor do cookie. Esse valor é armazenado no computador do cliente; não deve ser armazenada informação sensível. Supondo que o name seja 'cookiename', o valor pode ser lido através de $_COOKIE['cookiename'] - + expires_or_options - + O tempo para o cookie expirar. Esse valor é um timestamp Unix, portanto é o número de segundos desde a época Unix. Uma maneira de configurar esse valor é adicionando o número de segundos em que o cookie deve @@ -80,23 +80,21 @@ Outra opção é usar a função mktime. Se configurado para 0 ou omitido, o cookie vai expirar no final da sessão (quando o navegador fechar). - - - - - O parâmetro expires_or_options recebe - uma timestamp Unix, ao contrário do formato de data Wdy, - DD-Mon-YYYY HH:MM:SS GMT, isso acontece porque o PHP faz essa - conversão internamente. - - - + + + + O parâmetro expires_or_options recebe + um timestamp Unix, ao contrário do formato de data Wdy, DD-Mon-YYYY + HH:MM:SS GMT, isso acontece porque o PHP faz essa conversão + internamente. + + path - + O caminho no servidor onde o cookie estará disponível. Se configurado para '/', o cookie estará disponível para todo o domain. Se configurado para o diretório @@ -105,44 +103,44 @@ /foo/bar/ do domain. O valor padrão é o diretório atual onde o cookie está sendo configurado. - + domain - + O (sub)domínio para qual o cookie estará disponível. Definindo para um subdomínio (como 'www.example.com') deixará o cookie disponível para aquele subdomínio e todos os outros sub-domínios abaixo dele (exemplo w2.www.example.com). Para deixar o cookie disponível para todo o domínio (incluindo todos os subdomínios dele), basta definir o valor para o nome do domínio ('example.com', nesse caso). - - + + Navegadores antigos ainda implementam a RFC 2109 e podem requerer um . no início para funcionar com todos os subdomínios. - + secure - + Indica que o cookie só poderá ser transmitido sob uma conexão segura HTTPS do cliente. Quando configurado para &true;, o cookie será enviado somente se uma conexão segura existir. No lado do servidor, fica por conta do programador enviar esse tipo de cookie somente sob uma conexão segura (ex respeitando $_SERVER["HTTPS"]). - + httponly - + Quando for &true;, o cookie será acessível somente sob o protocolo HTTP. Isso significa que o cookie não será acessível por linguagens de script, como JavaScript. É dito que essa configuração pode ajudar a @@ -150,13 +148,13 @@ (entretanto ela não é suportada por todos os navegadores), mas essa informação é constantemente discutida. Foi adicionada no PHP 5.2.0. &true; ou &false; - + options - + Um array associativo que pode ter qualquer uma das chaves expires, path, domain, secure, httponly e samesite. @@ -169,15 +167,20 @@ mesmos valores padrão dos parâmetros explícitos. Se samesite for omitido, o atributo SameSite do cookie não será atribuído. - - - - - Para definir um cookie que inclui atributos que não estão entre as chaves listadas, - use a função header. - - - + + + + Para definir um cookie que inclui atributos que não estão entre as chaves listadas, + use a função header. + + + + + Se samesite for igual a "None" então + secure também precisa ser habilitado senão o cookie será + bloqueado pelo cliente. + + @@ -186,81 +189,83 @@ &reftitle.returnvalues; - + Se houver saída antes da chamada dessa função, setcookie irá falhar e retornará &false;. Se a função setcookie for executada com sucesso, ela retornará &true;. Isso não indica que o usuário aceitou o cookie. - + &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 8.2.0 - - O formato de data do cookie agora é 'D, d M Y H:i:s \G\M\T'; - anteriormente era 'D, d-M-Y H:i:s T'. - - - - 7.3.0 - - Uma assinatura alternativa para suportar o array options - foi adicionado. Essa assinatura também permite configurar o atributo - SameSite do cookie. - - - - - - + + + + + &Version; + &Description; + + + + + 8.2.0 + + O formato de data do cookie agora é 'D, d M Y H:i:s \G\M\T'; + anteriormente era 'D, d-M-Y H:i:s T'. + + + + 7.3.0 + + Uma assinatura alternativa para suportar o array options + foi adicionado. Essa assinatura também permite configurar o atributo + SameSite do cookie. + + + + + &reftitle.examples; - - Os exemplos a seguir demonstram algumas formas de enviar cookies. - - Exemplo de <function>setcookie</function> para enviar cookies - - + Os efeitos dos exemplos a seguir podem ser observados usando a lista de cookies + da ferramenta de desenvolvedor do navegador (normalmente na aba de Armazenamento ou Aplicação). + + + Exemplo de <function>setcookie</function> para enviar cookies + + ]]> - - - - - Note que a porção do valor do cookie será automaticamente codificada em - URL quando o cookie for enviado, e quando ele for recebido, será - automaticamente decodificado e atribuído a uma variável com o mesmo nome do - cookie. Se esta não for a intenção, pode ser utilizada em seu lugar a - função setrawcookie. Para ver - o conteúdo do cookie de teste em um script, simplesmente - utilize um dos exemplos abaixo: - - - - - + + + Observe que a porção do valor do cookie será automaticamente codificada em + URL e decodificada pelo PHP. Isto pode ser evitado usando + setrawcookie em seu lugar. + + + Para ver o conteúdo dos cookies definidos no exemplo acima em uma requisição + posterior: + + + + ]]> - - - - - - Exemplo de <function>setcookie</function> para apagar cookies - - Quando um cookie estiver sendo excluído, deve-se garantir que a data de - expiração dele está no passado, para acionar o mecanismo de remoção no navegador. - O exemplo a seguir mostra como excluir os cookies enviados no exemplo anterior: - - - + + + Exemplo de <function>setcookie</function> para apagar cookies + + Para excluir um cookie, defina a data de expiração para uma data no passado + (porém diferente de zero, que é reservado para cookies de sessão). + + + Para excluir os cookies definidos no exemplo anterior: + + + ]]> - - - - - - <function>setcookie</function> e arrays - - Cookies de array também podem ser enviados, utilizando a notação de array - no nome dele. Isso tem o efeito de enviar tantos cookies quantos - elementos houver no array, mas quando o cookie for recebido pelo - script, os valores serão todos colocados em um array com o nome do - cookie: - - - + + + <function>setcookie</function> e arrays + + "Arrays de cookies" podem ser definidos usando a notação de array + no nome do cookie. Isso tem o efeito de definir tantos cookies quantos + elementos houver no array, mas quando o cookie for recebido pelo + script, os valores serão todos colocados em um array com o nome do + cookie: + + + $valor) { $nome = htmlspecialchars($nome); @@ -319,38 +322,37 @@ if (isset($_COOKIE['cookie'])) { } ?> ]]> - - &example.outputs; - - + &example.outputs; + + - - - - - Utilizar caracteres como [ e ] - no nome do cookie não é válido conforme a RFC 6265, seção 4, mas deve - ser suportado por navegadores conforme a RFC 6265, seção 5. - - - + + + + + Utilizar caracteres como [ e ] + no nome do cookie não é válido conforme a RFC 6265, seção 4, mas deve + ser suportado por navegadores conforme a RFC 6265, seção 5. + + &reftitle.notes; - - Você pode utilizar o buffer de saída para enviar a saída antes de - chamar essa função, com o custo de toda a saída para o - navegador ser armazenada em buffer no servidor até que seja enviada. Isso pode ser feito + + Buffer de saída pode ser usado para permitir saída do script antes de + chamar essa função. Toda a saída será armazenada em buffer até que seja enviada + (explicitamente ou ao final da execução do script). Isso é feito chamando ob_start e ob_end_flush no script, ou configurando a diretiva output_buffering no - &php.ini; ou em arquivos de configuração do servidor. - + &php.ini; ou nos arquivos de configuração do servidor. + Problemas comuns: @@ -377,19 +379,18 @@ um : cookieum - Quando um cookie for configurado com o valor &false;, será realizada uma tentativa de - excluir o cookie. Portanto, evite utilizar valores booleanos. No lugar deles, - utilize 0 para &false; e 1 para &true;. + Quando um cookie for configurado com o valor &false;, será realizada uma tentativa de excluí-lo. + Por isso, valores booleanos não devem ser usados. No lugar deles, utilize 0 para &false; + e 1 para &true;. - Nomes de cookies podem ser configurados como arrays e estarão disponíves - para os scripts PHP como arrays, mas cookies separados serão armazenados - no sistema do usuário. Deve ser considerado utilizar explode - para enviar um cookie com nomes e valores múltiplos. Não é recomendado o - uso da função serialize para esse propósito, pois - pode resultar em furos de segurança. + Nomes de cookies podem ser definidos como nomes de arrays e estarão disponíves para + os scripts PHP como arrays, mas cookies separados serão armazenados pelo navegador. + Considere utilizar json_encode para definir um cookie com nomes e + valores múltiplos. Não é recomendado usar serialize + para esse propósito pois pode resultar em furos de segurança. @@ -401,15 +402,13 @@ um : cookieum &reftitle.seealso; - - - header - setrawcookie - Seção de cookies - RFC 6265 - RFC 2109 - - + + header + setrawcookie + Seção de cookies + RFC 6265 + RFC 2109 + diff --git a/reference/pdo/pdo/quote.xml b/reference/pdo/pdo/quote.xml index 4cecd1793..05f5a8700 100644 --- a/reference/pdo/pdo/quote.xml +++ b/reference/pdo/pdo/quote.xml @@ -1,5 +1,5 @@ - + PDO::quote @@ -16,8 +16,8 @@ - PDO::quote coloca aspas na string de entrada (se - necessário) e escapa caracteres especiais dentro da string de entrada, usando um + PDO::quote coloca aspas na string de entrada + e escapa caracteres especiais dentro da string de entrada, usando um estilo de aspas (ex.: simples ou duplas) apropriado ao driver subjacente. diff --git a/reference/reflection/reflectionconstant.xml b/reference/reflection/reflectionconstant.xml index fd1768b35..55d52f45b 100644 --- a/reference/reflection/reflectionconstant.xml +++ b/reference/reflection/reflectionconstant.xml @@ -1,4 +1,4 @@ - + A classe ReflectionConstant ReflectionConstant @@ -17,7 +17,6 @@ - final ReflectionConstant @@ -59,6 +58,28 @@
+
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.5.0 + + A classe não é mais final. + + + + + +
+
&reftitle.seealso; diff --git a/reference/uodbc/functions/odbc-connect.xml b/reference/uodbc/functions/odbc-connect.xml index 01b4d4b51..a5769e059 100644 --- a/reference/uodbc/functions/odbc-connect.xml +++ b/reference/uodbc/functions/odbc-connect.xml @@ -1,5 +1,5 @@ - + odbc_connect @@ -12,7 +12,7 @@ Odbc\Connectionfalseodbc_connect stringdsn stringnulluser&null; - stringnullpassword&null; + #[\SensitiveParameter]stringnullpassword&null; intcursor_optionSQL_CUR_USE_DRIVER diff --git a/reference/uodbc/functions/odbc-pconnect.xml b/reference/uodbc/functions/odbc-pconnect.xml index fecbebf99..538d22023 100644 --- a/reference/uodbc/functions/odbc-pconnect.xml +++ b/reference/uodbc/functions/odbc-pconnect.xml @@ -1,5 +1,5 @@ - + odbc_pconnect @@ -12,7 +12,7 @@ Odbc\Connectionfalseodbc_pconnect stringdsn stringnulluser&null; - stringnullpassword&null; + #[\SensitiveParameter]stringnullpassword&null; intcursor_optionSQL_CUR_USE_DRIVER