diff --git a/docs/guide-ja/README.md b/docs/guide-ja/README.md index caeea9b..f7a7d6e 100644 --- a/docs/guide-ja/README.md +++ b/docs/guide-ja/README.md @@ -1,7 +1,7 @@ Yii 2.0 決定版ガイド ==================== -このチュートリアルは [Yii ドキュメント許容条件](http://www.yiiframework.com/doc/terms/) の下にリリースされています。 +このチュートリアルは [Yii ドキュメント許諾条件](http://www.yiiframework.com/doc/terms/) の下にリリースされています。 All Rights Reserved. @@ -74,7 +74,7 @@ All Rights Reserved. データベースの取り扱い ---------------------- -* [データアクセスオブジェクト](db-dao.md): データベースへの接続、基本的なクエリ、トランザクション、および、スキーマ操作 +* [データベースアクセスオブジェクト](db-dao.md): データベースへの接続、基本的なクエリ、トランザクション、および、スキーマ操作 * [クエリビルダ](db-query-builder.md): シンプルな抽象レイヤを使ってデータベースに対してクエリを行う * [アクティブレコード](db-active-record.md): アクティブレコード ORM、レコードの読み出しと操作、リレーションの定義 * [マイグレーション](db-migrations.md): チーム開発環境においてデータベースにバージョンコントロールを適用 diff --git a/docs/guide-ja/intro-upgrade-from-v1.md b/docs/guide-ja/intro-upgrade-from-v1.md index 803ff1b..17bafdc 100644 --- a/docs/guide-ja/intro-upgrade-from-v1.md +++ b/docs/guide-ja/intro-upgrade-from-v1.md @@ -2,7 +2,7 @@ ===================================== Yii フレームワークは 2.0 のために完全に書き直されたため、バージョン 1.1 と 2.0 の間には数多くの違いがあります。 -結果として、バージョン 1.1 からのアップグレードは、マイナーバージョン間でのアップグレードのような些細な問題ではなくなりました。 +結果として、バージョン 1.1 からのアップグレードは、マイナーバージョン間でのアップグレードのような些細な仕事ではなくなりました。 この節では、二つのバージョン間の主要な違いを説明します。 もし以前に Yii 1.1 を使ったことがなければ、あなたはこの節を飛ばして直接に "[始めよう](start-installation.md)" に進んでも、問題はありません。 @@ -43,7 +43,7 @@ Yii 2.0 は PHP 5.4 以上を必要とします。PHP 5.4 は、Yii 1.1 によ� 名前空間 -------- -Yii 2.0 での最も明らかな変更は名前空間の使用です。 +Yii 2.0 での最も顕著な変更は名前空間の使用です。 ほとんど全てのコアクラスが、例えば、`yii\web\Request` のように名前空間に属します。 クラス名に "C" の接頭辞はもう使われません。 命名のスキームはディレクトリ構造に従うようになりました。 @@ -56,7 +56,7 @@ Yii 2.0 での最も明らかな変更は名前空間の使用です。 ---------------------------- Yii 2.0 は、1.1 の `CComponent` クラスを二つのクラス、すなわち、[[yii\base\Object]] と [[yii\base\Component]] に分割しました。 -[[yii\base\Object|Object]] クラスは、ゲッターとセッターを通じて [オブジェクトプロパティ](concept-properties.md) を定義することを可能にする軽量な基底クラスです。 +[[yii\base\Object|Object]] クラスは、ゲッターとセッターを通じて [オブジェクトプロパティ](concept-properties.md) を定義することを可能にする、軽量な基底クラスです。 [[yii\base\Component|Component]] クラスは [[yii\base\Object|Object]] からの拡張であり、[イベント](concept-events.md) と [ビヘイビア](concept-behaviors.md) をサポートします。 あなたのクラスがイベントやビヘイビアの機能を必要としない場合は、[[yii\base\Object|Object]] を基底クラスとして使うことを考慮すべきです。 @@ -92,7 +92,7 @@ class MyClass extends \yii\base\Object 構成情報の配列に含まれる「名前-値」のペアが、コンストラクタの最後でプロパティを構成します。 [[yii\base\Object::init()|init()]] メソッドをオーバーライドして、構成情報が適用された後に行うべき初期化処理を行うことが出来ます。 -この規約に従うことによって、構成情報の配列を使って新しいオブジェクトを生成して構成することが出来るようになります。 +この規約に従うことによって、新しいオブジェクトを生成して構成するときに、構成情報配列を使うことが出来るようになります。 ```php $object = Yii::createObject([ @@ -132,7 +132,7 @@ $component->on($eventName, $handler); -------------- Yii 2.0 は、パスエイリアスの使用を、ファイル/ディレクトリのパスと URL の両方に広げました。 -また、Yii 2.0 では、通常のファイル/ディレクトリのパスまたは URL と区別するために、エイリアス名は `@` という文字で始まることが要求されるようになりました。 +また、Yii 2.0 では、通常のファイル/ディレクトリのパスや URL と区別するために、エイリアス名は `@` という文字で始まることが要求されるようになりました。 例えば、`@yii` というエイリアスは Yii のインストールディレクトリを指します。 パスエイリアスは Yii のコアコードのほとんどの場所でサポートされています。 例えば [[yii\caching\FileCache::cachePath]] はパスエイリアスと通常のディレクトリパスの両方を受け取ることが出来ます。 @@ -150,7 +150,7 @@ Yii 2.0 は、パスエイリアスの使用を、ファイル/ディレクト� ビュー ------ -Yii 2 のビューについての最も顕著な変更は、ビューの中の `$this` という特殊な変数がカレントコントローラやウィジェットを指すものではなくなった、ということです。 +Yii 2 のビューについての最も顕著な変更は、ビューの中の `$this` という特殊な変数が現在のコントローラやウィジェットを指すものではなくなった、ということです。 今や `$this` は 2.0 で新しく導入された概念である *ビュー* オブジェクトを指します。 *ビュー* オブジェクトは [[yii\web\View]] という型であり、MVC パターンのビューの部分を表すものです。 ビューにおいてコントローラやウィジェットにアクセスしたい場合は、`$this->context` を使うことが出来ます。 @@ -175,10 +175,10 @@ Prado テンプレートエンジンはもはやサポートされていませ� Yii 2.0 は [[yii\base\Model]] を 1.1 における `CModel` と同様な基底モデルとして使います。 `CFormModel` というクラスは完全に廃止されました。 -Yii 2 では、それの代りに [yii\base\Model]] を拡張して、フォームモデルクラスを作成すべきです。 +Yii 2 では、それの代りに [yii\base\Model]] を拡張して、フォームのモデルクラスを作成すべきです。 Yii 2.0 は サポートされるシナリオを宣言するための [[yii\base\Model::scenarios()|scenarios()]] という新しいメソッドを導入しました。 -このメソッドを使って、あるシナリオの下で、どの属性が検証される必要があるか、また、どの属性が安全とみなされるか否か、などを宣言することが出来ます。 +このメソッドを使って、どのシナリオの下で、ある属性が検証される必要があるか、また、安全とみなされるか否か、などを宣言することが出来ます。 例えば、 ```php @@ -196,12 +196,12 @@ public function scenarios() `frontend` シナリオでは、`email` は一括代入が可能ですが、`role` は不可能です。 `email` と `role` は、両方とも、規則を使って検証されなければなりません。 -[[yii\base\Model::rules()|rules()]] メソッドが Yii 1.1 同様に検証規則を宣言するために使われます。 +[[yii\base\Model::rules()|rules()]] メソッドが、Yii 1.1 に引き続き、検証規則を宣言するために使われます。 [[yii\base\Model::scenarios()|scenarios()]] が導入されたことにより、`unsafe` バリデータが無くなったことに注意してください。 -ほとんどの場合、すなわち、[[yii\base\Model::rules()|rules()]] メソッドが存在しうるシナリオを完全に規定しているなら、そして `unsafe` な属性を宣言する必要が無いなら、[[yii\base\Model::scenarios()|scenarios()]] をオーバーライドする必要はありません。 +ほとんどの場合、すなわち、[[yii\base\Model::rules()|rules()]] メソッドが存在しうるシナリオを完全に指定しており、そして `unsafe` な属性を宣言する必要が無いなら、[[yii\base\Model::scenarios()|scenarios()]] をオーバーライドする必要はありません。 -モデルについてさらに詳細を学習するために、[モデル](structure-models.md) の節を参照してください。 +モデルについての詳細を学習するためには、[モデル](structure-models.md) の節を参照してください。 コントローラ @@ -211,7 +211,7 @@ Yii 2.0 は [[yii\web\Controller]] を基底のコントローラクラスとし これは Yii 1.1 における`CController` と同様なクラスです。 [[yii\base\Action]] がアクションクラスの基底クラスです。 -これらに関する変更があなたのコードに及ぼす最も顕著な影響は、コントローラのアクションは表示したいコンテンツを、エコーするのでなく、返さなければならない、ということです。 +コントローラに関して、あなたのコードに最も顕著な影響を及ぼす変更点は、コントローラのアクションは表示したいコンテントを、エコーするのでなく、返さなければならなくなった、ということです。 ```php public function actionView($id) @@ -258,10 +258,9 @@ ActiveForm::end(); テーマ ------ -テーマは 2.0 では完全に違う動き方をします。 +テーマは 2.0 では完全に違う動作をします。 テーマは、ソースのビューファイルパスをテーマのビューファイルパスにマップするパスマッピング機構に基づくものになりました。 -例えば、あるテーマのパスマップが `['/web/views' => '/web/themes/basic']` である場合、 -ビューファイル `/web/views/site/index.php` のテーマ適用版は `/web/themes/basic/site/index.php` になります。 +例えば、あるテーマのパスマップが `['/web/views' => '/web/themes/basic']` である場合、ビューファイル `/web/views/site/index.php` のテーマ版は `/web/themes/basic/site/index.php` になります。 この理由により、テーマはどのようなビューファイルに対してでも適用することが出来るようになりました。 コントローラやウィジェットのコンテキストの外で表示されるビューに対してすら、適用できます。 @@ -293,7 +292,7 @@ Yii 2.0 はコメントブロックからコマンドのヘルプ情報を自動 Yii 2.0 は [PECL intl PHP モジュール](http://pecl.php.net/package/intl) に賛同して、内蔵の日付フォーマッタと数字フォーマッタの部品を取り除きました。 メッセージは `i18n` アプリケーションコンポーネント経由で翻訳されるようになりました。 -このコンポーネントは一連のメッセージソースを管理するもので、メッセージのカテゴリに基づいて異なるメッセージソースを使うことを許容するものです。 +このコンポーネントは一連のメッセージソースを管理するもので、メッセージのカテゴリに基づいて異なるメッセージソースを使うことを可能にするものです。 詳細については [国際化](tutorial-i18n.md) の節を参照してください。 @@ -301,7 +300,7 @@ Yii 2.0 は [PECL intl PHP モジュール](http://pecl.php.net/package/intl) � アクションフィルタ ------------------ -新しいアクションフィルタはビヘイビアによって実装されています。 +アクションフィルタはビヘイビアによって実装されるようになりました。 新しいカスタムフィルタを定義するためには、[[yii\base\ActionFilter]] を拡張します。 フィルタを使うためには、そのフィルタクラスをビヘイビアとしてコントローラにアタッチします。 例えば、[[yii\filters\AccessControl]] を使うためには、コントローラに次のコードを書くことになります。 @@ -329,7 +328,7 @@ public function behaviors() Yii 2.0 は、*アセットバンドル* と呼ばれる新しい概念を導入しました。これは、Yii 1.1 にあったスクリプトパッケージの概念を置き換えるものです。 アセットバンドルは、あるディレクトリの下に集められた一群のアセットファイル (例えば、JavaScript ファイル、CSS ファイル、イメージファイルなど) です。 -それぞれのアセットバンドルは [[yii\web\AssetBundle]] を拡張したクラスとして表されます。 +それぞれのアセットバンドルは [[yii\web\AssetBundle]] を拡張したクラスとして表わされます。 アセットバンドルを [[yii\web\AssetBundle::register()]] を通じて登録することによって、そのバンドルに含まれるアセットにウェブ経由でアクセスできるようになります。 Yii 1 とは異なり、バンドルを登録したページは、そのバンドルで指定されている JavaScript と CSS ファイルへの参照を自動的に含むようになります。 @@ -440,8 +439,8 @@ $orders = $customer->getOrders()->andWhere('status=1')->all(); Yii 2.0 では、JOIN を使わずに二つの SQL 文が実行されます。 すなわち、第一の SQL 文が主たるレコードを返し、第二の SQL 文は主レコードのプライマリキーを使うフィルタリングによって関連レコードを返します。 -多数のレコードを返すクエリを構築するときは、[[yii\db\ActiveRecord|ActiveRecord]] を返す代りに、[[yii\db\ActiveQuery::asArray()|asArray()]] メソッドをチェインして、クエリ結果を配列として返すことが出来ます。 -こうすると、レコードの数が多い場合は、必要な CPU 時間とメモリを著しく削減することが出来ます。 +多数のレコードを返すクエリを構築するときは、[[yii\db\ActiveRecord|ActiveRecord]] を返す代りに、[[yii\db\ActiveQuery::asArray()|asArray()]] メソッドをチェインすることが出来ます。 +そうすると、クエリ結果は配列として返されることになり、レコードの数が多い場合は、必要な CPU 時間とメモリを著しく削減することが出来ます。 例えば、 ```php @@ -449,7 +448,7 @@ $customers = Customer::find()->asArray()->all(); ``` もう一つの変更点は、属性のデフォルト値を public なプロパティによって定義することは出来なくなった、ということです。 -デフォルト値が必要な場合は、アクティブレコードクラスの `init` メソッドの中で設定しなければなりません。 +デフォルト値を定義する必要がある場合は、アクティブレコードクラスの `init` メソッドの中で設定しなければなりません。 ```php public function init() @@ -506,7 +505,7 @@ User と IdentityInterface そして `CUserIdentity` クラスはもうありません。代りに、使い方がもっと単純な [[yii\web\IdentityInterface]] を実装すべきです。 アドバンストアプリケーションテンプレートがそういう例を提供しています。 -詳細は [認証](security-authentication.md)、[権限](security-authorization.md)、そして [アドバンストアプリケーションテンプレート](tutorial-advanced-app.md) の節を参照してください。 +詳細は [認証](security-authentication.md)、[権限付与](security-authorization.md)、そして [アドバンストアプリケーションテンプレート](tutorial-advanced-app.md) の節を参照してください。 URL 管理 diff --git a/docs/guide-ja/intro-yii.md b/docs/guide-ja/intro-yii.md index 727c256..fd5a1d6 100644 --- a/docs/guide-ja/intro-yii.md +++ b/docs/guide-ja/intro-yii.md @@ -21,7 +21,7 @@ Yii を他のフレームワークと比べると - ほとんどの PHP フレームワーク同様、Yii は MVC (Model-View-Controller) デザインパターンを実装し、このパターンに基づいたコードの組織化を推進しています。 - Yii は、コードはシンプルかつエレガントに書かれるべきである、という哲学を採用しています。 - 何らかのデザインパターンの厳密な遵守を主目的とする凝りすぎた設計には、Yii は決して手を出しません。 + 何らかのデザインパターンの厳密な遵守を主な目的とする凝りすぎた設計を、Yii がしようと試みることは決してありません。 - Yii はフル装備のフレームワークです。 クエリビルダ、リレーショナルデータベースと NoSQL データベースの双方のためのアクティブレコード、RESTful API 開発サポート、多層構成のキャッシュサポート、その他、検証済みで直ちに使える多数の機能を提供します。 - Yii は極めて拡張性の高いフレームワークです。あなたはコアのコードのほとんど全ての要素をカスタマイズしたり置き換えたりすることが出来ます。