Parses and extracts the namespace and reference path from the given directive attribute value.
Description
If the value doesn't contain an explicit namespace, it returns the default one. If the value contains a JSON object instead of a reference path, the function tries to parse it and return the resulting array. If the value contains strings that represent booleans ("true" and "false"), numbers ("1" and "1.2") or "null", the function also transform them to regular booleans, numbers and null. Example: extract_directive_value( 'actions.foo', 'myPlugin' ) => array( 'myPlugin', 'actions.foo' )
extract_directive_value( 'otherPlugin::actions.foo', 'myPlugin' ) => array( 'otherPlugin', 'actions.foo' )
extract_directive_value( '{ "isOpen": false }', 'myPlugin' ) => array( 'myPlugin', array( 'isOpen' => false ) )
extract_directive_value( 'otherPlugin::{ "isOpen": false }', 'myPlugin' ) => array( 'otherPlugin', array( 'isOpen' => false ) )
Parameters
$directive_valuestring|true
The directive attribute value. It can be true when it's a boolean attribute.
$default_namespacestring|nulloptional
The default namespace if none is explicitly defined.Default: null
Return
array
An array containing the namespace in the first item and the JSON, the reference path, or null on the second item.
850privatefunctionextract_directive_value($directive_value,$default_namespace=null):array{851if(empty($directive_value)||is_bool($directive_value)){852returnarray($default_namespace,null);853}854855// Replaces the value and namespace if there is a namespace in the value.856if(1===preg_match('/^([\w\-_\/]+)::./',$directive_value)){857list($default_namespace,$directive_value)=explode('::',$directive_value,2);858}859860/*861 * Tries to decode the value as a JSON object. If it fails and the value862 * isn't `null`, it returns the value as it is. Otherwise, it returns the863 * decoded JSON or null for the string `null`.864 */865$decoded_json=json_decode($directive_value,true);866if(null!==$decoded_json||'null'===$directive_value){867$directive_value=$decoded_json;868}869870returnarray($default_namespace,$directive_value);871}
History
Introduced in 6.5.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
About this page
Parsed data
Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/interactivity-api/class-wp-interactivity-api.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.