Rechercher une page de manuel
Apache2::ClickPath::Decode.3pm
Langue: en
Version: 2005-10-30 (mandriva - 01/05/08)
Section: 3 (Bibliothèques de fonctions)
NAME
Apache2::ClickPath::Decode - Decode Apache2::ClickPath session IDsSYNOPSIS
use Apache2::ClickPath::Decode; my $decoder=Apache2::ClickPath::Decode->new; $decoder->tag='-'; my $time=$decoder ->parse( 'http://bla.com/-PtVOR9:dxAredNNqtcus9NNNOdM/' ) ->creation_time;
DESCRIPTION
"Apache2::ClickPath::Decode" provides an OO interface for decoding "Apache2::ClickPath" session identifiers.Methods
This module uses Class::Member(3) to implement member functions. Thus, all member functions are lvalues, eg "$decoder->tag='-'".
- new
- The constructor. If called as instance method it creates a new instance that inherits the "friendly_session", "tag" and "server_map" attributes if they are not overridden be parameters.
"new()" accepts named parameters as "NAME => VALUE" pairs. The following parameters are recognized:
-
- friendly_session
- tag
- server_map
- secret
- secret_iv
- for these 3 see the appropriate member functions below.
- session
- if a session is given, "parse()" is called immediately. So, the result is directly accessible.
-
- parse
- "parse()" is called with an optional parameter containing the actual session identifier. If ommitted the internally stored session identifier is used.
If the object's "tag" attribute is set the session can actually contain an URL or an arbitrary string containing a session identifier that is preceded with the tag and ended with a slash (/). After parsing the "session" member function returns the found session without surrounding characters.
After "parse" the session information can be fetched by "creation_time" "server_pid", "seq_number", "connection_id", "remote_session", "remote_session_host" and "server_id" member functions.
If the "friendly_session" attribute is given and the session contains a friendly session then the "remote_session" and "remote_session_host" member functions will return the remote session.
If the "server_map" attribute is set the "server_id" member function will return the machine's name according to the "Apache2::ClickPaths"'s "ClickPathMachine" directive. Currently this attribute must be assigned an emtpy string or left undefined. Otherwize a warning is issued. If defined the sessions server-id part is directly assigned to "server_id". If not defined it indicates that the "ClickPathMachine" directive was not given in your "httpd.conf" and the server-id is to be interpreted as IP address.
"parse" returns the object itself on success or "undef".
Member Functions
- tag
- this member function matches "Apache2::ClickPath"'s "ClickPathSessionPrefix" directive. If given the module can identify session identifiers in URLs. So, "parse()" can be called directly with an URL. If not given the whole string passed to "parse()" is tried as session identifier.
- friendly_session
- this matches "Apache2::ClickPath"'s "ClickPathFriendlySessions" container directive. It can be set to a string consiting of lines each describing a friendly session as the directive in your "httpd.conf" does.
- server_map
- if left undefined "parse()" will interpret the server-id part of a session identifier as IP address. If set to an empty string it will not. If set to a non-empty string it will be interpreted the same way as "Apache2::ClickPath" interprets a "ClickPathMachineTable". This table is then used to map a server name to a server_id (IP address).
Also a HASH can be given instead of a string. Then this hash maps the server_name to a server_id.
- secret
- secret_iv
- these 2 functions correspond to the "ClickPathSecret" and "ClickPathSecretIV" configuration directives of Apache2::ClickPath. Syntax and semantic are the same.
- session
- is initialized with a session identifier or an URL. After "parse()" is called it contains the session identifier.
- remote_session
- remote_session_host
- server_id
- server_name
- creation_time
- server_pid
- seq_number
- connection_id
- These members are initialized be "parse()" to hold the components of the parsed session. For the first 3 see "parse()" above and Apache2::ClickPath(3). "creation_time" returns the sessions creation time in seconds since 1/1/1970 00:00 GMT, "server_pid" the WEB server's process id, "seq_number" a 16-bit number that is incremented for each new session a WEB server process creates. At process start up is is initialized with a random number. So it does not indicate how much sessions a server process has created. "connection_id" contains the Apache's connection ID. Refer to Apache's source code an docs for more information.
SEE ALSO
Apache2::ClickPath(3), <http://httpd.apache.org>AUTHOR
Torsten Foertsch, <torsten.foertsch@gmx.net>COPYRIGHT AND LICENSE
Copyright (C) 2004 by Torsten FoertschThis library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre