docs/guide-ja updated [ci skip]

This commit is contained in:
Nobuo Kihara
2016-03-15 21:51:10 +09:00
parent d82bf74f41
commit 6441a44340
7 changed files with 60 additions and 1 deletions

View File

@ -288,6 +288,8 @@ class User extends ActiveRecord
* 挿入されるとき、ビヘイビアは現在の UNIX タイムスタンプを `created_at``updated_at` 属性に割り当てます * 挿入されるとき、ビヘイビアは現在の UNIX タイムスタンプを `created_at``updated_at` 属性に割り当てます
* 更新されるとき、ビヘイビアは現在の UNIX タイムスタンプを `updated_at` 属性に割り当てます * 更新されるとき、ビヘイビアは現在の UNIX タイムスタンプを `updated_at` 属性に割り当てます
> Note: 上記の実装が MySQL データベースで動作するようにするためには、`created_at` と `updated_at` のカラムを UNIX タイムスタンプ になるように int(11) として宣言してください。
このコードが所定の位置にあれば、例えば `User` オブジェクトがあって、それを保存しようとしたら、そこで、 このコードが所定の位置にあれば、例えば `User` オブジェクトがあって、それを保存しようとしたら、そこで、
`created_at``updated_at` が自動的に現在の UNIX タイムスタンプで埋められます。 `created_at``updated_at` が自動的に現在の UNIX タイムスタンプで埋められます。

View File

@ -129,6 +129,7 @@ $result = ArrayHelper::index($array, 'id');
``` ```
結果は、`id` 属性の値をキーとする連想配列になります。 結果は、`id` 属性の値をキーとする連想配列になります。
```php ```php
[ [
'123' => ['id' => '123', 'data' => 'abc', 'device' => 'laptop'], '123' => ['id' => '123', 'data' => 'abc', 'device' => 'laptop'],
@ -138,6 +139,7 @@ $result = ArrayHelper::index($array, 'id');
``` ```
`$key` として無名関数を渡しても同じ結果になります。 `$key` として無名関数を渡しても同じ結果になります。
```php ```php
$result = ArrayHelper::index($array, function ($element) { $result = ArrayHelper::index($array, function ($element) {
return $element['id']; return $element['id'];
@ -145,11 +147,13 @@ $result = ArrayHelper::index($array, function ($element) {
``` ```
`id` を3番目の引数として渡すと、`$array``id` によってグループ化することが出来ます。 `id` を3番目の引数として渡すと、`$array``id` によってグループ化することが出来ます。
```php ```php
$result = ArrayHelper::index($array, null, 'id'); $result = ArrayHelper::index($array, null, 'id');
``` ```
結果は、最初のレベルが `id` でグループ化され、第2のレベルはインデックスされていない連想配列になります。 結果は、最初のレベルが `id` でグループ化され、第2のレベルはインデックスされていない連想配列になります。
```php ```php
[ [
'123' => [ '123' => [
@ -163,6 +167,7 @@ $result = ArrayHelper::index($array, null, 'id');
``` ```
無名関数を配列のグループ化に使うことも出来ます。 無名関数を配列のグループ化に使うことも出来ます。
```php ```php
$result = ArrayHelper::index($array, 'data', [function ($element) { $result = ArrayHelper::index($array, 'data', [function ($element) {
return $element['id']; return $element['id'];
@ -170,6 +175,7 @@ $result = ArrayHelper::index($array, 'data', [function ($element) {
``` ```
結果は、最初のレベルが `id` でグループ化され、第2のレベルが `device` でグループ化され、第3のレベルが `data` でインデックスされた連想配列になります。 結果は、最初のレベルが `id` でグループ化され、第2のレベルが `device` でグループ化され、第3のレベルが `data` でインデックスされた連想配列になります。
```php ```php
[ [
'123' => [ '123' => [

View File

@ -137,6 +137,12 @@ public function actionError()
> Info: あなたが [ベーシックプロジェクトテンプレート](start-installation.md) または [アドバンストプロジェクトテンプレート](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide-ja/README.md) を使っている場合は、エラーアクションとエラービューは、既にあなたのために定義されています。 > Info: あなたが [ベーシックプロジェクトテンプレート](start-installation.md) または [アドバンストプロジェクトテンプレート](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide-ja/README.md) を使っている場合は、エラーアクションとエラービューは、既にあなたのために定義されています。
> Note: エラーハンドラの中でリダイレクトする必要がある場合は、次のようにしてください。
> ```php
> Yii::$app->getResponse()->redirect($url)->send();
> return;
> ```
### エラーのレスポンス形式をカスタマイズする <span id="error-format"></span> ### エラーのレスポンス形式をカスタマイズする <span id="error-format"></span>

View File

@ -190,6 +190,7 @@ Yii は二種類の権限付与マネージャを提供しています。すな
前者は権限付与データを保存するのに PHP スクリプトファイルを使いますが、後者は権限付与データをデータベースに保存します。 前者は権限付与データを保存するのに PHP スクリプトファイルを使いますが、後者は権限付与データをデータベースに保存します。
あなたのアプリケーションが非常に動的なロールと許可の管理を必要とするのでなければ、前者を使うことを考慮するのが良いでしょう。 あなたのアプリケーションが非常に動的なロールと許可の管理を必要とするのでなければ、前者を使うことを考慮するのが良いでしょう。
#### `PhpManager` を使用する <span id="using-php-manager"></span> #### `PhpManager` を使用する <span id="using-php-manager"></span>
次のコードは、アプリケーションの構成情報で [[yii\rbac\PhpManager]] クラスを使って `authManager` を構成する方法を示すものです。 次のコードは、アプリケーションの構成情報で [[yii\rbac\PhpManager]] クラスを使って `authManager` を構成する方法を示すものです。
@ -211,6 +212,7 @@ return [
デフォルトでは、[[yii\rbac\PhpManager]] は RBAC データを `@app/rbac/` ディレクトリの下のファイルに保存します。 デフォルトでは、[[yii\rbac\PhpManager]] は RBAC データを `@app/rbac/` ディレクトリの下のファイルに保存します。
権限の階層をオンラインで変更する必要がある場合は、必ず、ウェブサーバのプロセスがこのディレクトリとその中の全てのファイルに対する書き込み権限を有するようにしてください。 権限の階層をオンラインで変更する必要がある場合は、必ず、ウェブサーバのプロセスがこのディレクトリとその中の全てのファイルに対する書き込み権限を有するようにしてください。
#### `DbManager` を使用する <span id="using-db-manager"></span> #### `DbManager` を使用する <span id="using-db-manager"></span>
次のコードは、アプリケーションの構成情報で [[yii\rbac\DbManager]] クラスを使って `authManager` を構成する方法を示すものです。 次のコードは、アプリケーションの構成情報で [[yii\rbac\DbManager]] クラスを使って `authManager` を構成する方法を示すものです。
@ -228,6 +230,9 @@ return [
]; ];
``` ```
> Note: yii2-basic-app テンプレートを使おうとする場合は、`config/web.php` に加えて、`config/console.php` 構成ファイルにおいても `uathManager` を宣言する必要があります。
> yii2-advanced-app の場合は、`authManager` は `common/config/main.php` で一度だけ宣言されなければなりません。
`DbManager` は四つのデータベーステーブルを使ってデータを保存します。 `DbManager` は四つのデータベーステーブルを使ってデータを保存します。
- [[yii\rbac\DbManager::$itemTable|itemTable]]: 権限アイテムを保存するためのテーブル。デフォルトは "auth_item"。 - [[yii\rbac\DbManager::$itemTable|itemTable]]: 権限アイテムを保存するためのテーブル。デフォルトは "auth_item"。

View File

@ -32,7 +32,7 @@ Yii のインストールが終ると、実際に動く Yii のアプリケー
これは Yii によって提供される便利な [デバッグツールバー](https://github.com/yiisoft/yii2-debug/blob/master/docs/guide-ja/README.md) であり、たくさんのデバッグ情報、例えば、ログメッセージ、レスポンスのステータス、実行されたデータベースクエリなどを記録して表示するものです。 これは Yii によって提供される便利な [デバッグツールバー](https://github.com/yiisoft/yii2-debug/blob/master/docs/guide-ja/README.md) であり、たくさんのデバッグ情報、例えば、ログメッセージ、レスポンスのステータス、実行されたデータベースクエリなどを記録して表示するものです。
ウェブアプリケーションに加えて、`yii` というコンソールスクリプトがアプリケーションのベースディレクトリにあります。 ウェブアプリケーションに加えて、`yii` というコンソールスクリプトがアプリケーションのベースディレクトリにあります。
このスクリプトバックグラウンドのタスクまたはメンテナンスのタスクを実行するために使用することが出来ます。 このスクリプトは、バックグラウンドのタスクまたはメンテナンスのタスクを実行するために使用することが出来ます。
これについては、[コンソールアプリケーションの節](tutorial-console.md) で説明されています。 これについては、[コンソールアプリケーションの節](tutorial-console.md) で説明されています。
アプリケーションの構造 <span id="application-structure"></span> アプリケーションの構造 <span id="application-structure"></span>

View File

@ -124,6 +124,45 @@ exit($exitCode);
オプションのデフォルト値が配列型である場合、実行時にこのオプションをセットすると、オプションの値は、入力文字列をカンマで分離することによって、配列に変換されます。 オプションのデフォルト値が配列型である場合、実行時にこのオプションをセットすると、オプションの値は、入力文字列をカンマで分離することによって、配列に変換されます。
### オプションのエイリアス
バージョン 2.0.8 以降、コンソールコマンドは、コマンドにエイリアスを追加するための [[yii\console\Controller::optionAliases()]] メソッドを提供しています。
エイリアスを定義するためには、コントローラで [[yii\console\Controller::optionAliases()]] をオーバーライドします。
例えば、
```php
namespace app\commands;
use yii\console\Controller;
class HelloController extends Controller
{
public $message;
public function options()
{
return ['message'];
}
public function optionAliases()
{
return ['m' => 'message'];
}
public function actionIndex()
{
echo $message . "\n";
}
}
```
これで、次の構文を使ってコマンドを走らせることが出来るようになります。
```
./yii hello -m=hola
```
### 引数 ### 引数
オプションに加えてに、コマンドは引数を取ることも出来ます。 オプションに加えてに、コマンドは引数を取ることも出来ます。

View File

@ -755,6 +755,7 @@ ICU のバージョンが異なると、日付や数値のフォーマットの
<?php <?php
echo "PHP: " . PHP_VERSION . "\n"; echo "PHP: " . PHP_VERSION . "\n";
echo "ICU: " . INTL_ICU_VERSION . "\n"; echo "ICU: " . INTL_ICU_VERSION . "\n";
echo "ICU Data: " . INTL_ICU_DATA_VERSION . "\n";
``` ```
さらに、バージョン 49 以上の ICU を使用する事も推奨されます。 さらに、バージョン 49 以上の ICU を使用する事も推奨されます。