PHP: session_register

Opis

bool session_register ( mixed nazwa [, mixed ...] )

session_register() jest funkcją o zmiennej liczbie argumentów, z których każdy może być albo stringiem zawierającym nazwę zmiennej lub tablicą zawierającą nazwy zmiennych lub inne tablice. Dla każdej napotkanej nazwy zmiennej, session_register() rejestruje w bieżącej sesji globalną zmienną o danej nazwie.

Uwaga!

Jeśli skrypt ma działać niezależnie od ustawienia register_globals, niezbędne jest użycie tablicy $_SESSION, jako że elementy $_SESSION są atomatycznie rejestrowane. Jeśli skrypt korzysta z session_register(), nie będzie on działać w środowisku z wyłączoną dyrektywą register_globals.

register_globals: ważna uwaga: Od PHP w wersji 4.2.0 domyślną wartością dyrektywy register_globals jest off. Społeczność PHP zaleca, aby nie polegać na tej dyrektywie, ale zamiast tego używać innych środków, takich jak superglobals.

Uwaga!

Funkcja ta rejestruje globalną zmienną. Jeśli zachodzi konieczność zarejestrowania zmiennej sesyjnej z wnętrza funkcji, należy uczynić ją globalną poprzez użycie instrukcji global, przez tablicę $GLOBALS[] lub prez użycie specjalnych tablic opisanych poniżej.

Uwaga!

Przy korzystaniu z tablicy $_SESSION (lub $HTTP_SESSION_VARS) nie nalezy korzystać z funkcji session_register(), session_is_registered() i session_unregister().

Funkcja ta zwraca wartość TRUE jeśli wszystkie zmienne zostały pomyślnie zarejestrowane w sesji.

Jeśli przed wywołaniem tej funkcji nie wywołano session_start(), dokonane zostanie niejawne wywołanie session_start() bez żadnych parametrów. Tablica $_SESSION nie naśladuje tego zachowania i wymaga wywołania session_start() przed korzystaniem z niej.

Możesz tworzyć zmienne sesyjne po prostu przez dopisywanie odpowiednich wpisów do tablic $_SESSION lub $HTTP_SESSION_VARS (PHP < 4.1.0).


<?php

// Nie powinno się już używać session_register()

$barney = "Duży fioletowy dinozaur.";

session_register("barney");



// Od PHP 4.1.0 Preferowane jest użycie $_SESSION

$_SESSION["zim"] = "Najeźdźca z innej planety.";



// Stara metoda opiera się o $HTTP_SESSION_VARS

$HTTP_SESSION_VARS["spongebob"] = "Ma kwadratowe spodnie.";

?>

Notatka: W chwili obecnej niemożliwe jest zarejestrowanie w sesji zmiennych zawierających zasoby. Na przykład, nie możesz stworzyć połączenia do bazy danych i zachować identyfikator połączenia jako zmienną sesyjną i oczekować, że połączenie ciągle będzie aktywne po odtworzeniu danych sesji. Funkcję PHP, która zwraca zasoby, identyfikuje się przez zwracanie typu resource w definicji funkcji. Listę funkcji, które zwracają zasoby, można znaleźć w załączniku typy zasobów.
Jeśli użyta jest tablica $_SESSION (lub $HTTP_SESSION_VARS dla PHP 4.0.6 i starszych), przypisz vartość do $_SESSION, na przykład $_SESSION['var'] = 'ABC';

Patrz także: session_is_registered(), session_unregister() i $_SESSION.

User Contributed Notes


It states above that there is no need to set $HTTP_SESSION_VARS or to use session_register if you are using >PHP4.1x but this is NOT the case!  [dependant upon your system]



Using PHP5 you can set a session variable like this:



if(!session_id()) session_start();

$_SESSION['your_id']=$your_id;



BUT, with PHP4 you need to use (also fine for PHP5):



if(!session_id()) session_start();

session_register("your_id");//used for older versions of PHP

$HTTP_SESSION_VARS['your_id']=$your_id;//used for older versions of PHP

$_SESSION['your_id']=$your_id;

//tested on PHP4 on Linux, FreeBSD and Windows.



So if you are updating your scripts ready for use with PHP5 but still running on version 4 then use the later method.


Note that with the existence of both $_SESSION and references, it is not necessary to use register_globals() if you don't want your code cluttered up with references to the $_SESSION superglobal.  Just do something like:



$_SESSION['some_variable'] =& $GLOBALS['some_variable'];



And henceforth you can just use $some_variable and forget all about typing $_SESSION all the time.  Though on subsequent sessions if you want to get at that value with a global variable in a similar fashion, you'll of course have to use:



$GLOBALS['some_variable'] =& $_SESSION['some_variable'];



It's fairly easy to take that knowledge and come up with a user-defined function that does 90+% of what the old session_register() did...


I have 3 files:



- The first is the form that contains various fields.

- Second is the php script that the form submits data to.  This file then stores acquired values to the session.

- Finally the third file is the php script that accesses data from the session



So the first script:



<?



session_start();



$title = $_POST["title"];

$fname = $_POST["fname"];



$_SESSION["first"] = $fname;



?>



... All we do here is set values from HTTP POST request.



Now the second script:



<?



session_start();



echo $_SESSION["first"];



?>



... Here we try to print out the session variable that was set in the previous script.



This demonstrates the use of $_SESSION.  There is no need to declare $_SESSION to be global since it is already global, thus can be accessed from anywhere.



Tested on PHP 4.