archived-doc-de/reference/session/functions/session-start.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 -->
<!-- last change to 'session-start' in en/ tree in rev 1.2 -->
<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready -->
<!-- OLD-Revision: 1.81/EN.1.2 -->
  <refentry id="function.session-start">
   <refnamediv>
    <refname>session_start</refname>
    <refpurpose>Initialisiert eine Session</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>session_start</methodname>
      <void/>
     </methodsynopsis>
    <simpara>
     <function>session_start</function> erzeugt eine Session oder
     nimmt die aktuelle wieder auf, die auf der Session-ID basiert,
     die mit einer Anfrage, z.B. durch GET, POST oder ein Cookie,
     übermittelt wurde.
    </simpara>
    <simpara>
     Diese Funktion gibt immer &true; zurück.
    </simpara>
    <note>
     <para>
      Bei Verwendung Cookie-basierter Sessions müssen Sie
      <function>session_start</function> aufrufen, bevor irgend
      etwas an den Browser geschickt wird.
     </para>
    </note>
    <para>
     <example>
      <title>
       Ein Session-Beispiel: <filename>seite1.php</filename>
      </title>
      <programlisting role="php">
<![CDATA[
<?php
// seite1.php

session_start();

echo 'Willkommen auf Seite #1';

$_SESSION['farbe'] = 'grün';
$_SESSION['tier'] = 'Spinne';
$_SESSION['zeit'] = time();

// Funktioniert, falls das Session-Cookie akzeptiert wurde
echo '<br /><a href="seite2.php">Seite 2</a>';

// Oder die Session-ID mit übergeben, für den Fall, dass sie benötigt wird
echo '<br /><a href="seite2.php?' . SID . '">Seite 2</a>';
?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Nach dem Aufruf von <filename>seite1.php</filename> enthält
     automatisch auch die zweite Seite,
     <filename>seite2.php</filename>, die Session-Daten. Lesen Sie
     <link linkend="ref.session">Session Funktionen</link>, um
     weitere Informationen über die <link
     linkend="session.idpassing">Übermittlung der Session-ID</link>
     zu erhalten. Dort wird zum Beispiel erklärt, worum es sich bei
     der Konstanten <constant>SID</constant> handelt.
    </para>
    <para>
     <example>
      <title>Ein Session-Beispiel: <filename>seite2.php</filename></title>
      <programlisting role="php">
<![CDATA[
<?php
// seite2.php

session_start();

echo 'Willkommen auf Seite #2<br />';

echo $_SESSION['farbe'];  // grün
echo $_SESSION['tier'];   // Spinne
echo date('d.m.Y H:i:s', $_SESSION['zeit']);

// Sie können auch hier, genauso wie bei seite1.php, SID verwenden
echo '<br /><a href="seite1.php">Seite 1</a>';
?>
]]>
      </programlisting>
     </example>
    </para>
    <simpara>
     Wenn Sie eine benannte Session verwenden wollen, müssen Sie
     <function>session_name</function> aufrufen, bevor Sie
     <function>session_start</function> aufrufen.
    </simpara>
    <simpara>
     Wenn <literal>trans-sid</literal> aktiviert ist, registriert
     <function>session_start</function> die interne Ausgaberoutine für
     das Umschreiben von URLs. Verwendet ein Benutzer
     <literal>ob_gzhandler</literal> oder ähnliches mit
     <function>ob_start</function>, ist die Reihenfolge der
     Augaberoutine wichtig für eine korrekte Ausgabe. Zum Beispiel
     muss der Benutzer <literal>ob_gzhandler</literal> vor Beginn der
     Session registrieren.
    </simpara>
    <note>
     <simpara>
      Die Verwendung von <link
      linkend="ini.zlib.output-compression">zlib.output_compression</link>
      ist <function>ob_gzhandler</function> vorzuziehen.
     </simpara>
    </note>
    <note>
     <para>
      Ab PHP 4.3.3 resultiert der Aufruf von
      <function>session_start</function>, nachdem die Session schon
      gestartet wurde, in einem Fehler der Stufe
      <constant>E_NOTICE</constant>. Der zweite Session-Start wird
      in diesem Fall einfach ignoriert.
     </para>
    </note>
    <para>
     Siehe auch:
     <link linkend="reserved.variables.session">$_SESSION</link>,
     <link linkend="ini.session.auto-start">session.auto_start</link>
     und <function>session_id</function>.
    </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:"../../../../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
-->