Ferreteria/v0.5/sql/user session

About

• USED BY: the login system, especially the session management subsystem.
• PURPOSE: for managing web sessions
  • Also used by the Session stash.
• INTERNAL RULES:
  • Get the session cookie. (If no cookie, we're not logged in.)
  • Load the session record indicated by the cookie.
  • Check the session record to make sure it matches the current client.
  • If it does, the session's user ID is logged in; otherwise not.
  • A session record is also created for anonymous users.

SQL

CREATE TABLE `user_session` (
  `ID`          int NOT NULL AUTO_INCREMENT,
  `ID_Client`   int NOT NULL COMMENT 'user_client.ID',
  `ID_Acct`     int DEFAULT NULL COMMENT 'ID of logged-in user account, if any',
  `Token`       varchar(31) CHARACTER SET utf8 NOT NULL COMMENT 'session identifier: random string passed as cookie',
  `Stash`       blob COMMENT 'other values associated with the session (PHP serialized)',
  `WhenCreated` datetime NOT NULL COMMENT 'when session was created',
  `WhenUsed`    datetime DEFAULT NULL COMMENT 'when the session was last accessed',
  `WhenExpires` datetime DEFAULT NULL COMMENT 'when session expired or is due to expire',

  PRIMARY KEY (`ID`),
  UNIQUE KEY `Token` (`Token`)
) ENGINE=InnoDB;

History

• 2013-10-25 stripped Session classes out of VbzCart shop.php for use in ATC project
• 2013-11-09 backported improved Session classes back into user-session.php
• 2016-04-03 moved RandomString() to fcString::Random().
• 2020-12-12 some updates for v0.4