CakePHP
  • Documentation
    • Book
    • API
    • Videos
    • Reporting Security Issues
    • Privacy Policy
    • Logos & Trademarks
  • Business Solutions
  • Swag
  • Road Trip
  • Team
  • Community
    • Community
    • Get Involved
    • Issues (Github)
    • Bakery
    • Featured Resources
    • Training
    • Meetups
    • My CakePHP
    • CakeFest
    • Newsletter
    • Linkedin
    • YouTube
    • Facebook
    • Twitter
    • Mastodon
    • Help & Support
    • Forum
    • Stack Overflow
    • IRC
    • Slack
    • Paid Support
CakePHP

C Authentication 3.x API

  • Project:
    • Authentication
      • CakePHP
      • Authentication
      • Authorization
      • Chronos
      • Elastic Search
      • Queue
  • Version:
    • 3.x
      • 3.x
      • 2.x

Namespaces

  • Authentication
    • Authenticator
    • Controller
    • Identifier
    • Middleware
    • PasswordHasher
    • UrlChecker
    • View

Class Identity

Identity object

Namespace: Authentication

Property Summary

  • $_config protected
    array<string, mixed>

    Runtime config

  • $_configInitialized protected
    bool

    Whether the config property has already been configured with defaults

  • $_defaultConfig protected
    array

    Default configuration.

  • $data protected
    ArrayAccess|array

    Identity data

Method Summary

  • __construct() public

    Constructor

  • __debugInfo() public

    Debug info

  • __get() public

    Get data from the identity using object access.

  • __isset() public

    Check if the field isset() using object access.

  • _configDelete() protected

    Deletes a single config key.

  • _configRead() protected

    Reads a config key.

  • _configWrite() protected

    Writes a config key.

  • configShallow() public

    Merge provided config with existing config. Unlike config() which does a recursive merge for nested keys, this method does a simple merge.

  • get() public

    Get data from the identity

  • getConfig() public

    Returns the config.

  • getConfigOrFail() public

    Returns the config for this specific key.

  • getIdentifier() public

    Get the primary key/id field for the identity.

  • getOriginalData() public

    Gets the original data object.

  • offsetExists() public

    Whether a offset exists

  • offsetGet() public

    Offset to retrieve

  • offsetSet() public

    Offset to set

  • offsetUnset() public

    Offset to unset

  • setConfig() public

    Sets the config.

Method Detail

__construct() ¶ public

__construct(ArrayAccess|array $data, array $config = [])

Constructor

Parameters
ArrayAccess|array $data

Identity data

array $config optional

Config options

__debugInfo() ¶ public

__debugInfo(): array

Debug info

Returns
array

__get() ¶ public

__get(string $field): mixed

Get data from the identity using object access.

Parameters
string $field

Field in the user data.

Returns
mixed

__isset() ¶ public

__isset(string $field): bool

Check if the field isset() using object access.

Parameters
string $field

Field in the user data.

Returns
bool

_configDelete() ¶ protected

_configDelete(string $key): void

Deletes a single config key.

Parameters
string $key

Key to delete.

Returns
void
Throws
Cake\Core\Exception\CakeException
if attempting to clobber existing config

_configRead() ¶ protected

_configRead(string|null $key): mixed

Reads a config key.

Parameters
string|null $key

Key to read.

Returns
mixed

_configWrite() ¶ protected

_configWrite(array<string, mixed>|string $key, mixed $value, string|bool $merge = false): void

Writes a config key.

Parameters
array<string, mixed>|string $key

Key to write to.

mixed $value

Value to write.

string|bool $merge optional

True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.

Returns
void
Throws
Cake\Core\Exception\CakeException
if attempting to clobber existing config

configShallow() ¶ public

configShallow(array<string, mixed>|string $key, mixed|null $value = null): $this

Merge provided config with existing config. Unlike config() which does a recursive merge for nested keys, this method does a simple merge.

Setting a specific value:

$this->configShallow('key', $value);

Setting a nested value:

$this->configShallow('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->configShallow(['one' => 'value', 'another' => 'value']);
Parameters
array<string, mixed>|string $key

The key to set, or a complete array of configs.

mixed|null $value optional

The value to set.

Returns
$this

get() ¶ public

get(string $field): mixed

Get data from the identity

Parameters
string $field

Field in the user data.

Returns
mixed

getConfig() ¶ public

getConfig(string|null $key = null, mixed $default = null): mixed

Returns the config.

Usage

Reading the whole config:

$this->getConfig();

Reading a specific value:

$this->getConfig('key');

Reading a nested value:

$this->getConfig('some.nested.key');

Reading with default value:

$this->getConfig('some-key', 'default-value');
Parameters
string|null $key optional

The key to get or null for the whole config.

mixed $default optional

The return value when the key does not exist.

Returns
mixed

getConfigOrFail() ¶ public

getConfigOrFail(string $key): mixed

Returns the config for this specific key.

The config value for this key must exist, it can never be null.

Parameters
string $key

The key to get.

Returns
mixed
Throws
InvalidArgumentException

getIdentifier() ¶ public

getIdentifier(): array|string|int|null

Get the primary key/id field for the identity.

Returns
array|string|int|null

getOriginalData() ¶ public

getOriginalData(): ArrayAccess|array

Gets the original data object.

Returns
ArrayAccess|array

offsetExists() ¶ public

offsetExists(mixed $offset): bool

Whether a offset exists

Parameters
mixed $offset

Offset

Returns
bool
Links
https://php.net/manual/en/arrayaccess.offsetexists.php

offsetGet() ¶ public

offsetGet(mixed $offset): Authentication\IdentityInterface|null

Offset to retrieve

Parameters
mixed $offset

Offset

Returns
Authentication\IdentityInterface|null
Links
https://php.net/manual/en/arrayaccess.offsetget.php

offsetSet() ¶ public

offsetSet(mixed $offset, mixed $value): void

Offset to set

Parameters
mixed $offset

The offset to assign the value to.

mixed $value

Value

Returns
void
Throws
BadMethodCallException
Links
https://php.net/manual/en/arrayaccess.offsetset.php

offsetUnset() ¶ public

offsetUnset(mixed $offset): void

Offset to unset

Parameters
mixed $offset

Offset

Returns
void
Throws
BadMethodCallException
Links
https://php.net/manual/en/arrayaccess.offsetunset.php

setConfig() ¶ public

setConfig(array<string, mixed>|string $key, mixed|null $value = null, bool $merge = true): $this

Sets the config.

Usage

Setting a specific value:

$this->setConfig('key', $value);

Setting a nested value:

$this->setConfig('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->setConfig(['one' => 'value', 'another' => 'value']);
Parameters
array<string, mixed>|string $key

The key to set, or a complete array of configs.

mixed|null $value optional

The value to set.

bool $merge optional

Whether to recursively merge or overwrite existing config, defaults to true.

Returns
$this
Throws
Cake\Core\Exception\CakeException
When trying to set a key that is invalid.

Property Detail

$_config ¶ protected

Runtime config

Type
array<string, mixed>

$_configInitialized ¶ protected

Whether the config property has already been configured with defaults

Type
bool

$_defaultConfig ¶ protected

Default configuration.

  • fieldMap Mapping of fields
Type
array

$data ¶ protected

Identity data

Type
ArrayAccess|array
OpenHub
Pingping
Linode
  • Business Solutions
  • Showcase
  • Documentation
  • Book
  • API
  • Videos
  • Reporting Security Issues
  • Privacy Policy
  • Logos & Trademarks
  • Community
  • Get Involved
  • Issues (Github)
  • Bakery
  • Featured Resources
  • Training
  • Meetups
  • My CakePHP
  • CakeFest
  • Newsletter
  • Linkedin
  • YouTube
  • Facebook
  • Twitter
  • Mastodon
  • Help & Support
  • Forum
  • Stack Overflow
  • IRC
  • Slack
  • Paid Support

Generated using CakePHP API Docs