Download the PHP package pitoncms/session without Composer

On this page you can find all versions of the php package pitoncms/session. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of pitoncms/session

Informations about the package session

Piton Session Handler

This class maintains session state across page views. A hashed, salted session key is set in a cookie which is the key to the session record in a MySQL table. The session key is regenerated every 5 minutes or as set in the configuation array. No information, other than the key, is stored client side. All user session information is kept server side in your database.

When the session starts the session handler looks for a session record matching the cookie key, and if found then runs optional checks to validate the session. If any of the checks fail, or if the session has timed out, the session is destoyed and a new session is started.

Session data can be set and retrieved at any time as either a key-value pair, or an array of key-value pairs. Flash data is also supported, which only persists until the next request.

Installation

You can use Composer to install the session handler or just download the files to your project.

Using Composer

Either require the project in composer,

or modify your composer.json project file to require this package and run an update or install.

This will download the files and register the class with the composer autoloader.

Or Just the Files, Please

If you do not use Composer, download this project and unzip. The only file you need is src/SessionHandler.php. Place that file in your project and be sure to include it in your startup script.

Create the Table

You will need to create the session table in your MySQL database using the SessionTable.sql script. You can change the table name in the script if desired, but you will need to provide the table name as a configuration item for tableName.

Usage

To use the session handler create a new instance of Piton\Session\SessionHandler passing in a PDO database connection and the configuration array.

PDO Connection

Define a new PDO connection and pass it in as the first argument of the constructor.

Define Configuruation

Define a configuration array and only include the options you wish to change. The only required configuration option is your application's encryption key. Use a long, random string and do not share it.

Options

Option Default Description
cookieName 'sessionCookie' Your session cookie name.
tableName 'session' Name of the MySQL table that stores your sessions.
secondsUntilExpiration 7200 How long before the session expires in seconds.
renewalTime 300 How long before the session key is regenerated in seconds.
expireOnClose false Whether or not to destroy the session when the browser closes, true or false.
checkIpAddress false Whether or not to match the IP address to the stored session, true or false.
checkUserAgent false Whether or not to match the User Agent to the stored session, true or false.
secureCookie false Whether or not to set cookie when on an HTTPS connection, true or false.
salt none Your custom encryption key. Any long (16+ characters) string of characters.
autoRunSession true Whether to run the session automatically, or only needed.

Creating a Session

Create a new session as part of your application flow.

The session runs immediately if autoRunSession is set to true (which is the default) and checks for a valid session, regenerates the session key if necessary, and loads any existing session data for immediate retrieval. Create the session object once, or simply add it to your Dependency Injection Container as a singleton.

When the session runs, it queries the database. If you need to make the session class available but do not need to immediately run the session you can set autoRunSession to false in the configuration. Then when you are ready to run a session call the run() method.

Save Session Data

Once the session is running, you can add or update session data by passing in key-value pairs or an array of key-value pairs using the setData() method. The value can be any type as long as it is serializable to JSON.

Supplying the same key will overwrite any prior value saved in session.

Get Session Data

To get session data pass in the item key to getData(). The method returns null if no key was found. To get all session data simply do not provide an argument.

Save Flash Data

Flash data will only stay until the next request, after which it is removed automatically.

You can add flash data by passing in a string, a key-value pair, or an array of key-value pairs using the setFlashData() method. The value can be any type as long as it is serializable to JSON.

Get Flash Data

To get flash data pass in the item key to getFlashData(). The method returns null if no key was found. To get all flash data simply do not provide an argument. Flash data is automatically removed on the next request, so there's no need to explicitly unset flash data.

Unset Session Data

You can delete a session item by passing in the item key to unsetData(), or delete all session data by not providing an argument.

Delete a Session

Any session that does not pass validation will be destoyed automatically. But, if you want to delete the current session call the destroy() method.

WARNING

Use this session class at your own risk. Read the code, and understand what it does if you intend on using this for for anything secure. We make no warranty if something goes wonky.

All versions of session with dependencies

PHP Build Version
Package Version
Requires php Version >=7.3
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package pitoncms/session contains the following files

Loading the files please wait ....