Correções, sincronizações.

This commit is contained in:
André L F S Bacci
2023-07-04 10:17:18 -03:00
parent b156db1e2a
commit 9d7210ee29
6 changed files with 52 additions and 46 deletions

View File

@@ -45,7 +45,7 @@
configuração INI <link linkend="ini.session.serialize-handler">session.serialize_handler</link>
depois que a requisição terminar. Variáveis registradas que estejam indefinidas são
marcadas como não definidas. Nos acessos subsequentes, elas não são definidas
pelo módulo da sessão, a menos que o usuário as definam posteriormente.
pelo módulo da sessão, a menos que o usuário as definam posteriormente.
</para>
<warning>
<para>
@@ -85,7 +85,7 @@
&reference.session.sessionhandlerinterface;
&reference.session.sessionidinterface;
&reference.session.sessionupdatetimestamphandlerinterface;
</book>
<!-- Keep this comment at the end of the file
@@ -108,3 +108,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -76,3 +76,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -131,9 +131,9 @@ unset($_SESSION['count']);
URIs relativas serão alteradas automaticamente para conter o ID da sessão.
<note>
<para>
O <link linkend="ini.arg-separator.output">arg_separator.output</link>,
diretiva &php.ini;, permite configurar o separador de argumentos. Para completa
conformidade com XHTML, especifique &amp;amp; aqui.
O <link linkend="ini.arg-separator.output">arg_separator.output</link>,
diretiva &php.ini;, permite configurar o separador de argumentos. Para completa
conformidade com XHTML, especifique &amp;amp; aqui.
</para>
</note>
</para>
@@ -181,7 +181,7 @@ aqui</a>.
<para>
Mostrar o <constant>SID</constant>, como mostrado acima, não é necessário se
<link linkend="ini.session.use-trans-sid">
--enable-trans-sid</link> foi usado para compilar o PHP.
--enable-trans-sid</link> foi usado para compilar o PHP.
</para>
<note>
<para>
@@ -217,23 +217,23 @@ aqui</a>.
<link linkend="ini.session.save-handler">session.save_handler</link>.
</para>
<para>
Quando a sessão inicia, o PHP internamente executa o manipulador <parameter>open</parameter> seguido pelo
callback <parameter>read</parameter> que deve retornar uma string codificada exatamente como foi originalmente
passado para armazenamento. Após o <parameter>read</parameter> retornar a string codificada, o PHP vai
decodificá-la e colocar o array resultante na super global <varname>$_SESSION</varname>.
Quando a sessão inicia, o PHP internamente executa o manipulador <parameter>open</parameter> seguido pelo
callback <parameter>read</parameter> que deve retornar uma string codificada exatamente como foi originalmente
passado para armazenamento. Após o <parameter>read</parameter> retornar a string codificada, o PHP vai
decodificá-la e colocar o array resultante na super global <varname>$_SESSION</varname>.
</para>
<para>
Quando o PHP é encerrado (ou quando <function>session_write_close</function> for chamada),
o PHP internamente vai codificar a super global <varname>$_SESSION</varname> e passá-la
junto com o ID de sessão para o callback <parameter>write</parameter>.
Depois que o callback <parameter>write</parameter> finalizar, o PHP internamente invocará o
callback <parameter>close</parameter>.
Quando o PHP é encerrado (ou quando <function>session_write_close</function> for chamada),
o PHP internamente vai codificar a super global <varname>$_SESSION</varname> e passá-la
junto com o ID de sessão para o callback <parameter>write</parameter>.
Depois que o callback <parameter>write</parameter> finalizar, o PHP internamente invocará o
callback <parameter>close</parameter>.
</para>
<para>
Quando uma sessão é destruída, o PHP chamará o manipulador <parameter>destroy</parameter> com
o ID de sessão.
</para>
<para>
<para>
O PHP executará o callback <parameter>gc</parameter> de tempo em tempo para
apagar quaisquer informações na sessão de acordo com o tempo de vida máximo (lifetime) definido para a sessão.
Esta rotina deve apagar todas as informações do armazenamento persistente em que
@@ -262,3 +262,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -90,7 +90,7 @@
</row>
<row>
<entry><link linkend="ini.session.cookie-httponly">session.cookie_httponly</link></entry>
<entry>""</entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Antes do PHP 7.2.0, o padrão era <literal>""</literal>.</entry>
</row>
@@ -206,7 +206,7 @@
<entry><link linkend="ini.session.lazy-write">session.lazy_write</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Disponível desde o PHP 7.0.0.</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.session.hash-function">session.hash_function</link></entry>
@@ -252,10 +252,10 @@
<simpara>
<literal>session.save_handler</literal> define o nome do
manipulador que será utilizado para armazenar e recuperar dados
associados à sessão. Padrão para
associados à sessão. Padrão para
<literal>files</literal>. Note que extensões podem registrar seus
próprios <literal>save_handler</literal>s; manipuladores registrados podem
ser obtidos ao se vefificar o
ser obtidos ao se vefificar o
<function>phpinfo</function>. Veja também
<function>session_set_save_handler</function>.
</simpara>
@@ -272,7 +272,7 @@
<literal>session.save_path</literal> define o argumento que
é passado para o manipulador de gravação. Se você escolher o manipulador padrão (de
arquivos), este é o caminho onde os arquivos serão criados. Veja também
<function>session_save_path</function>.
<function>session_save_path</function>.
</simpara>
<para>
Há um argumento opcional <literal>N</literal> para esta diretiva que determina
@@ -285,10 +285,10 @@
<filename>ext/session</filename> para fazer isto, chamado
<filename>mod_files.sh</filename>, com uma versão para o Windows chamada
<filename>mod_files.bat</filename>. Também note que se <literal>N</literal> é
usado e maior do que 0 então a limpeza de sessões não
usado e maior do que 0 então a limpeza de sessões não
será executada, veja uma cópia do &php.ini; para mais
informações. Também, se você usar <literal>N</literal>, certifique-se de cercar
<literal>session.save_path</literal> com
<literal>session.save_path</literal> com
"aspas" porque o separador (<literal>;</literal>) é
usado também para comentátios no &php.ini;.
</para>
@@ -338,7 +338,7 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.session.auto-start">
<term>
<parameter>session.auto_start</parameter>
@@ -387,10 +387,10 @@
</term>
<listitem>
<simpara>
<literal>session.gc_probability</literal> em conjunto com
<literal>session.gc_probability</literal> em conjunto com
<literal>session.gc_divisor</literal> é usado para gerenciar a probabilidade
que o gc (coletor de lixo) seja iniciado.
O padrão é <literal>1</literal>. Veja <link
O padrão é <literal>1</literal>. Veja <link
linkend="ini.session.gc-divisor">session.gc_divisor</link> para detalhes.
</simpara>
</listitem>
@@ -449,7 +449,7 @@
</term>
<listitem>
<simpara>
<literal>session.referer_check</literal> contém a
<literal>session.referer_check</literal> contém a
substring que você quer checar contra cada HTTP Referer. Se o
Referer for enviado pelo cliente e a substring não foi
encontrada, a id de sessão embutida será marcada como inválida.
@@ -467,7 +467,7 @@
<simpara>
<literal>session.entropy_file</literal> informa o caminho para um
recurso externo (arquivo) que será usado como uma fonte
de entropia no processo de criação da id de sessão. Exemplos são
de entropia no processo de criação da id de sessão. Exemplos são
<literal>/dev/random</literal> ou <literal>/dev/urandom</literal>
que estão disponíveis em muitos sistemas UNIX.
</simpara>
@@ -475,7 +475,7 @@
Este recurso é suportado no Windows. Configurando
<literal>session.entropy_length</literal> para um valor diferente de zero
fará o PHP utilizar o Windows Random API como fonte de entropia.
</simpara>
</simpara>
<note>
<simpara>
Removido no PHP 7.1.0.
@@ -500,9 +500,9 @@
de bytes que serão lidos do arquivo especificado
acima. Padrão em <literal>0</literal> (desabilitado).
</simpara>
<simpara>
<simpara>
Removido no PHP 7.1.0.
</simpara>
</simpara>
</listitem>
</varlistentry>
@@ -582,7 +582,7 @@
<simpara>
<literal>session.cookie_lifetime</literal> especifica o tempo de vida do
cookie em segundos que é enviado para o browser. O valor 0
significa "até o browser ser fechado". O padrão é
significa "até o browser ser fechado". O padrão é
<literal>0</literal>. Veja também
<function>session_get_cookie_params</function> e
<function>session_set_cookie_params</function>.
@@ -592,7 +592,7 @@
O timestamp de expiração é informado em relação à hora do servidor, que
não necessariamente coincide com o horário do navegador do cliente.
</simpara>
</note>
</note>
</listitem>
</varlistentry>
@@ -635,7 +635,7 @@
<listitem>
<simpara>
<literal>session.cookie_secure</literal> especifica se os
cookies devem ser enviados apenas em conexões seguras. O padrão é
cookies devem ser enviados apenas em conexões seguras. O padrão é
<literal>off</literal>.
Veja também
<function>session_get_cookie_params</function> e
@@ -690,9 +690,9 @@
<literal>session.cache_limiter</literal> especifica o método de
controle de cache para usar em páginas de sessão.
Pode ser um dos seguintes valores:
<literal>nocache</literal>, <literal>private</literal>,
<literal>nocache</literal>, <literal>private</literal>,
<literal>private_no_expire</literal> ou <literal>public</literal>.
Padrão <literal>nocache</literal>. Veja também a documentação de
Padrão <literal>nocache</literal>. Veja também a documentação de
<function>session_cache_limiter</function> para
ver o que os valores significam.
</simpara>
@@ -722,7 +722,7 @@
</term>
<listitem>
<simpara>
<literal>session.use_trans_sid</literal> se o suporte a
<literal>session.use_trans_sid</literal> se o suporte a
sid transparente está habilitado ou não. O padrão é
<literal>0</literal> (desabilitado).
</simpara>
@@ -744,7 +744,7 @@
</note>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.session.trans-sid-tags">
<term>
<parameter>session.trans_sid_tags</parameter>
@@ -754,7 +754,7 @@
<simpara>
<literal>session.trans_sid_tags</literal> especifica quais tags HTML
serão reescritas para incluir IDs de sessão quando o suporte ao SID transparente
estiver ativo. Por padrão:
estiver ativo. Por padrão:
<literal>a=href,area=href,frame=src,input=src,form=</literal>
</simpara>
<simpara>
@@ -764,7 +764,7 @@
<note>
<simpara>
Antes do PHP 7.1.0 <link linkend="ini.url-rewriter.tags">url_rewriter.tags</link>
era utilizada para essa funcionalidade. Desde o PHP 7.1.0, <literal>fieldset</literal>
era utilizada para essa funcionalidade. Desde o PHP 7.1.0, <literal>fieldset</literal>
não é mais considerada uma tag especial.
</simpara>
</note>
@@ -803,7 +803,8 @@
40, etc. IDs de sessão maiores são mais difíceis de adivinhar. Ao menos 32 letras
é o recomendados.
</simpara>
<para>
<tip>
<para>
Nota de compatibilidade: Utilize 32 para que
<literal>session.hash_func</literal>=0 (MD5) e
<literal>session.hash_bits_per_character</literal>=4,
@@ -817,7 +818,8 @@
se esqueça de configurar o valor apropriado em
<literal>session.sid_bits_per_character</literal>, de outra forma
você terá um ID de sessão fraco.
</para>
</para>
</tip>
<note>
<simpara>
Esta configuração foi introduzida no PHP 7.1.0.
@@ -876,7 +878,7 @@
</note>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.session.hash-bits-per-character">
<term>
<parameter>session.hash_bits_per_character</parameter>
@@ -896,7 +898,7 @@
</note>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.session.upload-progress.enabled">
<term>
<parameter>session.upload_progress.enabled</parameter>
@@ -936,7 +938,7 @@
<listitem>
<simpara>
Um prefixo utilizado na chave da variável <varname>$_SESSION</varname>.
Essa chave será concatenada com o valor de
Essa chave será concatenada com o valor de
<literal>$_POST[ini_get("session.upload_progress.name")]</literal> para
prover um índice único.
</simpara>

View File

@@ -151,3 +151,4 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -26,7 +26,7 @@
arquivos, bons ou ruins, ou fazer transações de bancos de dados, boas ou ruins.
</simpara>
<simpara>
Um erro freqüente de segurança feito até esse ponto é permitir ao Apache
Um erro frequente de segurança feito até esse ponto é permitir ao Apache
permissões de administrador (root), ou aumentar as habilidades do Apache
de qualquer outra forma.
</simpara>