Funções para Sessão
PHP Manual

session_register

(PHP 4, PHP 5 < 5.4.0)

session_registerRegistra uma ou mais variáveis globais na sessão atual

Descrição

bool session_register ( mixed $name [, mixed $... ] )

session_register() aceita um número de argumentos variáveis, alguns deles podem ser ou uma string com o nome da variável ou um array de nomes de variáveis ou outros arrays. Para cada nome, session_register() registra a variável global com o nome na sessão atual.

Você também pode criar uma variável de sessão simplesmente definindo o membro apropriado nos arrays $_SESSION ou $HTTP_SESSION_VARS (PHP < 4.1.0).

<?php
// O uso de session_register() está obsoleto
$barney "Um grande dinossauro roxo.";
session_register("barney");

// O uso de $_SESSION é preferível desde o PHP 4.1.0
$_SESSION["zim"] = "Um invasor de outro planeta.";

// O modo antigo era usando $HTTP_SESSION_VARS
$HTTP_SESSION_VARS["spongebob"] = "Ele tem uma calça quadrada.";
?>

Se session_start() não for chamada antes dessa função ser executada, uma chamada implícita a session_start(), sem parâmetros, será feita. $_SESSION não imita esse comportamento e requer session_start() antes de seu uso.

Aviso

Esta função tornou-se OBSOLETA desde o PHP 5.3.0 e foi REMOVIDA desde o PHP 5.4.0.

Parâmetros

name

Uma string contento o nome de uma variável ou array com nomes de variáveis ou ainda outros arrays.

...

Valor Retornado

Retorna TRUE em caso de sucesso ou FALSE em caso de falha.

Notas

Cuidado

Se você deseja que seu script funcione independente de register_globals, então o que deve ser usado é o array $_SESSION, pois entradas em $_SESSION são registrados automaticamente. Se o seu script utiliza session_register(), ele não vai funcionar em ambientes onde a diretava register_globals está desativada.

Nota: Nota importante sobre register_globals:

Desde o PHP 4.2.0, o valor padrão para a diretiva register_globals é off e foi completamente removida a partir do PHP 6.0.0. A comunidade do PHP desencoraja desenvolvedores a confiar nesta diretiva, e encoraja o uso de outros meios, como em superglobals.

Cuidado

Isto registra uma variável global. Se você deseja registrar uma variável de dentro de uma função, então é necessário torná-la global utilizando a keyword global ou o array $GLOBALS[], ou ainda utilizar os arrays especiais conforme abaixo.

Cuidado

Se você está utilizando $_SESSION (ou $HTTP_SESSION_VARS), então não use session_register(), session_is_registered() e session_unregister().

Nota:

Atualmente é impossível registrar variáveis de recursos (resource) em uma sessão. Por exemplo, você não pode criar uma conexão a um banco de dados e armazenar a conexão em uma variável de sessão e esperar que a conexão ainda esteja válida quando a sessão for restaurada. Funções do PHP que retornam um recurso (resource) são identificados pelo tipo resource em sua definição. Uma lista de funções que retornam recursos está disponível no apêndice Tipos de Recursos.

Se $_SESSION (ou $HTTP_SESSION_VARS para PHP 4.0.6 e anteriores) for utilizado, atribua valores para $_SESSION. Por exemplo: $_SESSION['var'] = 'ABC';

Veja Também


Funções para Sessão
PHP Manual