Artykuły

Moduły przechowywania danych

Do odczytu i zapisu danych sesji, PHP używa modułów przechowywania danych. Obecnie są dostępne trzy moduły:
- plikowy. domyślny, PHP zapisuje dane sesji na dysku (domyślnie w katalogu /tmp w Unix), tworząc pliki tekstowe o nazwach identycznych jak identyfikatory sesji.
- mm. Jeśli potrzebujesz większej wydajności, moduł mm daje Ci takie możliwości. Dane sesji są zapisywane w pamięci dzielonej.
- użytkownika. Używany wewnętrznie do realizacji odwołań do funkcji, które zdefiniowano w session_set_save_handler().

Prawdziwa moc tkwi w module użytkownika, ponieważ umożliwia pisanie własnych funkcji do obsługi sesji, które wciąż będą bazować na ujednoliconym API języka PHP; możesz zapisywać sesje jak chcesz i gdzie chcesz; w bazie danych np. MySql, plikach XML, DBF, na zdalnym serwerze FTP.
Aby skonfigurować uchwyt do zapisu sesji będziemy potrzebować funkcji session_set_save_handler(), która korzysta z sześciu argumentów (łańcuchów znakowych) które muszą być wywołaniami funkcji.

Składnia funkcji jest następująca:

void session_set_save_handler(string open, string close, string read, string write, string destroy, string gc);

Uwaga: Aby opuścić jeden z argumentów, wstaw pusty string ("") do session_set_save_handler().


Funkcje są definiowane następująco:

bool open (string save_path, string sess_name);

Funkcja jest wywoływana podczas inicjalizacji sesji; powinieneś jej użyć do przygotowania swoich funkcji, do inicjalizacji zmiennych itp. Funkcja pobiera dwa argumenty. Pierwszy to ścieżka gdzie sesja powinna być zapisana. Ta zmienna może być określona w php.ini lub przez funkcję session_save_path().Drugi argument to nazwa sesji, domyślnie PHPSESSID. Funkcja zwraca true jeśli jej wykonanie się powiedzie (istnieje ścieżka i nazwa sesji), lub false przy błędzie.

bool close ();

Ta funkcja jest wykonywana przy zamykaniu sesji. Używana do zwalniania pamięci lub kasowania zmiennych. Nie pobiera argumentów i zwraca true po zamknięciu sesji lub false gdy nastąpi błąd.

mixed read (string sess_id, );

Ta ważna funkcja jest wywoływana za każdym razem gdy uruchamiana jest sesja. Musi ona odczytać dane z sesji identyfikowanej przez sess_id a zwraca uszeregowany łańcuch znaków (string). Jeśli nie istnieje sesja z podanym ID, zwracany jest pusty łańcuch. Jeśli podczas wywołania tej funkcji wystąpi błąd zwracane jest false.

bool write (string sess_id, , string value);

Ta funkcja jest wywoływana w momencie gdy sesję należy zapisać. Pierwszy argument to session ID; drugi to uszeregowane zmienne sesji. Funkcja zwraca true jeśli się zapis się powiedzie, w innym przypadku false.

bool destroy (string sess_id, );

Ta funkcja jest wywoływana gdy używamy funkcji session_destroy() w kodzie PHP. Kasuje ona wszystkie dane związane z podanym sess_id i zwraca true gdy kasowanie się powiedzie lub false gdy wystąpi błąd.

bool gc (int max_lifetime, );

Ta funkcja jest wywoływana jeśli sesja startuje z określonym parametrem gc_probability. Służy ona usuwaniu starych sesji; usuwa sesje które nie zostały uaktualnione w ciągu gc_maxlifetime sekund. Zwraca true lub false.

Jeśli chcielibyśmy skonfigurować nasz własny moduł przechowywania sesji, załóżmy w bazie MySql, musimy dostarczyć PHP implementacji podobnych funkcji. Prototypy takich funkcji powinny wyglądać mniej więcej tak:

function sess_open($save_path, $sess_name)
{
}

function sess_read($sess_id)
{
}

function sess_write($sess_id, $val)
{
}

function sess_destroy($sess_id)
{
}

function sess_gc($max_lifetime)
{
}

Aby zarejestrować te funkcje musimy użyć session_set_save_handler():

session_set_save_handler("sess_open", "", "sess_read", "sess_write", "sess_destroy", "sess_gc");


Przekazywanie identyfikatora sesji

PHP4 wspiera następujące metody przekazywania identyfikatora sesji:
- Cookies (domyślnie)
- GET/POST
- Umieszczanie session ID w URL'u (ręcznie/automatyczne)

Cookie są domyślnym sposobem przekazywania identyfikatora sesji pomiędzy stronami. Innym sposobem przekazywania ID są metody GET/POST. Twój URL wygląda wtedy tak: script.php?<session-name>=<session-id>. Możesz tworzyć podobne URL używając globalnego, stałego SID:

printf('<a href="script.php?%s">Link</a>', SID);

Automatyczne przepisywanie URL'a to jedna z nowych możliwości PHP 4, pozwalająca dodawać session ID do wszystkich linków na witrynie. Aby włączyć tę możliwość musimy skompilować PHP z opcją --enable-trans-id. Od tej chwili identyfikator sesji będzie dodawany do wszystkich URL'i do stron napisanych w PHP. Oczywiście przepisywanie URL'a znacznie obciąża serwer. Cookie są zaś ustawiane tylko raz nie powodując przepisywania URL'a.


Przykłady

Plik z opisanym poniżej przykładem znajduje się pod adresem:
http://php.zone.pl/misc/sessions.zip

Przykład zawiera prostą grę znanej pod nazwą wisielec, na której można pokazać przechowywanie zmiennych. Podczas gry komputer wybiera przypadkowe pięcioliterowe słowo, a grający musi je odgadnąć litera po literze. Grający ma tylko sześć prób po których jeśli nie odgadnie hasła wisielec zawisa na szubienicy. Słowa do odgadnięcia znajdują się w pliku words.txt i mogą zawierać dowolne wyrazy. Pamiętaj, że każdy wyraz musi znajdować się w oddzielnej linii. Oczywiście, gra nie może działać bez przechowywania informacji o swoim stanie. Gracz nie mogłby wygrać jeśli nie odgadłby całego słowa przy pierwszej próbie. Aby gra mogła poprawnie działać, potrzebujemy trzech zmiennych, które pamiętają wartości zmiennych pomiędzy kolejnymi zapytaniami.
Są to:
. słowo, które gracz próbuje zgadnąć.
. litery, które gracz już podał.
. ilość prób zakończonych nie odgadnięciem słowa.

Przykład używa domyślnej metody przekazywania identyfikatora sesji czyli cookie, zaś zasada działania wygląda tak:
. rejestrowane są trzy zmienne.
. skrypt sprawdza czy formularz został wysłany metodą Post, co oznacza, że gracz podał jakiś znak.
. jeśli tak, skrypt przyjmuje nowy znak, uaktualnia stan gry (wygrałeś, przegrałeś, pasująca litera, nie pasująca litera) i wyświetla odpowiedni komunikat.
. jeśli nie, uruchamiana jest nowa gra, pobierane jest przypadkowe słowo z pliku words.txt.
. łańcuch, który ukrywa jeszcze nie odgadnięte litery w szukanym słowie jest tworzony i wyświetlany w przeglądarce.
. reszta strony pozostaje bez zmian.

Wygląd strony HTML jest konfigurowany przez oddzielną klasę. W ten sposób oddzielamy kod programu od opisu wyglądu.



na podstawie:
"Session Handling with PHP 4.0" Tobias Ratschiller