Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/erdiko/session

Erdiko session handler
https://github.com/erdiko/session

php session session-driver

Last synced: 1 day ago
JSON representation

Erdiko session handler

Awesome Lists containing this project

README

        

# Erdiko Session Package

[![Package version](https://img.shields.io/packagist/v/erdiko/session.svg?style=flat-square)](https://packagist.org/packages/erdiko/session)
[![CircleCI](https://circleci.com/gh/Erdiko/session.svg?style=svg)](https://circleci.com/gh/Erdiko/session)
[![License](https://poser.pugx.org/erdiko/session/license)](https://packagist.org/packages/erdiko/session)

## Important: This package is currently on development, please don't use it until have a beta or stable version.

### Introduction

Erdiko Session is a package to handle in an easy and elastic way to persistent user data through the lifetime of your application.

### Official Documentation

Documentation for Erdiko Session Package can be found on the [Erdiko website](http://erdiko.org/session/).

### Installation

We recommend installing Erdiko Session Package with [Composer](https://getcomposer.org/). At the commandline simply run:
```
composer require erdiko/session
```

### Drivers

Current Drivers Available:
- File: SessionDriverFile

Coming Drivers in development:
- Redis: SessionDriverRedis
- Database: SessionDriverDatabase
- Cookie: SessionDriverCookie

### Dependencies

This package depends of Erdiko\Core

### Configuration

File Path
```
[site_root]/app/config/default/session.json
```

File format
```
{
"default": { // Driver Source
"driver": "file", // Driver Type
"path": "/tmp",
"lifetime": 60000
}
}
```
### Available Methods

You will find several methods that will satisfy your requirements for handling session data.

- get
- set
- has
- forget
- exists

### Basic Usage
For more details please see [*Advance Usage Detail*](/advanceUsage.md) Page.

#### Set Method
Set the value on session
```
Session::set('name', 'value');
```
#### Get method
Retrieves the value from the session
```
Session::get('name');
```
#### Has method
Verifies if the given key exists and has a value on the session
```
Session::get('name');
```
#### Exists method
Verifies if the given key exists, without verify if has or not value
```
Session::set('name', 'value');
```
#### Forget method
Removes the given key from the session
```
Session::set('name', 'value');
```

### Tests
*On development*

### Credits

* Mauricio Gastón
* John Arroyo
* Leo Daidone

[All Contributors](https://github.com/Erdiko/session/graphs/contributors)

* If you want to help, please do, we'd love more brainpower! Fork, commit your enhancements and do a pull request. If you want to get to even more involved please contact us!

### Sponsors

[Arroyo Labs](http://www.arroyolabs.com/)

### License

Erdiko is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)