downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

session_save_path> <session_regenerate_id
[edit] Last updated: Fri, 18 Sep 2009

view this page in

session_register

(PHP 4, PHP 5)

session_registerРегистрира глобални променливи в текущата сесия

Описание

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

Функцията session_register() приема неограничен брой аргументи, като всеки от тях може да бъде или низ съдържащ името на променливата или масив, състоящ се от имена на променливи или други масиви. За всяко име session_register() регистрира глобалната променлива със същото име в текущата сесия.

Можете също да създадете сесийна променлива като просто установите подходящия член на масива $_SESSION или $HTTP_SESSION_VARS (PHP < 4.1.0).

<?php
// Употребата на session_register() е непрепоръчителна
$barney "A big purple dinosaur.";
session_register("barney");

// Употребата на $_SESSION е препоръчителна, от PHP 4.1.0
$_SESSION["zim"] = "An invader from another planet.";

// Старият начин беше с $HTTP_SESSION_VARS
$HTTP_SESSION_VARS["spongebob"] = "He's got square pants.";
?>

Ако session_start() не е извикана, преди извикването на тази функция, се прави заявка по подразбиране към session_start() без да бъдат предавани никакви параметри. $_SESSION няма такова поведение и изисква session_start() преди използването й.

Параметри

name

Низ, съдържащ име на променлива или масив съдържащ имена на променливи или други масиви.

...

Връщани стойности

Връща TRUE при успех или FALSE при неуспех.

Бележки

Внимание

Ако искате скриптът да работи независимо от register_globals, вместо това използвайте масива $_SESSION, като при променливата $_SESSION регистрирането е автоматично. Ако вашият скрипт използва session_register(), той няма да работи на места, където PHP директивата register_globals е забранена.

Забележка: register_globals: важно пояснение
От PHP 4.2.0, стойността по подразбиране на PHP директивата register_globals е off и е изцяло премахната в PHP 6.0.0. PHP общността ви насърчава да не разчитате на тази директива, а вместо това да използвате други средства, като superglobals.

Внимание

Това регистрира глобална променлива. Ако искате да регистрирате сесийна променлива от тялото на функция, трябва да сте сигурни, че за да я направите глобална използвате ключовата дума global, масива $GLOBALS[] или специалните сесийни масиви, както е отбелязано по-долу.

Внимание

Ако използвате $_SESSION (или $HTTP_SESSION_VARS) не използвайте session_register(), session_is_registered() и session_unregister().

Забележка: В момента е невъзможно да регистрирате ресурсни променливи в сесия. Например, не можете да осъществявате връзка към база от данни и да съхраните id на връзката като сесийна променлива и да очаквате връзката да бъде все още валидна следващият път, когато сесията е възстановена. Функциите в PHP, които връщат ресурс се идентифицират по това, че типът на променливата която връщат е resource. Списък на функциите, връщащи ресурс може да бъде видян в приложение ресурсни типове.
Ако се използва $_SESSION (или $HTTP_SESSION_VARS при PHP 4.0.6 или по-малка), присвоявайте стойността на $_SESSION. Например: $_SESSION['var'] = 'АБВ';

Вж. също

  • session_is_registered() - Проверява дали дадена глобална променлива е регистрирана в сесията
  • session_unregister() - Премахва глобална променлива от текущата сесия
  • $_SESSION



session_save_path> <session_regenerate_id
[edit] Last updated: Fri, 18 Sep 2009
 
add a note add a note User Contributed Notes session_register
klein at sup4u dot de 29-Jun-2011 04:42
in addition to function set_session_vars instead of replacing all $var with $_SESSION['var'],
 you could get all set session-vars in prevoius scripts with this function

<?php
function get_session_vars() {
   
$nb_args=func_num_args();
   
$arg_list=func_get_args();
    for(
$i=0;$i<$nb_args;$i++) {
        global $
$arg_list[$i] = $_SESSION[$arg_list[$i]];
    }
}
?>
yarco dot w at gmail dot com 30-Sep-2010 08:17
You *MUST* notice that

session_register($var)

*IS NOT*

$_SESSION[$var] = $$var;

it is

if (!isset($_SESSION[$var]))
  $_SESSION[$var] = $$var;

when migrating from old style code.
Ezion oudpapierdoos at gmail dot com 16-Feb-2010 06:38
Below is a fix that may be included in older code to make it work with PHP6.
When needed it recreates the functions
- session_register()
- session_is_registered()
- session_unregister()

The functions inside the function fix_session_register() are only available  after fix_session_register() has run.
Therefore in PHP<6 where there already is a session_register() nothing happens.

<?php
// Fix for removed Session functions
function fix_session_register(){
    function
session_register(){
       
$args = func_get_args();
        foreach (
$args as $key){
           
$_SESSION[$key]=$GLOBALS[$key];
        }
    }
    function
session_is_registered($key){
        return isset(
$_SESSION[$key]);
    }
    function
session_unregister($key){
        unset(
$_SESSION[$key]);
    }
}
if (!
function_exists('session_register')) fix_session_register();
?>


[EDIT BY danbrown AT php DOT net: Bugfix provided by "dr3w" on 02-APR-2010: "its [sic] function_exists with an S at the end".]
Scarab 13-Nov-2009 01:14
If you want to store an  object into the session, you have to check up that object can be serialized at all.
For example, if your object contains aggregated PDO object (which can't be serialized), you will get an error and no data would be stored.
rob at akrabat dot com 14-Aug-2009 02:18
if you remove session_register() calls and replace with $_SESSION assignments, make sure that it wasn't being used in place of session_start(). If it was, you'll need to add a call to session_start() too, before you assign to $_SESSION.
david dot demri at gmail dot com 26-May-2009 07:15
If you have an old code with a lot of call to the function session_register(), and you would like to make it compatible with PHP5 or PHP6, instead of rewriting all your code by replacing this function by $_SESSION['var']="val"; you could use the function set_session_vars(), that is used exactly the same way than session_register() (but there is no implicit call to session_start() ).

<?php
function set_session_vars() {
   
$nb_args=func_num_args();
   
$arg_list=func_get_args();
    for(
$i=0;$i<$nb_args;$i++) {
        global $
$arg_list[$i];
       
$_SESSION[$arg_list[$i]] = $$arg_list[$i];
    }
}
?>
kavih7 at yahoo dot com 19-May-2009 04:15
For those of you who use this function (session_register that is), even though the manual does specify that this function implicitly calls session_start(), I just wanted to reiterate that fact. It is also important to know that if you ever switch from session_register to using $_SESSION, make sure to call session_start before adding items to the $_SESSION variable, because unlike session_register, no implicit call to session_start is done.

Another reason I explain this is because I ran into a problem in which you can add items to the $_SESSION variable all you want, but if session_start is not called before adding them, they will not actually be saved to the session. Using the same code, though, and replacing the $_SESSION assignments with session_register without calling session_start WILL save that info to the session.

It would be nice to have PHP check for writes to the $_SESSION variable and complain with a warning if session_start hasn't been called.
guideng at unlv dot nevada dot edu 01-Jun-2006 01:10
Make sure you put session_start() at the beggining of your script.

My sessions kept unsetting and I finally figured out why.

On my script, session_start() has to be said and uses cookies to set the session.

But I was outputting html prior to calling session_start(), which prevented it from succeeding becouse it uses the header function to place the cookies.

Once html has been outputed, session_start() can't use the header function to set cookies, hence session_start() fails and no session can be started.
martijn at brothersinart dot net 11-Apr-2006 02:04
Please note that if you use a "|" sign in a variable name your entire session will be cleared, so the example below will clear out all the contents of your session.

<?php
session_start
();
$_SESSION["foo|bar"] = "foo";
?>

It took me quite some time finding out why my session data kept disappearing. According to this bugreport this behaviour is intended.
http://bugs.php.net/bug.php?id=33786
mikej 21-Nov-2004 01:40
I've noticed that if you try to assign a value to a session variable with a numeric name, the variable will not exist in future sessions.
For example, if you do something like:
session_start();
$_SESSION['14'] = "blah";
print_r($_SESSION);

It'll display:
Array ( [14] => "blah" )

But if on another page (with same session) you try
session_start();
print_r($_SESSION);

$_SESSION[14] will no longer exist.

Maybe everyone else already knows this, but I didn't realize it until messing around with a broken script for quite a while.
baldanders 12-Nov-2004 11:05
If you are using sessions and use session_register()  to register objects, these objects are serialized automatically at the end of each PHP page, and are unserialized automatically on each of the following pages. This basically means that these objects can show up on any of your pages once they become part of your session.

 
show source | credits | stats | sitemap | contact | advertising | mirror sites