php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-01 11:39:41 +08:00
Code Issues Packages Projects Releases Wiki Activity

Fix JA guide page (#18958)

Browse Source
This commit is contained in:
Bizley
2021-10-19 19:24:34 +02:00
committed by GitHub
parent 0041f034fd
commit f5973acd08
1 changed files with 13 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
docs/guide-ja/helper-json.md
View File

@ -1,26 +1,25 @@
Json <EFBFBD>w<EFBFBD><EFBFBD><EFBFBD>p
Json ヘルパ
===========
Json <EFBFBD>w<EFBFBD><EFBFBD><EFBFBD>p<EFBFBD><EFBFBD> JSON <20><><EFBFBD>G<EFBFBD><47><EFBFBD>R<EFBFBD>[<5B>h<EFBFBD><68><EFBFBD><EFBFBD>уf<D183>R<EFBFBD>[<5B>h<EFBFBD><68><EFBFBD><EFBFBD><EFBFBD>A<EFBFBD>̐ÓI<C393><49><EFBFBD>\<5C>b<EFBFBD>h<EFBFBD><68>񋟂<EFBFBD><F18B9F82>܂<EFBFBD><DC82>B
`[[yii\helpers\Json::encode()]]` <EFBFBD><EFBFBD><EFBFBD>\<5C>b<EFBFBD>h<EFBFBD>̓G<CD83><47><EFBFBD>R<EFBFBD>[<5B>h<EFBFBD>E<EFBFBD>G<EFBFBD><47><EFBFBD>[<5B><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>܂<EFBFBD><DC82><EFBFBD><EFBFBD>A
`[[yii\web\JsExpression]]` <EFBFBD>I<EFBFBD>u<EFBFBD>W<EFBFBD>F<EFBFBD>N<EFBFBD>g<EFBFBD>̌`<60><><EFBFBD>ŕ\<5C><><EFBFBD><EFBFBD><EFBFBD>ꂽ JavaScript <20>̎<EFBFBD><CC8E>̓G<CD83><47><EFBFBD>R<EFBFBD>[<5B>h<EFBFBD><68><EFBFBD>܂<EFBFBD><DC82><EFBFBD>B
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ł̓G<EFBFBD><EFBFBD><EFBFBD>R<EFBFBD>[<5B>h<EFBFBD><68> `JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE` <20>̃I<CC83>v<EFBFBD>V<EFBFBD><56><EFBFBD><EFBFBD><EFBFBD>ōs<C58D><73><EFBFBD>܂<EFBFBD><DC82>B
<EFBFBD>ڍׂɂ‚<EFBFBD><EFBFBD>Ă<EFBFBD> [PHP:json_encode](https://www.php.net/manual/ja/function.json-encode.php) <EFBFBD><EFBFBD><EFBFBD>Q<EFBFBD>Ƃ<EFBFBD><EFBFBD>ĉ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>B
Json ヘルパは JSON をエンコードおよびデコードする一連の静的メソッドを提供します。
`[[yii\helpers\Json::encode()]]` メソッドはエンコード・エラーを処理しますが、
`[[yii\web\JsExpression]]` オブジェクトの形式で表現された JavaScript の式はエンコードしません。
既定ではエンコードは `JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE` のオプションで行われます。
詳細については [PHP:json_encode](https://www.php.net/manual/ja/function.json-encode.php) を参照して下さい。
## <EFBFBD><EFBFBD><EFBFBD>`<EFBFBD>o<EFBFBD><EFBFBD> <span id="pretty-print"></span>
## 整形出力 <span id="pretty-print"></span>
<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ł<EFBFBD> `[[yii\helpers\Json::encode()]]` <EFBFBD><EFBFBD><EFBFBD>\<5C>b<EFBFBD>h<EFBFBD>͐<EFBFBD><CD90>`<60><><EFBFBD><EFBFBD>Ă<EFBFBD><C482>Ȃ<EFBFBD> JSON (<28><><EFBFBD>Ȃ킿<C882>󔒖<EFBFBD><F3949296><EFBFBD><EFBFBD>̂<EFBFBD><CC82><EFBFBD>) <20><><EFBFBD>o<EFBFBD>͂<EFBFBD><CD82>܂<EFBFBD><DC82>B
<EFBFBD>l<EFBFBD>ԂɂƂ<EFBFBD><EFBFBD>ēǂ݂₷<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>̂ɂ<EFBFBD><EFBFBD>邽<EFBFBD>߂ɁA<EFBFBD>u<EFBFBD><EFBFBD><EFBFBD>`<EFBFBD>o<EFBFBD><EFBFBD> pretty printing<6E>v<EFBFBD><76> ON <20>ɂ<EFBFBD><C982>邱<EFBFBD>Ƃ<EFBFBD><C682>o<EFBFBD><6F><EFBFBD>܂<EFBFBD><DC82>B
既定では `[[yii\helpers\Json::encode()]]` メソッドは整形されていない JSON (すなわち空白無しのもの) を出力します。
人間にとって読みやすいものにするために、「整形出力 pretty printing」を ON にすることが出来ます。
> Note: <EFBFBD><EFBFBD><EFBFBD>`<60>o<EFBFBD>͂͊J<CD8A><4A><EFBFBD><EFBFBD><EFBFBD>̃f<CC83>o<EFBFBD>b<EFBFBD>O<EFBFBD>ɂ͖𗧂‚ł<C282><C582>傤<EFBFBD><E582A4><EFBFBD>A<EFBFBD><41><EFBFBD>i<EFBFBD>‹<EFBFBD><C28B>ł͐<C582><CD90><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>܂<EFBFBD><DC82><EFBFBD>B
<EFBFBD>C<EFBFBD><EFBFBD><EFBFBD>X<EFBFBD>^<5E><><EFBFBD>X<EFBFBD><58><EFBFBD>Ƃɐ<C682><C990>`<60>o<EFBFBD>͂<EFBFBD>L<EFBFBD><4C><EFBFBD>ɂ<EFBFBD><C982>邽<EFBFBD>߂ɂ̓I<CD83>v<EFBFBD>V<EFBFBD><56><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>w<EFBFBD>肷<EFBFBD>邱<EFBFBD>Ƃ<EFBFBD><C682>o<EFBFBD><6F><EFBFBD>܂<EFBFBD><DC82>B<EFBFBD><42><EFBFBD>Ȃ킿 :
> Note: 整形出力は開発中のデバッグには役立つでしょうが、製品環境では推奨されません。
インスタンスごとに整形出力を有効にするためにはオプションを指定することが出来ます。すなわち :
```php
$data = ['a' => 1, 'b' => 2];
$json = yii\helpers\Json::encode($data, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
```
JSON <EFBFBD>w<EFBFBD><EFBFBD><EFBFBD>p<EFBFBD>̐<EFBFBD><EFBFBD>`<EFBFBD>o<EFBFBD>͂<EFBFBD><EFBFBD>O<EFBFBD><EFBFBD><EFBFBD>[<5B>o<EFBFBD><6F><EFBFBD>ɗL<C997><4C><EFBFBD>ɂ<EFBFBD><C982>邱<EFBFBD>Ƃ<EFBFBD><C682>o<EFBFBD><6F><EFBFBD>܂<EFBFBD><DC82>B<EFBFBD>Ⴆ<EFBFBD>΁A<CE81>ݒ<EFBFBD>t<EFBFBD>@<40>C<EFBFBD><43><EFBFBD><EFBFBD> index.php <EFBFBD>̒<EFBFBD><EFBFBD><EFBFBD> :
JSON ヘルパの整形出力をグローバルに有効にすることも出来ます。例えば、設定ファイルや index.php の中で :
```php
yii\helpers\Json::$prettyPrint = YII_DEBUG; // <EFBFBD>f<EFBFBD>o<EFBFBD>b<EFBFBD>O<EFBFBD>E<EFBFBD><EFBFBD><EFBFBD>[<5B>h<EFBFBD>ł͐<C582><CD90>`<60>o<EFBFBD>͂<EFBFBD><CD82>g<EFBFBD>p
yii\helpers\Json::$prettyPrint = YII_DEBUG; // デバッグ・モードでは整形出力を使用
```