session-set-save-handler.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: a4b6d72ad31caf1dfebe4ead873da491e45395ef Maintainer: leszek Status: ready -->
<!-- $Revision$ -->
  <refentry xml:id="function.session-set-save-handler" xmlns="http://docbook.org/ns/docbook">
   <refnamediv>
    <refname>session_set_save_handler</refname>
    <refpurpose>
     Ustawia funkcje użytkownika do przechowywania sesji
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>bool</type><methodname>session_set_save_handler</methodname>
      <methodparam><type>callback</type><parameter>otwórz</parameter></methodparam>
      <methodparam><type>callback</type><parameter>zamknij</parameter></methodparam>
      <methodparam><type>callback</type><parameter>czytaj</parameter></methodparam>
      <methodparam><type>callback</type><parameter>zapisz</parameter></methodparam>
      <methodparam><type>callback</type><parameter>niszcz</parameter></methodparam>
      <methodparam><type>callback</type><parameter>gc</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>session_set_save_handler</function> ustawia funkcje użytkownika
     do obsługi przechowywania sesji, które używane sa do zapisywania i
     odtwarzania danych skojarzonych z sesją. Jest to bardzo przydatne jeśli
     preferowany jest sposób przechowywania sesji inny niż ten, który jest
     dostarczany z PHP, np. przechowywanie danych sesji w lokalnej bazie
     danych.
     &return.success;
    </para>
    <note>
     <para>
      Procedura obsługi "zapisz" nie będzie wywołana dopóki strumień wyjściowy
      jest otwarty. W związku z tym, wyjście instrukcji debugowania zawartych
      w procedurze "zapisz" nigdy nie będzie widoczne w oknie przeglądarki.
      Jeśli konieczne jest wyjście debugowania, sugerowane jest zapisanie tego
      wyjścia do pliku.
     </para>
    </note>
    <para>
     Poniższy przykład opisuje metodę przechowywania danych sesyjnych w
     plikach, podobną do tej obsługiwanej wewnętrznie przez PHP. Przykład ten
     może być łatwo rozszerzony aby móc użyć go z twoją ulubioną bazą danych
     obsługiwaną przez PHP.
    </para>
    <para>
     Funkcja czytająca zawsze musi zwracać ciąg aby procedura obsługi działała
     zgodnie z przewidywaniami. Zwróć pusty ciąg jeśli nie ma żadnych danych
     do odczytania. Wartości zwracane przez inne procedury obsługi są
     konwertowane na wyrażenia logiczne. &true; dla sukcesu, &false; dla
     niepowodzenia.
    </para>
    <warning>
     <para>
      Od wersji PHP 5.0.5, funkcje obsługi zapisu i zamykania wywoływane są po
      zniszczeniu obiektów. W związku z tym, destruktory mogą używać sesji,
      ale nie mogą używać obiektów. W wersjach wcześniejszych, wywoływane były
      w odwrotnej koljeności. Możliwe jest wywołanie
      <function>session_write_close</function> z destruktora aby rozwiązać ten
      problem kury i jajka.
     </para>
    </warning>
    <para>
     <example>
      <title>
       Przykład <function>session_set_save_handler</function>
      </title>
      <programlisting role="php">
<![CDATA[
<?php

function open ($save_path, $session_name)
{
  global $sess_save_path, $sess_session_name;
       
  $sess_save_path = $save_path;
  $sess_session_name = $session_name;
  return(true);
}

function close()
{
  return(true);
}

function read ($id)
{
  global $sess_save_path, $sess_session_name;

  $sess_file = "$sess_save_path/sess_$id";
  if ($fp = @fopen($sess_file, "r")) {
    $sess_data = fread($fp, filesize($sess_file));
    return($sess_data);
  } else {
  return(""); // Zawsze musi zwracać ""
  }

}

function write ($id, $sess_data)
{
  global $sess_save_path, $sess_session_name;

  $sess_file = "$sess_save_path/sess_$id";
  if ($fp = @fopen($sess_file, "w")) {
    return(fwrite($fp, $sess_data));
  } else {
    return(false);
  }

}

function destroy ($id)
{
  global $sess_save_path, $sess_session_name;
       
  $sess_file = "$sess_save_path/sess_$id";
  return(@unlink($sess_file));
}

/*********************************************
 * UWAGA: Musisz sam zaimplementować obsługę *
 * zbierania śmieci (gc)                     *
 *********************************************/
 function gc ($maxlifetime)
 {
  return true;
}

session_set_save_handler ("open", "close", "read", "write", "destroy", "gc");

session_start();

// dalej normalnie używaj sesji

?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Zobacz także opis dyrektywy konfiguracji <link
      linkend="ini.session.save-handler">session.save_handler</link>.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->