Sophie

Sophie

distrib > Mandriva > 2008.1 > i586 > by-pkgid > 703d980c580707c382b4e43e25965bc5 > files > 9571

php-manual-pt_BR-5.2.4-1mdv2008.1.noarch.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>session_start</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Manual do PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="Funções de manpulação de Sessões"
HREF="ref.session.html"><LINK
REL="PREVIOUS"
TITLE="session_set_save_handler"
HREF="function.session-set-save-handler.html"><LINK
REL="NEXT"
TITLE="session_unregister"
HREF="function.session-unregister.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Manual do PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.session-set-save-handler.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.session-unregister.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.session-start"
></A
>session_start</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN204118"
></A
><P
>    (PHP 4, PHP 5)</P
>session_start&nbsp;--&nbsp;Inicia dados de sessão</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN204121"
></A
><H2
>Descrição</H2
>bool <B
CLASS="methodname"
>session_start</B
> ( void  )<BR
></BR
><P
>&#13;     <B
CLASS="function"
>session_start()</B
> cria uma sessão (ou resume
      a sessão atual baseada numa id de sessão sendo passada via 
      uma variável GET ou um cookie).
    </P
><P
>&#13;     Esta função sempre retorna <TT
CLASS="constant"
><B
>TRUE</B
></TT
>.
    </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
      Se você está usando sessões baseadas em cookie, você deve chamar
      <B
CLASS="function"
>session_start()</B
> antes de qualquer coisa ser exibida
      para o navegador.
     </P
></BLOCKQUOTE
></DIV
><P
>&#13;     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN204135"
></A
><P
><B
>Exemplo 1. Um exemplo de seção: <TT
CLASS="filename"
>page1.php</TT
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">// page1.php<br /><br /></font><font color="#0000BB">session_start</font><font color="#007700">();<br /><br />echo </font><font color="#DD0000">'Bem vindo a pagina #1'</font><font color="#007700">;<br /><br /></font><font color="#0000BB">$_SESSION</font><font color="#007700">[</font><font color="#DD0000">'favcolor'</font><font color="#007700">] = </font><font color="#DD0000">'green'</font><font color="#007700">;<br /></font><font color="#0000BB">$_SESSION</font><font color="#007700">[</font><font color="#DD0000">'animal'</font><font color="#007700">]&nbsp;&nbsp;&nbsp;= </font><font color="#DD0000">'cat'</font><font color="#007700">;<br /></font><font color="#0000BB">$_SESSION</font><font color="#007700">[</font><font color="#DD0000">'time'</font><font color="#007700">]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;= </font><font color="#0000BB">time</font><font color="#007700">();<br /><br /></font><font color="#FF8000">// Funciona se o cookie de seção foi aceito<br /></font><font color="#007700">echo </font><font color="#DD0000">'&lt;br /&gt;&lt;a href="page2.php"&gt;page 2&lt;/a&gt;'</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// Ou talves passando o ID da seção se necessário<br /></font><font color="#007700">echo </font><font color="#DD0000">'&lt;br /&gt;&lt;a href="page2.php?' </font><font color="#007700">. </font><font color="#0000BB">SID </font><font color="#007700">. </font><font color="#DD0000">'"&gt;page 2&lt;/a&gt;'</font><font color="#007700">;<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     Após ver <TT
CLASS="filename"
>page1.php</TT
>, a segunda pagina
     <TT
CLASS="filename"
>page2.php</TT
> irá magicamente conter os dados da seção.
     Leia <A
HREF="ref.session.html"
>Uso de seções</A
>
     para informações sobre <A
HREF="ref.session.html#session.idpassing"
>propagando
     ids de seções</A
> já que, por exemplo, explica tudo sobre a constante
     <TT
CLASS="constant"
><B
>SID</B
></TT
>.
    </P
><P
>&#13;     <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN204146"
></A
><P
><B
>Exemplo 2. Um exemplo de seção: <TT
CLASS="filename"
>page2.php</TT
></B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><code><font color="#000000">
<font color="#0000BB">&lt;?php<br /></font><font color="#FF8000">// page2.php<br /><br /></font><font color="#0000BB">session_start</font><font color="#007700">();<br /><br />echo </font><font color="#DD0000">'Bem vindo a pagina #2&lt;br /&gt;'</font><font color="#007700">;<br /><br />echo </font><font color="#0000BB">$_SESSION</font><font color="#007700">[</font><font color="#DD0000">'favcolor'</font><font color="#007700">]; </font><font color="#FF8000">// green<br /></font><font color="#007700">echo </font><font color="#0000BB">$_SESSION</font><font color="#007700">[</font><font color="#DD0000">'animal'</font><font color="#007700">];&nbsp;&nbsp;&nbsp;</font><font color="#FF8000">// cat<br /></font><font color="#007700">echo </font><font color="#0000BB">date</font><font color="#007700">(</font><font color="#DD0000">'Y m d H:i:s'</font><font color="#007700">, </font><font color="#0000BB">$_SESSION</font><font color="#007700">[</font><font color="#DD0000">'time'</font><font color="#007700">]);<br /><br /></font><font color="#FF8000">// Você pode querer usar o SID aqui, como fissemos em page1.php<br /></font><font color="#007700">echo </font><font color="#DD0000">'&lt;br /&gt;&lt;a href="page1.php"&gt;page 1&lt;/a&gt;'</font><font color="#007700">;<br /></font><font color="#0000BB">?&gt;</font>
</font>
</code></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
    </P
><P
>&#13;     Se você quiser usar uma seção com nomes, você deve usar
     <A
HREF="function.session-name.html"
><B
CLASS="function"
>session_name()</B
></A
> antes de
     <B
CLASS="function"
>session_start()</B
>.
    </P
><P
>&#13;     <B
CLASS="function"
>session_start()</B
> irá registrar um handler de saída
     interno para URL reescrevendo quando <TT
CLASS="literal"
>trans-sid</TT
> está
     habilitada. Se um usuário utiliza <TT
CLASS="literal"
>ob_gzhandler</TT
> ou
      <A
HREF="function.ob-start.html"
><B
CLASS="function"
>ob_start()</B
></A
>, a ordem do handler de exibição
     é importante para a exibição apropriada. Por exemplo, usuário
     deve registrar <TT
CLASS="literal"
>ob_gzhandler</TT
> antes da sessão começar.
    </P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
      Uso de <A
HREF="ref.zlib.html#ini.zlib.output-compression"
>zlib.output_compression</A
>  é mais
      recomendado do que <TT
CLASS="literal"
>ob_gzhandler</TT
>
     </P
></BLOCKQUOTE
></DIV
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
      Apartir do PHP 4.3.3, usar <B
CLASS="function"
>session_start()</B
> quando a seção já tiver
      sido iniciada irá resultar em um erro de nível.
      <TT
CLASS="constant"
><B
>E_NOTICE</B
></TT
>.  Também, o segundo início de seção será simplesmente ignorado.
     </P
></BLOCKQUOTE
></DIV
><P
>&#13;     Veja também
     <A
HREF="reserved.variables.html#reserved.variables.session"
>$_SESSION</A
>,
     <A
HREF="ref.session.html#ini.session.auto-start"
>session.auto_start</A
>, e
     <A
HREF="function.session-id.html"
><B
CLASS="function"
>session_id()</B
></A
>.
    </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.session-set-save-handler.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Principal</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.session-unregister.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>session_set_save_handler</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.session.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>session_unregister</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>