wp_json_encode:WordPress私的マニュアル

wp_json_encode

(4.1.0以降)
wp_json_encode - データをJSON形式にエンコードする

説明

mixed wp_json_encode( mixed $data [ , int $options = 0 [ , int $depth = 512 ] ] )

データをJSON形式にエンコードする。

パラメータ

$data
データを指定。
$options
エンコードオプション値を指定（省略時は0）。詳細はJSON定義済み定数を参照。
$depth
最大の深さを指定（省略時は512）。

返り値

パラメータ$dataをJSON形式にエンコードした文字列を返す。無効なデータの場合はfalseを返す。

注意

基本的にjson_encode関数を使用するが、PHPのバージョンによってパラメータ数が変わるため、この関数を使用することでバージョンの違いを吸収できる。またjson_encode関数ではデータに含まれる文字列はUTF-8でなければならないが、本関数の内部では他の文字エンコードの場合はUTF-8に変換しているため、任意の文字エンコードの文字列を使用できる。

使用例

変数$dataをJSON形式にエンコードする。
<?php $json = wp_json_encode( $data ); ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/functions.php

参考

Code Reference: wp_json_encode

お勧めコンテンツ

決まった値を返すだけの関数群（2015年7月15日登録）

WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。

HTML entities button：プラグイン作ってみました（2011年6月29日登録）

以前投稿した「HTML編集モードに定型文ボタンを追加する」をアレンジして、HTML編集モードに特殊文字（HTMLエンティティ）を挿入できるボタン、顔文字を挿入できるボタン、過去の投稿ページのリンクを挿入できるボタンを追加するプラグインを作ってみました。HTML編集モードの作業効率を向上させるプラグインです。2.1.0では「Dashiconsの挿入」を追加しました。HTML編集モードをメインに使用されている方は、お試しあれ。

ダッシュボードのフィードボックスをカスタマイズ（2011年7月8日登録）

管理者ページのトップページ「ダッシュボード」には、「WordPress 開発者ブログ」と「WordPress フォーラム」という2つのフィードボックスが表示されている。自分のような開発者には有益な情報をもたらしているが、一般の方には必要のない情報かもしれない。今回はこのフィードボックスをカスタマイズする方法を紹介する（管理者権限）。

プラグインのヘッダー情報を国際化対応しよう（2017年6月19日登録）

バージョン4.8がリリースされてひと段落。あらためてプラグイン一覧ページを見てみると「Akismet」が「Akismet Anti-Spam (アンチスパム)」と表示されていた。説明文だけじゃなくプラグイン名も国際化対応できたのね。

HTML編集モードに定型文ボタンを追加する（2011年6月1日登録）

投稿編集ページにはビジュアル編集モードとHTML編集モードがあり、それらを拡張するプラグインも多数存在している。そういったプラグインを利用するのもいいのだが、仕組みを理解するのも悪くないはず。というわけで、ここではHTML編集モードのボタンの仕組みと定型文を挿入するボタンを追加する方法を紹介する。