AttributeMapping
in package
implements
JsonSerializable
One entry of an SP's attribute mapping table.
Table of Contents
Interfaces
- JsonSerializable
Properties
- $nameFormat : string|null
- $samlName : string
- $source : AttributeSource
Methods
- __construct() : mixed
- Constructs a AttributeMapping.
- fromArray() : self
- Rebuilds a AttributeMapping from one decoded JSON object.
- jsonSerialize() : array<string, mixed>
- Renders this object for `json_encode()`.
- toArray() : array<string, mixed>
- Renders this object back to its wire form.
- unknownEnumValue() : string|null
- The string the server sent for an open-enum member this SDK has no name for, or `null`.
Properties
$nameFormat read-only
public
string|null
$nameFormat
= null
$samlName read-only
public
string
$samlName
$source read-only
public
AttributeSource
$source
Methods
__construct()
Constructs a AttributeMapping.
public
__construct(string $samlName, AttributeSource $source[, string|null $nameFormat = null ]) : mixed
Parameters
- $samlName : string
-
The
Nameof the emitted<saml:Attribute>. Unique within one SP, compared exactly (SAML attribute names are case-sensitive). - $source : AttributeSource
-
Where the value comes from.
- $nameFormat : string|null = null
-
The
NameFormat, one of [ATTRIBUTE_NAME_FORMATS].Noneleaves the attribute unqualified (unspecified). (optional)
fromArray()
Rebuilds a AttributeMapping from one decoded JSON object.
public
static fromArray(array<string, mixed> $data) : self
Parameters
- $data : array<string, mixed>
-
The raw wire object.
Return values
selfjsonSerialize()
Renders this object for `json_encode()`.
public
jsonSerialize() : array<string, mixed>
Any Sensitive it carries stays WRAPPED here, so a log line or a
json_encode($model) in application code prints [SENSITIVE]. The one place a secret
is revealed is ManagementTransport, on the way to the wire
and nowhere else (§27.5).
Rendering for a log line never fails: an unknown union arm renders its discriminator and
an unrecognised enum value its empty Unknown spelling here, and only self::toArray() -- the request path -- refuses to send it (CONTRACT.md §31.2, §34.2
P12.2).
Return values
array<string, mixed>toArray()
Renders this object back to its wire form.
public
toArray() : array<string, mixed>
§27.4 rule 5: a null property is OMITTED, not emitted as null. On a sparse update those two say opposite things — "leave this alone" versus "set this to nothing" — and only omission means the first.
Return values
array<string, mixed>unknownEnumValue()
The string the server sent for an open-enum member this SDK has no name for, or `null`.
public
unknownEnumValue(string $wire) : string|null
Only a model decoded by self::fromArray() knows it, and only for a member that
decoded to Unknown (CONTRACT.md §27.6.2 item 4, §34.8 (c)): it lets a refusal name the
value. It is for messages -- it is never rendered by self::toArray() or self::jsonSerialize() and so is never sent.
Parameters
- $wire : string
-
The member's wire name.