Download the PHP package hoa/session without Composer

On this page you can find all versions of the php package hoa/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?

Informations about the package session

Hoa


Build status Code coverage Packagist License

Hoa is a modular, extensible and structured set of PHP libraries.
Moreover, Hoa aims at being a bridge between industrial and research worlds.

Hoa\Session

Help on IRC Help on Gitter Documentation Board

This library allows to manipulate sessions easily by creating “namespaces”, i.e. an entry in the $_SESSION global variable. It also allows to manipulate flash sessions.

Each namespace has a profile. Amongst many things, it implies we can control lifetime of each namespace individually. This library can be used in conjunction of ext/session (especially to configure session).

Learn more.

Installation

With Composer, to include this library into your dependencies, you need to require hoa/session:

For more installation procedures, please read the Source page.

Testing

Before running the test suites, the development dependencies must be installed:

Then, to run all the test suites:

For more information, please read the contributor guide.

Quick usage

We propose a quick overview of three usages: manipulating a namespace, expiration handling and destructing a namespace.

Manipulating a namespace

We will start a user namespace. If this namespace is empty, it implies two things: either the session is newly created or it has expired. In all cases, we print first time and save the current time in foo. And if the namespace is not empty, we print other times and dump the saved time. Thus:

First execution will print first time and next ones will print other times followed by a timestamp.

No need to start the session, it will be done automatically. But if we want to, we can use the session_start function or the Hoa\Session\Session::start static method, which is more sophisticated.

Expiration handling

If a namespace expires before the session, either an event is fired on the channel hoa://Event/Session/<namespace>:expired or an exception Hoa\Session\Exception\Expired is thrown (if no callable listens the channel). We can test if the namespace is expired with the help of the Hoa\Session\Session::isExpired method or we can declare the namespace as expired with the help of the Hoa\Session\Session::hasExpired method (this method will throw an exception or fire an event).

Considering the previous example, we will declare the namespace as expired when the session is empty:

First execution will print expired and first time, and next ones will print other times followed by a timestamp.

If an empty session does not imply an expiration (depending of our workflow and configuration), we could avoid the call to $user->hasExpired(): the test is automatically done during the construction of the namespace.

We can modify the lifetime by using the Hoa\Session\Session::rememberMe method; for example:

And we can also forget the namespace:

Destructing a namespace

Destructing a namespace uses the Hoa\Session\Session::delete method:

Stored data in the namespace are lost because we explicitly delete the namespace.

If we want to destroy the session (including all namespaces and cookie), we could use the Hoa\Session\Session::destroy static method. Again, no need to previously start the session manually if it is not done.

Documentation

The hack book of Hoa\Session contains detailed information about how to use this library and how it works.

To generate the documentation locally, execute the following commands:

More documentation can be found on the project's website: hoa-project.net.

Getting help

There are mainly two ways to get help:

Contribution

Do you want to contribute? Thanks! A detailed contributor guide explains everything you need to know.

License

Hoa is under the New BSD License (BSD-3-Clause). Please, see LICENSE for details.


All versions of session with dependencies

PHP Build Version
Package Version
Requires hoa/consistency Version ~1.0
hoa/event Version ~1.0
hoa/exception Version ~1.0
hoa/iterator Version ~2.0
ext-session Version *
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 hoa/session contains the following files

Loading the files please wait ....