- fixed a minor bug where we were auto-registering
session_write_closewhen callingsession_set_save_handlerbut then we were also registering it ourselves later
- fixed #49 where the old
session_set_save_handlersignature with more than 2 arguments was deprecated in PHP 8 and the deprecated signature would become unsupported either in PHP 9.0 or 10.0; the library is still backwards compatible; thanks to Joe Bordes for the heads up! - the
lock_to_ipargument of the constructor can now also be a callable; see #56; this is a better and more secure fix for #43 and #54; this is also a fix for a very old #7! thanks Andreas Heissenberger for the great idea and the feedback added a fix for using the library with an AWS load balancer; see #43 and #54; thank you Dvelopin!- fixed (hopefully) #53 regarding table locks not being released if script execution ended before the library being able to write session data and release the lock
- fixed an issue where
get_settings()would trigger an error ifsession.gc_divisoris set to0; this fixes #48 - thanks to Alex!
- the library doesn't set
session.cookie_lifetimeto0anymore but to the number of seconds specified in the constructor; with this, finally, sessions can be kept alive even if the browser is closed - this fixes #40 and #5 - the library is not setting
gc_probabilityandgc_divisorproperties anymore - this can potentially break your code when updating, as there are now less arguments in the constructor method! - the library does not set
session.use_strict_modeanymore - see #37 - updated documentation regarding what configuration options are set automatically
- lots of minor bug fixes and source code formatting because we are now using PHPStan for static code analysis and PHP CodeSniffer for detecting coding standards violations, which are now PSR12-ish with a few of the rules excluded
- fixed a bug where sessions became unusable if the user agent was changed after initialization; thanks to poisons77 for the feedback - see #32
- added integration with PDO
- implemented prepared statemets as
mysqli_real_escape_stringmay not be secure enough when used with PHP <5.7.6; see this for more information; thanks duckboy81 for suggesting - sessions can now be started in read-only mode thus not having to do row locks; see #26; thanks more7dev!
- session.use_strict_mode is now always enabled by the library automatically; thanks dnanusevski for suggesting
- session.cookie_secure is now automatically enabled by the library if HTTPS connection is detected; thanks dnanusevski for suggesting
- fixed issue when using special characters in table name; see #27; thanks more7dev!
- added option for disabling automatically starting the session; see #28; thanks Nick Muerdter for the pull request!
- minimum required PHP version has changed from
5.1.0to5.5.2
- fixed #16 where the maximum length for lock keys in MySQL 5.7.5+ is limited to 64 characters; thanks to Andreas Heissenberger for providing the fix!
- the library now destroys previous sessions when started
- database errors now throw exceptions instead of dying; thanks Jonathon Hill
- documentation is now available in the repository and on GitHub
- the home of the library is now exclusively on GitHub
- security tweaks (setting
session.cookie_httponlyandsession.use_only_cookiesto1by default) - the stop() method will now also remove the associated cookie
- hopefully #13 is now fixed for good
- closed #11; thanks @soren121
- fixed (hopefully) #13; thanks to @alisonw for providing the current fix
- reduced overall code complexity
- fixed an issue when using the library with Composer
- this version makes use of a feature introduced in PHP 5.1.0 for the "regenerate_id" method; thanks to Fernando Sávio; this also means that now the library requires PHP 5.1.0+ to work
- dropped support for PHP 4; minimum required version is now PHP 5
- dropped support for PHP's mysql extension, which is officially deprecated as of PHP v5.5.0 and will be removed in the future; the extension was originally introduced in PHP v2.0 for MySQL v3.23, and no new features have been added since 2006; the library now relies on PHP's mysqli extension
- because of the above, the order of the arguments passed to the constructor have changed and now the "link" argument comes first, as with the mysqli extension this now needs to be explicitly given
- added support for "flash data" - session variable which will only be available for the next server request, and which will be automatically deleted afterwards. Typically used for informational or status messages (for example: "data has been successfully updated"); see the newly added set_flashdata method; thanks Andrei Bodeanschi for suggesting!
- the project is now available on GitHub and also as a package for Composer
- previously, session were always tied to the user agent used when the session was first opened; while this is still true, now this behavior can be disabled by setting the constructor's new "lock_to_user_agent" argument to FALSE; why? because in certain scenarios involving Internet Explorer, the browser will randomly change the user agent string from one page to the next by automatically switching into compatibility mode; thanks to Andrei Bodeanschi
- also, the constructor has another new "lock_to_ip" argument with which a session can be restricted to the same IP as when the session was first opened - use this with caution as many ISPs provide dynamic IP addresses which change over time, not to mention users who come through proxies; this is mostly useful if you know your users come from static IPs
- for better protection against session hijacking, the first argument of the constructor is now mandatory
- altered the table structure
- because the table's structure has changed as well as the order of the arguments in the constructor, you'll have to change a few things when switching to this version from a previous one
- some documentation refinements
- fixed a bug where sessions' life time was twice longer than expected; thanks to Andrei Bodeanschi
- details on how to preserve session data across sub domains was added to the documentation
- the messages related database connection errors are now more meaningful
- fixed a bug with the get_active_sessions() method which was not working at all
- fixed a bug where the script was not using the provided MySQL link identifier (if available)
- the constructor method now accepts an optional link argument which must be a MySQL link identifier. By default, the library made use of the last link opened by mysql_connect(). On some environments (particularly on a shared hosting) the "last link opened by mysql_connect" was not available at the time of the instantiation of the Zebra_Session library. For these cases, supplying the MySQL link identifier to the constructor method will fix things. Thanks to Mark for reporting.
- some documentation refinements
- the class now implements session locking; session locking is a way to ensure that data is correctly handled in a scenario with multiple concurrent AJAX requests; thanks to Michael Kliewe for suggesting this and to Andy Bakun for this excellent article on the subject Race Conditions with Ajax and PHP Sessions.
- fixed a small bug in the destroy method; thanks to Tagir Valeev for reporting
- the script would trigger a PHP notice if the HTTP_USER_AGENT value was not available in the $_SERVER super-global
- added a new method "get_settings" that returns the default session-related settings for the environment where the class is used
- the class will now trigger a fatal error if a database connection is not available
- the class will now report if MySQL table is not available
- the constructor of the class now accepts a new argument: tableName - with this, the MySQL table used by the class can be changed
- 'LIMIT 1' added to the read method improving the performance of the script; thanks to A. Leeming for suggesting this
- rewritten the write method which previously had to run two queries each time; it now only runs a single one, using ON DUPLICATE KEY UPDATE; thanks to Inchul Koo for providing this information
- the type of the http_user_agent column in the MySQL table has been changed from TEXT to VARCHAR(32) as now it is an MD5 hash; this should increase the performance of the script; thanks to Inchul Koo for suggesting this
- the constructor of the class now accepts a new argument: securityCode, in order to try to prevent HTTP_USER_AGENT spoofing; read the documentation for more information; thanks to Inchul Koo for suggesting this
- the get_users_online method is now more accurate as it now runs the garbage collector before getting the number of online users; thanks to Gilles for the tip
- the structure of the MySQL table used by the class was tweaked in so that the http_user_agent column has been changed from VARCHAR(255) to TEXT and the session_data column has been changed from TEXT to BLOB; thanks to Gilles for the tip
- the class was trying to store the session data without mysql_real_escape_string-ing it and therefore, whenever the data to be saved contained quotes, nothing was saved; thanks to Ed Kelly for reporting this
- the structure of the MySQL table used by the class was tweaked and now the session_id column is now a primary key and its type has changed from VARCHAR(255) to VARCHAR(32) as it now is an MD5 hash; previously a whole table scan was done every time a session was loaded; thanks to Harry for suggesting this
- added a new stop method which deletes a session along with the stored variables from the database; this was introduced because many people were using the private destroy method which is only for internal purposes
- the default settings for session.gc_maxlifetime, session.gc_probability and session.gc_divisor can now be overridden through the constructor
- on popular request, an example file was added
- initial release