wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_json_file_decode › WordPress Function

Since5.9.0
Deprecatedn/a
wp_json_file_decode ( $filename, $options = array() )
Parameters: (2)
  • (string) $filename Path to the JSON file.
    Required: Yes
  • (array) $options { Optional. Options to be used with `json_decode()`. @type bool $associative Optional. When `true`, JSON objects will be returned as associative arrays. When `false`, JSON objects will be returned as objects. Default false. }
    Required: No
    Default: array()
Returns:
  • (mixed) Returns the value encoded in JSON in appropriate PHP type. `null` is returned if the file is not found, or its content can't be decoded.
Defined at:
Codex:

Reads and decodes a JSON file.



Source

function wp_json_file_decode( $filename, $options = array() ) {
	$result   = null;
	$filename = wp_normalize_path( realpath( $filename ) );

	if ( ! $filename ) {
		wp_trigger_error(
			__FUNCTION__,
			sprintf(
				/* translators: %s: Path to the JSON file. */
				__( "File %s doesn't exist!" ),
				$filename
			)
		);
		return $result;
	}

	$options      = wp_parse_args( $options, array( 'associative' => false ) );
	$decoded_file = json_decode( file_get_contents( $filename ), $options['associative'] );

	if ( JSON_ERROR_NONE !== json_last_error() ) {
		wp_trigger_error(
			__FUNCTION__,
			sprintf(
				/* translators: 1: Path to the JSON file, 2: Error message. */
				__( 'Error when decoding a JSON file at path %1$s: %2$s' ),
				$filename,
				json_last_error_msg()
			)
		);
		return $result;
	}

	return $decoded_file;
}