# wp_json_file_decode()

URL: https://chugunov.pro/api-wordpress/functions/wp_json_file_decode/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 5.9.0.

## Сигнатура

```php
wp_json_file_decode( string $filename, array $options = array() ): mixed
```

## Описание

Читает и декодирует JSON-файл.

## Параметры

- `$filename` `string` — обязательный. Путь к JSON-файлу.
- `$options` `array` — необязательный, по умолчанию `array()`. Опции, используемые с json_decode().
  
  associative bool Необязательно. Если true, объекты JSON будут возвращены в виде ассоциативных массивов.
  
  Если false, объекты JSON будут возвращены в виде объектов. Значение по умолчанию false.

## Возвращаемое значение

`mixed` — null

## Исходный код

Файл: `wp-includes/functions.php:4676`

```php
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;
}
```

## История изменений

- 5.9.0 — Introduced.

## Связанные

Использует: [`wp_trigger_error`](https://chugunov.pro/api-wordpress/functions/wp_trigger_error/), [`wp_normalize_path`](https://chugunov.pro/api-wordpress/functions/wp_normalize_path/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/).
Используется в: `WP_Font_Collection::load_from_file`, [`get_block_metadata_i18n_schema`](https://chugunov.pro/api-wordpress/functions/get_block_metadata_i18n_schema/), `WP_Theme_JSON_Resolver::read_json_file`, `WP_Theme_JSON_Resolver::translate`, [`register_block_type_from_metadata`](https://chugunov.pro/api-wordpress/functions/register_block_type_from_metadata/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_json_file_decode/