<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >session_register</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_regenerate_id" HREF="function.session-regenerate-id.html"><LINK REL="NEXT" TITLE="session_save_path" HREF="function.session-save-path.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-regenerate-id.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-save-path.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="function.session-register" ></A >session_register</H1 ><DIV CLASS="refnamediv" ><A NAME="AEN203944" ></A ><P > (PHP 4, PHP 5)</P >session_register -- Registrar uma ou mais variáveis globais na sessão atual </DIV ><DIV CLASS="refsect1" ><A NAME="AEN203947" ></A ><H2 >Descrição</H2 >bool <B CLASS="methodname" >session_register</B > ( mixed name [, mixed ...] )<BR ></BR ><P > <B CLASS="function" >session_register()</B > aceita um número de argumentos variáveis, algund deles podem ser ou uma string com o nome da variável ou uma matriz de nomes de variáveis ou outras matrizes. Para cada nome, <B CLASS="function" >session_register()</B > registra a variável global com o nome na sessão atual. </P ><DIV CLASS="caution" ><P ></P ><TABLE CLASS="caution" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Cuidado</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P > Se você quer que seu script funcione independentemente do uso de <A HREF="ini.core.html#ini.register-globals" >register_globals</A >, você precisa usar a matriz <A HREF="reserved.variables.html#reserved.variables.session" >$_SESSION</A > já que <CODE CLASS="varname" >$_SESSION</CODE > é automaticamente registrada. Se o seu script usa <B CLASS="function" >session_register()</B >, ele não irá funcionar em ambientes onde a diretiva de configuração <A HREF="ini.core.html#ini.register-globals" >register_globals</A > esteja desabilitada. </P ></TD ></TR ></TABLE ></DIV ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota importante sobre register_globals:: </B >Desde o PHP 4.2.0, o valor padrão para a diretiva <A HREF="ini.core.html#ini.register-globals" >register_globals</A > é <SPAN CLASS="emphasis" ><I CLASS="emphasis" > off</I ></SPAN > e foi completamente removida a partir do PHP 6.0.0. A comunidade do PHP encoraja a todos a não depender desta configuração mas ao invés usar outros meios, como, por exemplo, <A HREF="language.variables.predefined.html" >superglobals</A >. </P ></BLOCKQUOTE ></DIV ><DIV CLASS="caution" ><P ></P ><TABLE CLASS="caution" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Cuidado</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P > Isto registra uma variável <SPAN CLASS="emphasis" ><I CLASS="emphasis" >global</I ></SPAN >. Se você quiser registrar uma variável dntro de uma função, você deve certificar-se de faze-la global, usando <A HREF="language.variables.scope.html" ><B CLASS="command" >global</B ></A > ou usando a matriz <CODE CLASS="varname" >$GLOBALS[]</CODE >, ou usando a matriz especial para seções($_SESSION) como mostrado abaixo. </P ></TD ></TR ></TABLE ></DIV ><DIV CLASS="caution" ><P ></P ><TABLE CLASS="caution" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Cuidado</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P > Se você esta usando <CODE CLASS="varname" >$_SESSION</CODE > (ou <CODE CLASS="varname" >$HTTP_SESSION_VARS</CODE >), não use <B CLASS="function" >session_register()</B >, <A HREF="function.session-is-registered.html" ><B CLASS="function" >session_is_registered()</B ></A > e <A HREF="function.session-unregister.html" ><B CLASS="function" >session_unregister()</B ></A >. </P ></TD ></TR ></TABLE ></DIV ><P > Esta função retorna <TT CLASS="constant" ><B >TRUE</B ></TT > quando todas de suas variáveis são registradas sem erro. </P ><P > Se <A HREF="function.session-start.html" ><B CLASS="function" >session_start()</B ></A > não foi chamada antes desta função ser chamada, uma chamada implícita para <A HREF="function.session-start.html" ><B CLASS="function" >session_start()</B ></A > sem parâmetros será feita. <CODE CLASS="varname" >$_SESSION</CODE > não imita isto e necessita que <A HREF="function.session-start.html" ><B CLASS="function" >session_start()</B ></A > seja chamada antes de usar. </P ><P > Você também pode criar variáveis de sessão simplesmente definindo o membro apropriado de <CODE CLASS="varname" >$_SESSION</CODE > ou <CODE CLASS="varname" >$HTTP_SESSION_VARS</CODE > (PHP < 4.1.0) matriz. <DIV CLASS="informalexample" ><P ></P ><A NAME="AEN203997" ></A ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><code><font color="#000000"> <font color="#0000BB"><?php<br /></font><font color="#FF8000">// O uso de session_register() esta obsoleto<br /></font><font color="#0000BB">$barney </font><font color="#007700">= </font><font color="#DD0000">"Um grande dinossauro púrpura."</font><font color="#007700">;<br /></font><font color="#0000BB">session_register</font><font color="#007700">(</font><font color="#DD0000">"barney"</font><font color="#007700">);<br /></font><font color="#FF8000">// O uso de $_SESSION é recomendado, apartir do PHP 4.1.0<br /></font><font color="#0000BB">$_SESSION</font><font color="#007700">[</font><font color="#DD0000">"zim"</font><font color="#007700">] = </font><font color="#DD0000">"Um invasor de outro planeta."</font><font color="#007700">;<br /><br /></font><font color="#FF8000">// A maneira antiga é usar $HTTP_SESSION_VARS<br /></font><font color="#0000BB">$HTTP_SESSION_VARS</font><font color="#007700">[</font><font color="#DD0000">"spongebob"</font><font color="#007700">] = </font><font color="#DD0000">"Ele conseguiu calças ajustadas."</font><font color="#007700">;<br /></font><font color="#0000BB">?></font> </font> </code></TD ></TR ></TABLE ><P ></P ></DIV > </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Não é possível registrar atualmente variáveis resource numa sessão. Por exemplo, você não pode criar uma conexão para um banco de dados e guardar a id de conexão como uma variável de sessão e esperar que a conexão ainda esteja válida na próxima vez que a sessão estiver restaurada. Funções do PHP que retornam uma resource são identificadas por conterem um retorno do tipo <TT CLASS="literal" >resource</TT > em suas definições de função. Uma lista de funções que retornam resources estão disponíveis no apêndice <A HREF="resource.html" >tipos resources</A >. </P ><P > Se <CODE CLASS="varname" >$_SESSION</CODE > (ou <CODE CLASS="varname" >$HTTP_SESSION_VARS</CODE > para PHP 4.0.6 ou inferior) é usada, para variável definida variable com <CODE CLASS="varname" >$_SESSION</CODE >. i.e. $_SESSION['var'] = 'ABC'; </P ></BLOCKQUOTE ></DIV ><P > Veja também <A HREF="function.session-is-registered.html" ><B CLASS="function" >session_is_registered()</B ></A >, <A HREF="function.session-unregister.html" ><B CLASS="function" >session_unregister()</B ></A > e <A HREF="reserved.variables.html#reserved.variables.session" >$_SESSION</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-regenerate-id.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-save-path.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >session_regenerate_id</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_save_path</TD ></TR ></TABLE ></DIV ></BODY ></HTML >