GitHub Project

layout: default language: 'zh-cn' version: '4.0' title: 'Phalcon\Session'

Abstract Class Phalcon\Session\Adapter\AbstractAdapter

Source on GitHub

| Namespace | Phalcon\Session\Adapter | | Uses | Phalcon\Storage\Adapter\AdapterInterface, SessionHandlerInterface | | Implements | SessionHandlerInterface |

This file is part of the Phalcon.

(c) Phalcon Team team@phalcon.com

For the full copyright and license information, please view the LICENSE file that was distributed with this source code.

Properties

/**
 * @var AdapterInterface
 */
protected adapter;

Methods

public function close(): bool;

Close

public function destroy( mixed $id ): bool;

Destroy

public function gc( mixed $maxlifetime ): bool;

Garbage Collector

public function open( mixed $savePath, mixed $sessionName ): bool;

Open

public function read( mixed $id ): string;

Read

public function write( mixed $id, mixed $data ): bool;

Write

Class Phalcon\Session\Adapter\Libmemcached

Source on GitHub

| Namespace | Phalcon\Session\Adapter | | Uses | Phalcon\Storage\AdapterFactory | | Extends | AbstractAdapter |

Phalcon\Session\Adapter\Libmemcached

Methods

public function __construct( AdapterFactory $factory, array $options = [] );

Constructor

Class Phalcon\Session\Adapter\Noop

Source on GitHub

| Namespace | Phalcon\Session\Adapter | | Uses | SessionHandlerInterface | | Implements | SessionHandlerInterface |

Phalcon\Session\Adapter\Noop

This is an "empty" or null adapter. It can be used for testing or any other purpose that no session needs to be invoked

<?php

use Phalcon\Session\Manager;
use Phalcon\Session\Adapter\Noop;

$session = new Manager();
$session->setAdapter(new Noop());

Properties

/**
 * The connection of some adapters
 */
protected connection;

/**
 * Session options
 *
 * @var array
 */
protected options;

/**
 * Session prefix
 *
 * @var string
 */
protected prefix = ;

/**
 * Time To Live
 *
 * @var int
 */
protected ttl = 8600;

Methods

public function __construct( array $options = [] );

Constructor

public function close(): bool;

Close

public function destroy( mixed $id ): bool;

Destroy

public function gc( mixed $maxlifetime ): bool;

Garbage Collector

public function open( mixed $savePath, mixed $sessionName ): bool;

Open

public function read( mixed $id ): string;

Read

public function write( mixed $id, mixed $data ): bool;

Write

protected function getPrefixedName( mixed $name ): string;

Helper method to get the name prefixed

Class Phalcon\Session\Adapter\Redis

Source on GitHub

| Namespace | Phalcon\Session\Adapter | | Uses | Phalcon\Storage\AdapterFactory | | Extends | AbstractAdapter |

Phalcon\Session\Adapter\Redis

Methods

public function __construct( AdapterFactory $factory, array $options = [] );

Constructor

Class Phalcon\Session\Adapter\Stream

Source on GitHub

| Namespace | Phalcon\Session\Adapter | | Uses | Phalcon\Helper\Str, Phalcon\Session\Exception | | Extends | Noop |

Phalcon\Session\Adapter\Stream

This is the file based adapter. It stores sessions in a file based system

<?php

use Phalcon\Session\Manager;
use Phalcon\Session\Adapter\Stream;

$session = new Manager();
$files = new Stream(
    [
        'savePath' => '/tmp',
    ]
);
$session->setAdapter($files);

Properties

/**
 * @var string
 */
private path = ;

Methods

public function __construct( array $options = [] );

//

public function destroy( mixed $id ): bool;

//

public function gc( mixed $maxlifetime ): bool;

//

public function open( mixed $savePath, mixed $sessionName ): bool;

Ignore the savePath and use local defined path

@return bool

public function read( mixed $id ): string;

//

public function write( mixed $id, mixed $data ): bool;

//

Class Phalcon\Session\Bag

Source on GitHub

| Namespace | Phalcon\Session | | Uses | Phalcon\Collection, Phalcon\Di, Phalcon\Di\DiInterface, Phalcon\Di\InjectionAwareInterface | | Extends | Collection | | Implements | InjectionAwareInterface |

Phalcon\Session\Bag

This component helps to separate session data into "namespaces". Working by this way you can easily create groups of session variables into the application

$user = new \Phalcon\Session\Bag("user");

$user->name = "Kimbra Johnson";
$user->age  = 22;

Properties

//
private container;

//
private name;

//
private session;

Methods

public function __construct( string $name );

Phalcon\Session\Bag constructor

public function clear(): void;

Destroys the session bag

public function getDI(): DiInterface;

Returns the DependencyInjector container

public function init( array $data = [] ): void;

Removes a property from the internal bag

public function remove( string $element ): void;

Removes a property from the internal bag

public function set( string $element, mixed $value ): void;

Sets a value in the session bag

public function setDI( DiInterface $container ): void;

Sets the DependencyInjector container

Class Phalcon\Session\Exception

Source on GitHub

| Namespace | Phalcon\Session | | Extends | \Phalcon\Exception |

Phalcon\Session\Exception

Exceptions thrown in Phalcon\Session will use this class

Class Phalcon\Session\Manager

Source on GitHub

| Namespace | Phalcon\Session | | Uses | InvalidArgumentException, RuntimeException, SessionHandlerInterface, Phalcon\Di\AbstractInjectionAware, Phalcon\Di\DiInterface, Phalcon\Helper\Arr | | Extends | AbstractInjectionAware | | Implements | ManagerInterface |

Phalcon\Session\Manager

Session manager class

Properties

/**
 * @var SessionHandlerInterface|null
 */
private adapter;

/**
 * @var string
 */
private name = ;

/**
 * @var array
 */
private options;

/**
 * @var string
 */
private uniqueId = ;

Methods

public function __construct( array $options = [] );

Manager constructor.

public function __get( string $key ): mixed;

Alias: Gets a session variable from an application context

public function __isset( string $key ): bool;

Alias: Check whether a session variable is set in an application context

public function __set( string $key, mixed $value ): void;

Alias: Sets a session variable in an application context

public function __unset( string $key ): void;

Alias: Removes a session variable from an application context

public function destroy(): void;

Destroy/end a session

public function exists(): bool;

Check whether the session has been started

public function get( string $key, mixed $defaultValue = null, bool $remove = bool ): mixed;

Gets a session variable from an application context

public function getAdapter(): SessionHandlerInterface;

Returns the stored session adapter

public function getId(): string;

Returns the session id

public function getName(): string;

Returns the name of the session

public function getOptions(): array;

Get internal options

public function has( string $key ): bool;

Check whether a session variable is set in an application context

public function regenerateId( mixed $deleteOldSession = bool ): ManagerInterface;

Regenerates the session id using the adapter.

public function remove( string $key ): void;

Removes a session variable from an application context

public function set( string $key, mixed $value ): void;

Sets a session variable in an application context

public function setAdapter( SessionHandlerInterface $adapter ): ManagerInterface;

Set the adapter for the session

public function setId( string $id ): ManagerInterface;

Set session Id

public function setName( string $name ): ManagerInterface;

Set the session name. Throw exception if the session has started and do not allow poop names

@throws InvalidArgumentException

@return Manager

public function setOptions( array $options ): void;

Sets session's options

public function start(): bool;

Starts the session (if headers are already sent the session will not be started)

public function status(): int;

Returns the status of the current session.

Interface Phalcon\Session\ManagerInterface

Source on GitHub

| Namespace | Phalcon\Session | | Uses | InvalidArgumentException, RuntimeException, SessionHandlerInterface |

Phalcon\Session

Interface for the Phalcon\Session\Manager

常量

const SESSION_ACTIVE = 2;
const SESSION_DISABLED = 0;
const SESSION_NONE = 1;

Methods

public function __get( string $key ): mixed;

Alias: Gets a session variable from an application context

public function __isset( string $key ): bool;

Alias: Check whether a session variable is set in an application context

public function __set( string $key, mixed $value ): void;

Alias: Sets a session variable in an application context

public function __unset( string $key ): void;

Alias: Removes a session variable from an application context

public function destroy(): void;

Destroy/end a session

public function exists(): bool;

Check whether the session has been started

public function get( string $key, mixed $defaultValue = null, bool $remove = bool ): mixed;

Gets a session variable from an application context

public function getAdapter(): SessionHandlerInterface;

Returns the stored session adapter

public function getId(): string;

Returns the session id

public function getName(): string;

Returns the name of the session

public function getOptions(): array;

Get internal options

public function has( string $key ): bool;

Check whether a session variable is set in an application context

public function regenerateId( mixed $deleteOldSession = bool ): ManagerInterface;

Regenerates the session id using the adapter.

public function remove( string $key ): void;

Removes a session variable from an application context

public function set( string $key, mixed $value ): void;

Sets a session variable in an application context

public function setAdapter( SessionHandlerInterface $adapter ): ManagerInterface;

Set the adapter for the session

public function setId( string $id ): ManagerInterface;

Set session Id

public function setName( string $name ): ManagerInterface;

Set the session name. Throw exception if the session has started and do not allow poop names

@throws InvalidArgumentException

public function setOptions( array $options ): void;

Sets session's options

public function start(): bool;

Starts the session (if headers are already sent the session will not be started)

public function status(): int;

Returns the status of the current session.