JsonNull
in package
An explicit JSON `null`, as distinct from an ABSENT member (CONTRACT.md §27.4 rule 5, "null is not absent").
Everywhere else on the §27 surface a PHP null property means "absent" and is left out of
the wire body. A handful of fields need the third state, and only those declare
T|JsonNull|null:
UpdateDirectoryConfig::$groupBaseDn/$groupFilter(§30.2):nullleaves the stored value alone,JsonNull::Nullsendsnulland clears it —new UpdateDirectoryConfig(groupFilter: JsonNull::Null)sends exactly{"group_filter": null}.UpdateFederationConfigRequest's ten clearable members (§27.15 note 8, contract 1.60):$metadataUrl,$idpSigningCertPem,$idpMetadataSigningCertPem,$providerSlug,$authorizationEndpoint,$tokenEndpoint,$userinfoEndpoint,$appleTeamId,$appleKeyIdand$buttonIcon.nullleaves the stored value unchanged;new UpdateFederationConfigRequest(buttonIcon: JsonNull::Null)sends exactly{"button_icon": null}and clears it.SamlIdpInfo::$activeCredentialId/$nextCredentialId(§29.8 test 8): decoded asJsonNull::Nullwhen the server saidnull(the slot is empty), and as PHPnullonly when it sent no such member.
Table of Contents
Cases
- Null
- The JSON literal `null`.
Cases
Null
The JSON literal `null`.