Phalcon Session

Session\Adapter\AbstractAdapter

This file is part of the Phalcon Framework.

(c) Phalcon Team <[email protected]>

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

Uses Phalcon\Storage\Adapter\AdapterInterface · SessionHandlerInterface

Method Summary

Properties

Methods

close()

public function close(): bool;

Close

destroy()

public function destroy( mixed $id ): bool;

Destroy

gc()

public function gc( int $max_lifetime ): int|false;

Garbage Collector

open()

public function open(
    mixed $path,
    mixed $name
): bool;

Open

read()

public function read( mixed $id ): string;

Read

write()

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

Write

getArrVal()

protected function getArrVal(
    array $collection,
    mixed $index,
    mixed $defaultValue = null
): mixed;

@todo Remove this when we get traits

Session\Adapter\Exceptions\AdapterRuntimeError

This file is part of the Phalcon Framework.

(c) Phalcon Team <[email protected]>

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

Uses Phalcon\Session\Exception

Session\Adapter\Exceptions\InvalidSavePath

This file is part of the Phalcon Framework.

(c) Phalcon Team <[email protected]>

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

Uses Phalcon\Session\Exception

Method Summary

Methods

__construct()

public function __construct();

Session\Adapter\Exceptions\SavePathUnavailable

This file is part of the Phalcon Framework.

(c) Phalcon Team <[email protected]>

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

Uses Phalcon\Session\Exception

Method Summary

Methods

__construct()

public function __construct( string $path );

Session\Adapter\Libmemcached

Phalcon\Session\Adapter\Libmemcached

Uses Phalcon\Storage\AdapterFactory

Method Summary

Methods

__construct()

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

Libmemcached constructor.

] ], ‘defaultSerializer’ => ‘Php’, ‘lifetime’ => 3600, ‘serializer’ => null, ‘prefix’ => ‘sess-memc-’ ]

Session\Adapter\Noop

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());

Uses SessionHandlerInterface

Method Summary

Methods

close()

public function close(): bool;

Close

destroy()

public function destroy( mixed $id ): bool;

Destroy

gc()

public function gc( int $max_lifetime ): int|false;

Garbage Collector

open()

public function open(
    mixed $path,
    mixed $name
): bool;

Open

read()

public function read( mixed $id ): string;

Read

write()

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

Write

Session\Adapter\Redis

Phalcon\Session\Adapter\Redis

Uses Phalcon\Storage\AdapterFactory

Method Summary

Methods

__construct()

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

Constructor

Session\Adapter\Stream

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);

@property array $options @property string $prefix @property string $path

Uses Phalcon\Session\Adapter\Exceptions\AdapterRuntimeError · Phalcon\Session\Adapter\Exceptions\InvalidSavePath · Phalcon\Session\Adapter\Exceptions\SavePathUnavailable

Method Summary

Properties

Methods

__construct()

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

Constructor

destroy()

public function destroy( mixed $id ): bool;

gc()

public function gc( int $max_lifetime ): int|false;

Garbage Collector

open()

public function open(
    mixed $path,
    mixed $name
): bool;

Ignore the savePath and use local defined path

read()

public function read( mixed $id ): string;

Reads data from the adapter

write()

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

getArrVal()

protected function getArrVal(
    array $collection,
    mixed $index,
    mixed $defaultValue = null,
    string $cast = null
): mixed;

@todo Remove this when we get traits

getGlobFiles()

protected function getGlobFiles( string $pattern ): array|false;

Gets the glob array or returns false on failure

getPrefixedName()

protected function getPrefixedName( mixed $name ): string;

Helper method to get the name prefixed

phpFileExists()

protected function phpFileExists( string $filename );

@link https://php.net/manual/en/function.file-exists.php

phpFileGetContents()

protected function phpFileGetContents( string $filename );

@link https://php.net/manual/en/function.file-get-contents.php

phpFilePutContents()

protected function phpFilePutContents(
    string $filename,
    mixed $data,
    int $flags = 0,
    mixed $context = null
);

@link https://php.net/manual/en/function.file-put-contents.php

phpFopen()

protected function phpFopen(
    string $filename,
    string $mode
);

@link https://php.net/manual/en/function.fopen.php

phpIniGet()

protected function phpIniGet( string $varname ): string;

Gets the value of a configuration option

@link https://php.net/manual/en/function.ini-get.php @link https://php.net/manual/en/ini.list.php

phpIsWritable()

protected function phpIsWritable( string $filename ): bool;

Tells whether the filename is writable

@link https://php.net/manual/en/function.is-writable.php

Session\Bag

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;

@property DiInterface|null $container @property string $name @property ManagerInterface $session;

Uses Phalcon\Di\Di · Phalcon\Di\DiInterface · Phalcon\Di\InjectionAwareInterface · Phalcon\Session\ManagerInterface · Phalcon\Support\Collection

Method Summary

Methods

__construct()

public function __construct(
    ManagerInterface $session,
    string $name
);

clear()

public function clear(): void;

Destroys the session bag

getDI()

public function getDI(): DiInterface;

Returns the DependencyInjector container

init()

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

Initialize internal array

remove()

public function remove( string $element ): void;

Removes a property from the internal bag

set()

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

Sets a value in the session bag

setDI()

public function setDI( DiInterface $container ): void;

Sets the DependencyInjector container

Session\BagInterface

Phalcon\Session\BagInterface

Interface for Phalcon\Session\Bag

Method Summary

Methods

__get()

public function __get( string $element ): mixed;

__isset()

public function __isset( string $element ): bool;

__set()

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

__unset()

public function __unset( string $element ): void;

clear()

public function clear(): void;

get()

public function get(
    string $element,
    mixed $defaultValue = null,
    string $cast = null
): mixed;

has()

public function has( string $element ): bool;

init()

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

remove()

public function remove( string $element ): void;

set()

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

Session\Exception

Phalcon\Session\Exception

Exceptions thrown in Phalcon\Session will use this class

Session\Exceptions\InvalidSessionAdapter

This file is part of the Phalcon Framework.

(c) Phalcon Team <[email protected]>

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

Uses Phalcon\Session\Exception

Method Summary

Methods

__construct()

public function __construct();

Session\Exceptions\InvalidSessionName

This file is part of the Phalcon Framework.

(c) Phalcon Team <[email protected]>

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

Uses Phalcon\Session\Exception

Method Summary

Methods

__construct()

public function __construct();

Session\Exceptions\SessionAlreadyStarted

This file is part of the Phalcon Framework.

(c) Phalcon Team <[email protected]>

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

Uses Phalcon\Session\Exception

Method Summary

Methods

__construct()

public function __construct();

Session\Exceptions\SessionModificationDenied

This file is part of the Phalcon Framework.

(c) Phalcon Team <[email protected]>

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

Uses Phalcon\Session\Exception

Method Summary

Methods

__construct()

public function __construct();

Session\Manager

@property SessionHandlerInterface|null $adapter @property string $name @property array $options @property string $uniqueId

Uses InvalidArgumentException · Phalcon\Di\AbstractInjectionAware · Phalcon\Di\DiInterface · Phalcon\Session\Exceptions\InvalidSessionAdapter · Phalcon\Session\Exceptions\InvalidSessionName · Phalcon\Session\Exceptions\SessionAlreadyStarted · Phalcon\Session\Exceptions\SessionModificationDenied · SessionHandlerInterface

Method Summary

Methods

__construct()

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

Manager constructor.

__get()

public function __get( string $key ): mixed;

Alias: Gets a session variable from an application context

__isset()

public function __isset( string $key ): bool;

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

__set()

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

Alias: Sets a session variable in an application context

__unset()

public function __unset( string $key ): void;

Alias: Removes a session variable from an application context

destroy()

public function destroy(): void;

Destroy/end a session

exists()

public function exists(): bool;

Check whether the session has been started

get()

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

Gets a session variable from an application context

getAdapter()

public function getAdapter(): SessionHandlerInterface|null;

Returns the stored session adapter

getId()

public function getId(): string;

Returns the session id

getName()

public function getName(): string;

Returns the name of the session

getOptions()

public function getOptions(): array;

Get internal options

has()

public function has( string $key ): bool;

Check whether a session variable is set in an application context

regenerateId()

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

Regenerates the session id using the adapter.

remove()

public function remove( string $key ): void;

Removes a session variable from an application context

set()

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

Sets a session variable in an application context

setAdapter()

public function setAdapter( SessionHandlerInterface $adapter ): ManagerInterface;

Set the adapter for the session

setId()

public function setId( string $sessionId ): ManagerInterface;

Set session Id

setName()

public function setName( string $name ): ManagerInterface;

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

setOptions()

public function setOptions( array $options ): void;

Sets session’s options

start()

public function start(): bool;

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

status()

public function status(): int;

Returns the status of the current session.

phpHeadersSent()

protected function phpHeadersSent(): bool;

Checks if or where headers have been sent

@link https://php.net/manual/en/function.headers-sent.php

Session\ManagerInterface

Phalcon\Session

Interface for the Phalcon\Session\Manager

Uses InvalidArgumentException · SessionHandlerInterface

Method Summary

Constants

Methods

__get()

public function __get( string $key ): mixed;

Alias: Gets a session variable from an application context

__isset()

public function __isset( string $key ): bool;

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

__set()

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

Alias: Sets a session variable in an application context

__unset()

public function __unset( string $key ): void;

Alias: Removes a session variable from an application context

destroy()

public function destroy(): void;

Destroy/end a session

exists()

public function exists(): bool;

Check whether the session has been started

get()

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

Gets a session variable from an application context

getAdapter()

public function getAdapter(): SessionHandlerInterface|null;

Returns the stored session adapter

getId()

public function getId(): string;

Returns the session id

getName()

public function getName(): string;

Returns the name of the session

getOptions()

public function getOptions(): array;

Get internal options

has()

public function has( string $key ): bool;

Check whether a session variable is set in an application context

regenerateId()

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

Regenerates the session id using the adapter.

remove()

public function remove( string $key ): void;

Removes a session variable from an application context

set()

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

Sets a session variable in an application context

setAdapter()

public function setAdapter( SessionHandlerInterface $adapter ): ManagerInterface;

Set the adapter for the session

setId()

public function setId( string $sessionId ): ManagerInterface;

Set session Id

setName()

public function setName( string $name ): ManagerInterface;

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

setOptions()

public function setOptions( array $options ): void;

Sets session’s options

start()

public function start(): bool;

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

status()

public function status(): int;

Returns the status of the current session.