Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
Y
yii2
Project
Overview
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
PSDI Army
yii2
Commits
74666f74
Commit
74666f74
authored
Oct 29, 2014
by
Qiang Xue
Browse files
Options
Browse Files
Download
Plain Diff
Merge pull request #5804 from softark/docs-ja-guide-applications
Docs ja guide applications [ci skip]
parents
7e46829b
cad3bd12
Show whitespace changes
Inline
Side-by-side
Showing
8 changed files
with
652 additions
and
48 deletions
+652
-48
README.md
docs/guide-ja/README.md
+4
-4
intro-upgrade-from-v1.md
docs/guide-ja/intro-upgrade-from-v1.md
+18
-17
start-databases.md
docs/guide-ja/start-databases.md
+8
-8
start-gii.md
docs/guide-ja/start-gii.md
+5
-5
start-installation.md
docs/guide-ja/start-installation.md
+5
-5
start-workflow.md
docs/guide-ja/start-workflow.md
+5
-5
structure-applications.md
docs/guide-ja/structure-applications.md
+603
-0
structure-entry-scripts.md
docs/guide-ja/structure-entry-scripts.md
+4
-4
No files found.
docs/guide-ja/README.md
View file @
74666f74
...
@@ -32,14 +32,14 @@ All Rights Reserved.
...
@@ -32,14 +32,14 @@ All Rights Reserved.
----------------------
----------------------
*
[
概要
](
structure-overview.md
)
*
[
概要
](
structure-overview.md
)
*
[
エントリ
ー
スクリプト
](
structure-entry-scripts.md
)
*
[
エントリスクリプト
](
structure-entry-scripts.md
)
*
[
アプリケーション
](
structure-applications.md
)
*
[
アプリケーション
](
structure-applications.md
)
*
[
アプリケーションコンポーネント
](
structure-application-components.md
)
*
[
アプリケーションコンポーネント
](
structure-application-components.md
)
*
[
コントローラ
](
structure-controllers.md
)
*
[
コントローラ
](
structure-controllers.md
)
*
[
モデル
](
structure-models.md
)
*
[
モデル
](
structure-models.md
)
*
[
ビュー
](
structure-views.md
)
*
[
ビュー
](
structure-views.md
)
*
[
モジュール
](
structure-modules.md
)
*
[
モジュール
](
structure-modules.md
)
*
[
フィルタ
ー
](
structure-filters.md
)
*
[
フィルタ
](
structure-filters.md
)
*
[
ウィジェット
](
structure-widgets.md
)
*
[
ウィジェット
](
structure-widgets.md
)
*
[
アセット
](
structure-assets.md
)
*
[
アセット
](
structure-assets.md
)
*
[
エクステンション
](
structure-extensions.md
)
*
[
エクステンション
](
structure-extensions.md
)
...
@@ -49,7 +49,7 @@ All Rights Reserved.
...
@@ -49,7 +49,7 @@ All Rights Reserved.
----------------
----------------
*
[
概要
](
runtime-overview.md
)
*
[
概要
](
runtime-overview.md
)
*
[
ブートストラッ
ピング
](
runtime-bootstrapping.md
)
*
[
ブートストラッ
プ
](
runtime-bootstrapping.md
)
*
[
ルーティング
](
runtime-routing.md
)
*
[
ルーティング
](
runtime-routing.md
)
*
[
リクエスト
](
runtime-requests.md
)
*
[
リクエスト
](
runtime-requests.md
)
*
[
レスポンス
](
runtime-responses.md
)
*
[
レスポンス
](
runtime-responses.md
)
...
@@ -66,7 +66,7 @@ All Rights Reserved.
...
@@ -66,7 +66,7 @@ All Rights Reserved.
*
[
プロパティ
](
concept-properties.md
)
*
[
プロパティ
](
concept-properties.md
)
*
[
イベント
](
concept-events.md
)
*
[
イベント
](
concept-events.md
)
*
[
ビヘイビア
](
concept-behaviors.md
)
*
[
ビヘイビア
](
concept-behaviors.md
)
*
[
設定
](
concept-configurations.md
)
*
[
コンフィギュレーション
](
concept-configurations.md
)
*
[
エイリアス
](
concept-aliases.md
)
*
[
エイリアス
](
concept-aliases.md
)
*
[
クラスのオートロード
](
concept-autoloading.md
)
*
[
クラスのオートロード
](
concept-autoloading.md
)
*
[
サービスロケータ
](
concept-service-locator.md
)
*
[
サービスロケータ
](
concept-service-locator.md
)
...
...
docs/guide-ja/intro-upgrade-from-v1.md
View file @
74666f74
...
@@ -63,18 +63,18 @@ Yii 2.0 縺ッ縲1.1 縺ョ `CComponent` 繧ッ繝ゥ繧ケ繧剃コ後▽縺ョ繧ッ繝ゥ繧ケ縺ォ蛻牡縺励∪
...
@@ -63,18 +63,18 @@ Yii 2.0 縺ッ縲1.1 縺ョ `CComponent` 繧ッ繝ゥ繧ケ繧剃コ後▽縺ョ繧ッ繝ゥ繧ケ縺ォ蛻牡縺励∪
通常、基本的なデータ構造を表すクラスに対しては、このことが当てはまります。
通常、基本的なデータ構造を表すクラスに対しては、このことが当てはまります。
オブジェクトの設定
オブジェクトのコンフィ
ギュレーション
------------------
------------------
------------------
[
[yii\base\Object|Object
]
] クラスはオブジェクトを設定するための統
一された方法を導入して
います。
[
[yii\base\Object|Object
]
] クラスはオブジェクトのコンフィギュレー
ションのための統一された方法を導入しています。
[
[yii\base\Object|Object
]
] の全ての派生クラスは、正しく設定されるよ
うに、コンストラクタを(それが必要な場
合には)以下の方法で宣言すべきです:
[
[yii\base\Object|Object
]
] の全ての派生クラスは、適切にコンフィギュ
レーションを適用されるように、コンストラクタを(それが必要な場合には)以下
の方法で宣言すべきです:
```
php
```
php
class
MyClass
extends
\yii\base\Object
class
MyClass
extends
\yii\base\Object
{
{
public
function
__construct
(
$param1
,
$param2
,
$config
=
[])
public
function
__construct
(
$param1
,
$param2
,
$config
=
[])
{
{
// ...
設定が適用され
る前の初期化処理
// ...
コンフィギュレーションが適用される前の初期化処理
parent
::
__construct
(
$config
);
parent
::
__construct
(
$config
);
}
}
...
@@ -83,16 +83,16 @@ class MyClass extends \yii\base\Object
...
@@ -83,16 +83,16 @@ class MyClass extends \yii\base\Object
{
{
parent
::
init
();
parent
::
init
();
// ...
設定が適用され
た後の初期化処理
// ...
コンフィギュレーションが適用された後の初期化処理
}
}
}
}
```
```
上記において、コンストラクタは最後のパラメータとして設定配列を取らなければなりません。
上記において、コンストラクタは最後のパラメータとしてコンフィギュレーション配列を取らな
ければなりません。
設定配列は「
名前-値」のペアを含むものであり、コンストラクタの最後でプロパティを初期化するためのものです。
コンフィギュレーション配列は「名前-値」のペアを含
むものであり、コンストラクタの最後でプロパティを初期化するためのものです。
[
[yii\base\Object::init()|init()
]
] メソッドをオーバーライドして、設定が適用された
後に行うべき初期
化処理を行うことが出来ます。
[
[yii\base\Object::init()|init()
]
] メソッドをオーバーライドして、コンフィギュレー
ションが適用された後に行うべき初期化処理を行うこ
とが出来ます。
この規約に従うことによって、設定配列を使
って新しいオブジェ
クトを生成して設定することが出来るようになります:
この規約に従うことによって、コンフィギュ
レーション配列を使って新しいオブジェクトを生成して設
定することが出来るようになります:
```
php
```
php
$object
=
Yii
::
createObject
([
$object
=
Yii
::
createObject
([
...
@@ -102,7 +102,7 @@ $object = Yii::createObject([
...
@@ -102,7 +102,7 @@ $object = Yii::createObject([
],
[
$param1
,
$param2
]);
],
[
$param1
,
$param2
]);
```
```
設定に関する更なる詳細は、
[
オブジェクトの設定
](
concept-config
urations.md
)
の節で見ることが出来ます。
コンフィギュレーションに関する更なる詳細は、
[
オブジェクトのコンフィギュレーション
](
concept-configurations.md
)
の節で見る
ことが出来ます。
イベント
イベント
...
@@ -138,7 +138,8 @@ Yii 2.0 縺ッ縲√ヱ繧ケ繧ィ繧、繝ェ繧「繧ケ縺ョ菴ソ逕ィ繧偵√ヵ繧。繧、繝ォ/繝ぅ繝ャ繧ッ繝医
...
@@ -138,7 +138,8 @@ Yii 2.0 縺ッ縲√ヱ繧ケ繧ィ繧、繝ェ繧「繧ケ縺ョ菴ソ逕ィ繧偵√ヵ繧。繧、繝ォ/繝ぅ繝ャ繧ッ繝医
例えば
[
[yii\caching\FileCache::cachePath
]
] はパスエイリアスと通常のディレクトリパスの両方を受け取ることが出来ます。
例えば
[
[yii\caching\FileCache::cachePath
]
] はパスエイリアスと通常のディレクトリパスの両方を受け取ることが出来ます。
パスエイリアスは、また、クラスの名前空間とも密接に関係しています。
パスエイリアスは、また、クラスの名前空間とも密接に関係しています。
ルートの名前空間のそれぞれに対してパスエイリアスを定義することが推奨されています。そうすることによって、よけいな設定をしなくても、Yii のクラスオートローダを使うことが出来るようになります。
ルートの名前空間のそれぞれに対してパスエイリアスを定義することが推奨されています。
そうすることによって、よけいなコンフィギュレーションをしなくても、Yii のクラスオートローダを使うことが出来るようになります。
例えば、
`@yii`
は Yii のインストールディレクトリを指しているので、
`yii\web\Request`
というようなクラスをオートロードすることが出来ます。
例えば、
`@yii`
は Yii のインストールディレクトリを指しているので、
`yii\web\Request`
というようなクラスをオートロードすることが出来ます。
サードパーティのライブラリ、例えば Zend フレームワークなどを使う場合には、そのフレームワークのインストールディレクトリを指す
`@Zend`
というパスエイリアスを定義することが出来ます。
サードパーティのライブラリ、例えば Zend フレームワークなどを使う場合には、そのフレームワークのインストールディレクトリを指す
`@Zend`
というパスエイリアスを定義することが出来ます。
一旦そうしてしまえば、その Zend フレームワークのライブラリ中のどんなクラスでも、同じようにオートロードすることが出来るようになります。
一旦そうしてしまえば、その Zend フレームワークのライブラリ中のどんなクラスでも、同じようにオートロードすることが出来るようになります。
...
@@ -164,7 +165,7 @@ echo $this->render('_item', ['item' => $item]);
...
@@ -164,7 +165,7 @@ echo $this->render('_item', ['item' => $item]);
PHP を主たるテンプレート言語として使うのに加えて、Yii 2.0 は人気のある二つのテンプレートエンジン、Smarty と Twig に対する正式なサポートを備えています。
PHP を主たるテンプレート言語として使うのに加えて、Yii 2.0 は人気のある二つのテンプレートエンジン、Smarty と Twig に対する正式なサポートを備えています。
Prado テンプレートエンジンはもうサポートされません。
Prado テンプレートエンジンはもうサポートされません。
これらのテンプレートエンジンを使うためには、
[
[yii\base\View::$renderers|View::$renderers
]
] プロパティをセットして、
`view`
アプリケーションコンポーネントを設定する必要があります。
これらのテンプレートエンジンを使うためには、
[
[yii\base\View::$renderers|View::$renderers
]
] プロパティをセットして、
`view`
アプリケーションコンポーネントを構成する必要があります。
詳細は
[
テンプレートエンジン
](
tutorial-template-engines.md
)
の節を参照してください。
詳細は
[
テンプレートエンジン
](
tutorial-template-engines.md
)
の節を参照してください。
...
@@ -264,7 +265,7 @@ ActiveForm::end();
...
@@ -264,7 +265,7 @@ ActiveForm::end();
コントローラやウィジェットのコンテキストの外で表示されるビューに対してすら、適用できます。
コントローラやウィジェットのコンテキストの外で表示されるビューに対してすら、適用できます。
また、
`CThemeManager`
コンポーネントはもうありません。
また、
`CThemeManager`
コンポーネントはもうありません。
その代りに、
`theme`
は
`view`
アプリケーションコンポーネントの設定可能なプロパティになり
ました。
その代りに、
`theme`
は
`view`
アプリケーションコンポーネントのコンフィギュレーション可能
なプロパティになりました。
更なる詳細については
[
テーマ
](
output-theming.md
)
の節を参照してください。
更なる詳細については
[
テーマ
](
output-theming.md
)
の節を参照してください。
...
@@ -296,8 +297,8 @@ Yii 2.0 縺ッ [PECL intl PHP 繝「繧ク繝・繝シ繝ォ](http://pecl.php.net/package/intl) 縺
...
@@ -296,8 +297,8 @@ Yii 2.0 縺ッ [PECL intl PHP 繝「繧ク繝・繝シ繝ォ](http://pecl.php.net/package/intl) 縺
更なる詳細については
[
国際化
](
tutorial-i18n.md
)
の節を参照してください。
更なる詳細については
[
国際化
](
tutorial-i18n.md
)
の節を参照してください。
アクションフィルター
アクションフィルタ
------------------
--
------------------
新しいアクションフィルターはビヘイビアによって実装されています。
新しいアクションフィルターはビヘイビアによって実装されています。
新しいカスタムフィルターを定義するためには、
[
[yii\base\ActionFilter
]
] を拡張します。
新しいカスタムフィルターを定義するためには、
[
[yii\base\ActionFilter
]
] を拡張します。
...
@@ -318,7 +319,7 @@ public function behaviors()
...
@@ -318,7 +319,7 @@ public function behaviors()
}
}
```
```
更なる詳細については
[
フィルター
](
structur
e-
filters.md
)
の節を参照してください。
更なる詳細については
[
フィルタ
](
structure-filters.md
)
の節を参照してください。
アセット
アセット
...
...
docs/guide-ja/start-databases.md
View file @
74666f74
...
@@ -2,12 +2,12 @@
...
@@ -2,12 +2,12 @@
==================
==================
この節では、
`country`
という名前のデータベーステーブルから読み出した国データを表示する新しいページの作り方を説明します。
この節では、
`country`
という名前のデータベーステーブルから読み出した国データを表示する新しいページの作り方を説明します。
この目的を達するために、データベース接続を
設定
し、
[
アクティブレコード
](
db-active-record.md
)
クラスを作成し、
この目的を達するために、データベース接続を
構成
し、
[
アクティブレコード
](
db-active-record.md
)
クラスを作成し、
[
アクション
](
structure-controllers.md
)
を定義し、そして
[
ビュー
](
structure-views.md
)
を作成します。
[
アクション
](
structure-controllers.md
)
を定義し、そして
[
ビュー
](
structure-views.md
)
を作成します。
このチュートリアルを通じて、次のことをする方法を学びます:
このチュートリアルを通じて、次のことをする方法を学びます:
*
DB 接続を
設定
する
*
DB 接続を
構成
する
*
アクティブレコードのクラスを定義する
*
アクティブレコードのクラスを定義する
*
アクティブレコードのクラスを使ってデータを検索する
*
アクティブレコードのクラスを使ってデータを検索する
*
改ページを伴う方法でビューにデータを表示する
*
改ページを伴う方法でビューにデータを表示する
...
@@ -51,7 +51,7 @@ INSERT INTO `country` VALUES ('US','United States',278357000);
...
@@ -51,7 +51,7 @@ INSERT INTO `country` VALUES ('US','United States',278357000);
そして、
`country`
テーブルは、10 行のデータを持っています。
そして、
`country`
テーブルは、10 行のデータを持っています。
DB 接続を
設定
する<a name="configuring-db-connection"></a>
DB 接続を
構成
する<a name="configuring-db-connection"></a>
-----------------
-----------------
先に進む前に、
[
PDO
](
http://www.php.net/manual/en/book.pdo.php
)
PHP 拡張および使用しているデータベースの PDO ドライバ
先に進む前に、
[
PDO
](
http://www.php.net/manual/en/book.pdo.php
)
PHP 拡張および使用しているデータベースの PDO ドライバ
...
@@ -73,15 +73,15 @@ return [
...
@@ -73,15 +73,15 @@ return [
];
];
```
```
この
`config/db.php`
というファイルは典型的なファイルベースの
[
設定
](
concept-configurations.md
)
ツールです。
この
`config/db.php`
というファイルは典型的なファイルベースの
[
コンフィギュレーション
](
concept-configurations.md
)
ツールです。
この
設定
ファイルが
[
[yii\db\Connection
]
] インスタンスの作成と初期化に必要なパラメータを規定します。そして、
この
コンフィギュレーション
ファイルが
[
[yii\db\Connection
]
] インスタンスの作成と初期化に必要なパラメータを規定します。そして、
[
[yii\db\Connection
]
] インスタンスを通じて、背後のデータベースに対して SQL クエリを実行することが出来るようになります。
[
[yii\db\Connection
]
] インスタンスを通じて、背後のデータベースに対して SQL クエリを実行することが出来るようになります。
上記のようにして
設定
された DB 接続は、アプリケーションコードの中で
`Yii::$app->db`
という式でアクセスすることが出来ます。
上記のようにして
構成
された DB 接続は、アプリケーションコードの中で
`Yii::$app->db`
という式でアクセスすることが出来ます。
> Info|情報: `config/db.php` は、メインのアプリケーション
設定
ファイルである `config/web.php` にインクルードされます。
> Info|情報: `config/db.php` は、メインのアプリケーション
コンフィギュレーション
ファイルである `config/web.php` にインクルードされます。
この
`config/web.php`
が
[
アプリケーション
](
structure-applications.md
)
インスタンスが初期化される仕方を規定します。
この
`config/web.php`
が
[
アプリケーション
](
structure-applications.md
)
インスタンスが初期化される仕方を規定します。
更なる情報については、
[
設定
](
concept-configurations.md
)
の節を参照してください。
更なる情報については、
[
コンフィギュレーション
](
concept-configurations.md
)
の節を参照してください。
アクティブレコードを作成する<a name="creating-active-record"></a>
アクティブレコードを作成する<a name="creating-active-record"></a>
...
...
docs/guide-ja/start-gii.md
View file @
74666f74
...
@@ -17,8 +17,8 @@ Gii を開始する<a name="starting-gii"></a>
...
@@ -17,8 +17,8 @@ Gii を開始する<a name="starting-gii"></a>
--------------
--------------
[
Gii
](
tool-gii.md
)
は Yii の
[
モジュール
](
structure-modules.md
)
として提供されます。
[
Gii
](
tool-gii.md
)
は Yii の
[
モジュール
](
structure-modules.md
)
として提供されます。
Gii は、アプリケーションの
[
[yii\base\Application::modules|modules
]
] プロパティの中で
設定
することで有効にすることが出来ます。
Gii は、アプリケーションの
[
[yii\base\Application::modules|modules
]
] プロパティの中で
構成
することで有効にすることが出来ます。
アプリケーションを生成した仕方にもよりますが、
`config/web.php`
の
設定
ファイルの中に、多分、下記のコードが既に提供されているでしょう:
アプリケーションを生成した仕方にもよりますが、
`config/web.php`
の
コンフィギュレーション
ファイルの中に、多分、下記のコードが既に提供されているでしょう:
```
php
```
php
$config
=
[
...
];
$config
=
[
...
];
...
@@ -29,7 +29,7 @@ if (YII_ENV_DEV) {
...
@@ -29,7 +29,7 @@ if (YII_ENV_DEV) {
}
}
```
```
上記の
設定
は、
[
開発環境
](
concept-configurations.md#environment-constants
)
において、アプリケーションは
上記の
コンフィギュレーション
は、
[
開発環境
](
concept-configurations.md#environment-constants
)
において、アプリケーションは
`gii`
という名前のモジュールをインクルードすべきこと、そして
`gii`
は
[
[yii\gii\Module
]
] というクラスのものであることを記述しています。
`gii`
という名前のモジュールをインクルードすべきこと、そして
`gii`
は
[
[yii\gii\Module
]
] というクラスのものであることを記述しています。
アプリケーションの
[
エントリスクリプト
](
structure-entry-scripts.md
)
である
`web/index.php`
をチェックすると、次の行があることに気付くでしょう。
アプリケーションの
[
エントリスクリプト
](
structure-entry-scripts.md
)
である
`web/index.php`
をチェックすると、次の行があることに気付くでしょう。
...
@@ -39,7 +39,7 @@ if (YII_ENV_DEV) {
...
@@ -39,7 +39,7 @@ if (YII_ENV_DEV) {
defined
(
'YII_ENV'
)
or
define
(
'YII_ENV'
,
'dev'
);
defined
(
'YII_ENV'
)
or
define
(
'YII_ENV'
,
'dev'
);
```
```
この行のおかげで、アプリケーションは開発モードになり、上記の
設定
によって、Gii が有効になります。
この行のおかげで、アプリケーションは開発モードになり、上記の
コンフィギュレーション
によって、Gii が有効になります。
これで、下記の URL によって Gii にアクセスすることが出来ます:
これで、下記の URL によって Gii にアクセスすることが出来ます:
```
```
...
@@ -47,7 +47,7 @@ http://hostname/index.php?r=gii
...
@@ -47,7 +47,7 @@ http://hostname/index.php?r=gii
```
```
> Note|注意: ローカルホスト以外のマシンから GII にアクセスしようとすると、既定ではセキュリティ上の
> Note|注意: ローカルホスト以外のマシンから GII にアクセスしようとすると、既定ではセキュリティ上の
> 目的からアクセスが拒否されます。下記のように Gii を
設定
して、許可される IP アドレスを追加することが出来ます。
> 目的からアクセスが拒否されます。下記のように Gii を
構成
して、許可される IP アドレスを追加することが出来ます。
>
>
```
php
```
php
'gii'
=>
[
'gii'
=>
[
...
...
docs/guide-ja/start-installation.md
View file @
74666f74
...
@@ -54,7 +54,7 @@ Composer 縺後う繝ウ繧ケ繝医繝ォ縺輔l縺溘i縲√え繧ァ繝悶°繧峨い繧ッ繧サ繧ケ縺ァ縺阪
...
@@ -54,7 +54,7 @@ Composer 縺後う繝ウ繧ケ繝医繝ォ縺輔l縺溘i縲√え繧ァ繝悶°繧峨い繧ッ繧サ繧ケ縺ァ縺阪
1.
[
yiiframework.com
](
http://www.yiiframework.com/download/
)
からアーカイブファイルをダウンロードする。
1.
[
yiiframework.com
](
http://www.yiiframework.com/download/
)
からアーカイブファイルをダウンロードする。
2.
ダウンロードしたファイルをウェブからアクセスできるフォルダーに展開する。
2.
ダウンロードしたファイルをウェブからアクセスできるフォルダーに展開する。
3.
`config/web.php`
ファイルを編集して、
`cookieValidationKey`
設定アイテム
に秘密キーを入力す
る
3.
`config/web.php`
ファイルを編集して、
`cookieValidationKey`
というコンフ
ィギュレーション項目に秘密キーを入力する
(Composer を使って Yii をインストールするときは、これは自動的に実行されます):
(Composer を使って Yii をインストールするときは、これは自動的に実行されます):
```
php
```
php
...
@@ -109,7 +109,7 @@ Yii 縺ョ譛菴主ソヲ∵擅莉カ繧呈コ縺溘☆繧医≧縺ォ PHP 縺ョ繧、繝ウ繧ケ繝医繝ォ繧呈ァ区
...
@@ -109,7 +109,7 @@ Yii 縺ョ譛菴主ソヲ∵擅莉カ繧呈コ縺溘☆繧医≧縺ォ PHP 縺ョ繧、繝ウ繧ケ繝医繝ォ繧呈ァ区
また、アプリケーションがデータベースを必要とする場合は、[PDO PHP 拡張](http://www.php.net/manual/ja/pdo.installation.php) および対応するデータベースドライバ (MySQL データベースのための `pdo_mysql` など) をインストールしなければなりません。
また、アプリケーションがデータベースを必要とする場合は、[PDO PHP 拡張](http://www.php.net/manual/ja/pdo.installation.php) および対応するデータベースドライバ (MySQL データベースのための `pdo_mysql` など) をインストールしなければなりません。
ウェブサーバを設定する<
a name
="configuring-web-servers"></a>
ウェブサーバを構成する<
a nam
e="configuring-web-servers"></a>
----------------------
----------------------
> Info|情報: もし Yii の試運転をしているだけで、実運用のサーバに配置する意図がないのであれば、当面、この項は飛ばしても構いません。
> Info|情報: もし Yii の試運転をしているだけで、実運用のサーバに配置する意図がないのであれば、当面、この項は飛ばしても構いません。
...
@@ -131,7 +131,7 @@ Yii 2.0 縺ッ縲√∪縺溘’acebook 縺ョ [HHVM](http://hhvm.com/) 縺ィ繧ゆコ呈鋤諤ァ縺後
...
@@ -131,7 +131,7 @@ Yii 2.0 縺ッ縲√∪縺溘’acebook 縺ョ [HHVM](http://hhvm.com/) 縺ィ繧ゆコ呈鋤諤ァ縺後
更なる詳細については、[共有ホスティング環境](tutorial-shared-hosting.md) の節を参照してください。
更なる詳細については、[共有ホスティング環境](tutorial-shared-hosting.md) の節を参照してください。
### 推奨される Apache の設定<a
na
me="recommended-apache-configuration"></a>
### 推奨される Apache の構成<a
n
ame="recommended-apache-configuration"></a>
下記の設定を Apache の `httpd.conf` ファイルまたはバーチャルホスト設定の中で使います。
下記の設定を Apache の `httpd.conf` ファイルまたはバーチャルホスト設定の中で使います。
`path/to/basic/web` の部分を `basic/web` の実際のパスに置き換えなければならないことに注意してください。
`path/to/basic/web` の部分を `basic/web` の実際のパスに置き換えなければならないことに注意してください。
...
@@ -154,7 +154,7 @@ DocumentRoot "path/to/basic/web"
...
@@ -154,7 +154,7 @@ DocumentRoot "path/to/basic/web"
```
```
### 推奨される Nginx の設定<a
na
me="recommended-nginx-configuration"></a>
### 推奨される Nginx の構成<a
n
ame="recommended-nginx-configuration"></a>
[Nginx](http://wiki.nginx.org/) を使うためには、PHP を [FPM SAPI](http://jp1.php.net/install.fpm) としてインストールしていなければなりません。
[Nginx](http://wiki.nginx.org/) を使うためには、PHP を [FPM SAPI](http://jp1.php.net/install.fpm) としてインストールしていなければなりません。
下記の設定を使い、`path/to/basic/web` の部分を `basic/web` の実際のパスに置き換え、`mysite.local` を実際のサーバのホスト名に置き換えてください。
下記の設定を使い、`path/to/basic/web` の部分を `basic/web` の実際のパスに置き換え、`mysite.local` を実際のサーバのホスト名に置き換えてください。
...
@@ -199,7 +199,7 @@ server {
...
@@ -199,7 +199,7 @@ server {
}
}
```
```
この
設定を使う場
合は、同時に
`php.ini`
ファイルで
`cgi.fix_pathinfo=0`
も設定して、
この
構成を使う
場合は、同時に
`php.ini`
ファイルで
`cgi.fix_pathinfo=0`
も設定して、
多数の不要な
`stat()`
の呼び出しを避けるべきです。
多数の不要な
`stat()`
の呼び出しを避けるべきです。
また、HTTPS サーバを走らせている場合には、安全な接続であることを Yii が正しく検知できるように、
また、HTTPS サーバを走らせている場合には、安全な接続であることを Yii が正しく検知できるように、
...
...
docs/guide-ja/start-workflow.md
View file @
74666f74
...
@@ -2,7 +2,7 @@
...
@@ -2,7 +2,7 @@
==========================
==========================
Yii のインストールが終ると、実際に動く Yii のアプリケーションにアクセスすることが出来るようになります。
Yii のインストールが終ると、実際に動く Yii のアプリケーションにアクセスすることが出来るようになります。
その URL は、
`http://hostname/basic/web/index.php`
あるいは
`http://hostname/index.php`
など、設定によ
つ
て異なります。
その URL は、
`http://hostname/basic/web/index.php`
あるいは
`http://hostname/index.php`
など、設定によ
っ
て異なります。
この節では、アプリケーションに組み込み済みの機能を紹介し、コードがどのように組織されているか、
この節では、アプリケーションに組み込み済みの機能を紹介し、コードがどのように組織されているか、
そして、一般にアプリケーションがリクエストをどのように処理するかを説明します。
そして、一般にアプリケーションがリクエストをどのように処理するかを説明します。
...
@@ -41,9 +41,9 @@ Yii のインストールが終ると、実際に動く Yii のアプリケー
...
@@ -41,9 +41,9 @@ Yii のインストールが終ると、実際に動く Yii のアプリケー
```
```
basic/ アプリケーションのベースパス
basic/ アプリケーションのベースパス
composer.json Composer によって使用される。パッケージ情報を記述
composer.json Composer によって使用される。パッケージ情報を記述
config/ アプリケーションその他の
設定
を格納
config/ アプリケーションその他の
コンフィギュレーション
を格納
console.php コンソールアプリケーションの
設定
console.php コンソールアプリケーションの
コンフィギュレーション
web.php ウェブアプリケーションの
設定
web.php ウェブアプリケーションの
コンフィギュレーション
commands/ コンソールコマンドのクラスを格納
commands/ コンソールコマンドのクラスを格納
controllers/ コントローラのクラスを格納
controllers/ コントローラのクラスを格納
models/ モデルのクラスを格納
models/ モデルのクラスを格納
...
@@ -81,7 +81,7 @@ Yii は [モデル・ビュー・コントローラ (MVC)](http://wikipedia.org/
...
@@ -81,7 +81,7 @@ Yii は [モデル・ビュー・コントローラ (MVC)](http://wikipedia.org/
![
リクエストのライフサイクル
](
images/application-lifecycle.png
)
![
リクエストのライフサイクル
](
images/application-lifecycle.png
)
1.
ユーザが
[
エントリスクリプト
](
structure-entry-scripts.md
)
`web/index.php`
に対してリクエストを出します。
1.
ユーザが
[
エントリスクリプト
](
structure-entry-scripts.md
)
`web/index.php`
に対してリクエストを出します。
2.
エントリスクリプトはアプリケーションの
[
設定
](
concept-configurations.md
)
を読み出して、
2.
エントリスクリプトはアプリケーションの
[
コンフィギュレーション
](
concept-configurations.md
)
を読み出して、
リクエストを処理する
[
アプリケーション
](
structure-applications.md
)
のインスタンスを作成します。
リクエストを処理する
[
アプリケーション
](
structure-applications.md
)
のインスタンスを作成します。
3.
アプリケーションは、
[
リクエスト
](
runtime-requests.md
)
アプリケーションコンポーネントの助力を得て、
3.
アプリケーションは、
[
リクエスト
](
runtime-requests.md
)
アプリケーションコンポーネントの助力を得て、
リクエストされた
[
ルート
](
runtime-routing.md
)
を解決します。
リクエストされた
[
ルート
](
runtime-routing.md
)
を解決します。
...
...
docs/guide-ja/structure-applications.md
0 → 100644
View file @
74666f74
アプリケーション
================
アプリケーションは Yii アプリケーションシステム全体の構造とライフサイクルを統制するオブジェクトです。
全ての Yii アプリケーションシステムは、それぞれ、
[
エントリスクリプト
](
structure-entry-scripts.md
)
において作成され、
`\Yii::$app`
という式でグローバルにアクセス可能な、単一のアプリケーションオブジェクトを持ちます。
> Info|情報: ガイドの中で「アプリケーション」という言葉は、文脈に応じて、
アプリケーションオブジェクトを意味したり、アプリケーションシステムを意味したりします。
二種類のアプリケーションがあります: すなわち、
[
[yii\web\Application|ウェブアプリケーション
]
] と
[
[yii\console\Application|コンソールアプリケーション
]
] です。
名前が示すように、前者は主にウェブのリクエストを処理し、後者はコンソールコマンドのリクエストを処理します。
## アプリケーションのコンフィギュレーション<a name="application-configurations"></a>
[
エントリスクリプト
](
structure-entry-scripts.md
)
は、アプリケーションを作成するときに、
下記のように、
[
コンフィギュレーション
](
concept-configurations.md
)
を読み込んで、それをアプリケーションに適用します:
```
php
require
(
__DIR__
.
'/../vendor/autoload.php'
);
require
(
__DIR__
.
'/../vendor/yiisoft/yii2/Yii.php'
);
// アプリケーションのコンフィギュレーションを読み込む
$config
=
require
(
__DIR__
.
'/../config/web.php'
);
// アプリケーションのインスタンスを作成し、コンフィギュレーションを適用する
(
new
yii\web\Application
(
$config
))
->
run
();
```
通常の
[
コンフィギュレーション
](
concept-configurations.md
)
と同じように、アプリケーションのコンフィギュレーションは、アプリケーションオブジェクトのプロパティをどのように初期化するかを規定するものです。
アプリケーションのコンフィギュレーションは、たいていは非常に複雑なものですから、通常は、上記の例の
`web.php`
ファイルのように、
[
コンフィギュレーションファイル
](
concept-configurations.md#configuration-files
)
に保管されます。
## アプリケーションのプロパティ<a name="application-properties"></a>
アプリケーションのコンフィギュレーションで構成すべき重要なアプリケーションのプロパティは数多くあります。
それらのプロパティの典型的なものは、アプリケーションが走る環境を記述するものです。
例えば、アプリケーションは、どのようにして
[
コントローラ
](
structure-controllers.md
)
をロードするか、また、どこにテンポラリファイルを保存するかなどを知らなければなりません。
以下において、それらのプロパティを要約します。
### 必須のプロパティ<a name="required-properties"></a>
どのアプリケーションでも、最低二つのプロパティは構成しなければなりません:
すなわち、
[
[yii\base\Application::id|id
]
] と
[
[yii\base\Application::basePath|basePath
]
] です。
#### [[yii\base\Application::id|id]] <a name="id"></a>
[
[yii\base\Application::id|id
]
] プロパティは、アプリケーションを他のアプリケーションから区別するユニークな ID を規定します。
このプロパティは主としてプログラム的に使われます。
必須ではありませんが、最良の相互運用性を確保するために、アプリケーション ID を規定するときに英数字だけを使うことが推奨されます。
#### [[yii\base\Application::basePath|basePath]] <a name="basePath"></a>
[
[yii\base\Application::basePath|basePath
]
] プロパティは、アプリケーションのルートディレクトリを規定します。
これは、アプリケーションシステムの全ての保護されたソースコードを収容するディレクトリです。
通常、このディレクトリの下に、MVC パターンに対応するソースコードを収容した
`models`
、
`views`
、
`controllers`
などのサブディレクトリがあります。
[
[yii\base\Application::basePath|basePath
]
] プロパティの構成には、ディレクトリパスを使っても、
[
パスエイリアス
](
concept-aliases.md
)
を使っても構いません。
どちらの形式においても、対応するディレクトリが存在しなければなりません。
さもなくば、例外が投げられます。
パスは
`realpath()`
関数を呼び出して正規化されます。
[
[yii\base\Application::basePath|basePath
]
] プロパティは、しばしば、他の重要なパス (例えば、runtime のパス) を派生させるために使われます。
このため、
`basePath`
を示す
`@app`
というパスエイリアスが、あらかじめ定義されています。
その結果、派生的なパスはこのエイリアスを使って形成することが出来ます
(例えば、runtime ディレクトリを示す
`@app/runtime`
など)。
### 重要なプロパティ<a name="important-properties"></a>
この項で説明するプロパティは、アプリケーションが異なるごとに異なってくるものであるため、たいてい、構成する必要が生じます。
#### [[yii\base\Application::aliases|aliases]] <a name="aliases"></a>
このプロパティを使って、配列形式で一連の
[
エイリアス
](
concept-aliases.md
)
を定義することが出来ます。
配列のキーがエイリアスの名前であり、配列の値が対応するパスの定義です。
例えば、
```
php
[
'aliases'
=>
[
'@name1'
=>
'path/to/path1'
,
'@name2'
=>
'path/to/path2'
,
],
]
```
このプロパティが提供されているのは、
[
[Yii::setAlias()
]
] メソッドを呼び出す代りに、アプリケーションのコンフィギュレーションを使ってエイリアスを定義することが出来るようにするためです。
#### [[yii\base\Application::bootstrap|bootstrap]] <a name="bootstrap"></a>
これは非常に有用なプロパティです。
これによって、アプリケーションの
[
[yii\base\Application::bootstrap()|ブートストラップの過程
]
] において走らせるべきコンポーネントを配列として規定することが出来ます。
例えば、ある
[
モジュール
](
structure-modules.md
)
に
[
URL 規則
](
runtime-url-handling.md
)
をカスタマイズさせたいときに、モジュールの ID をこのプロパティの要素として挙げることが出来ます。
このプロパティに挙げるコンポーネントは、それぞれ、以下の形式のいずれかによって規定することが出来ます:
-
[
components
](
#components
)
によって規定されるアプリケーションコンポーネントの ID。
-
[
modules
](
#modules
)
によって規定されるモジュールの ID。
-
クラス名。
-
コンフィギュレーション配列。
-
コンポーネントを作成して返す無名関数。
例えば、
```
php
[
'bootstrap'
=>
[
// アプリケーションコンポーネント ID、または、モジュール ID
'demo'
,
// クラス名
'app\components\Profiler'
,
// コンフィギュレーション配列
[
'class'
=>
'app\components\Profiler'
,
'level'
=>
3
,
],
// 無名関数
function
()
{
return
new
app\components\Profiler
();
}
],
]
```
> Info|情報: モジュール ID と同じ ID のアプリケーションコンポーネントがある場合は、ブートストラップの過程ではアプリケーションコンポーネントが使われます。
代りにモジュールを使いたいときは、次のように、無名関数を使って指定することが出来ます:
>```php
[
function () {
return Yii::$app->getModule('user');
},
]
```
ブートストラップの過程で、各コンポーネントのインスタンスが作成されます。
そして、コンポーネントクラスが [[yii\base\BootstrapInterface]] を実装している場合は、その [[yii\base\BootstrapInterface::bootstrap()|bootstrap()]] メソッドも呼び出されます。
もう一つの実用的な例が [ベーシックアプリケーションテンプレート](start-installation.md) のアプリケーションのコンフィギュレーションの中にあります。
そこでは、アプリケーションが開発環境で走るときには `debug` モジュールと `gii` モジュールがブートストラップコンポーネントとして構成されています。
```
php
if (YII_ENV_DEV) {
// 'dev' 環境のためのコンフィギュレーションの調整
$config
[
'bootstrap'
][]
= 'debug';
$config
[
'modules'
][
'debug'
]
= 'yii
\d
ebug
\M
odule';
$config['bootstrap'][] = 'gii';
$config['modules']['gii'] = 'yii\gii\Module';
}
```
> Note|注意: あまり多くのコンポーネントを `bootstrap` に置くと、アプリケーションのパフォーマンスを劣化させます。
なぜなら、リクエストごとに同じ一連のコンポーネントを走らせなければならないからです。
ですから、ブートストラップコンポーネントは賢く使ってください。
#### [[yii\web\Application::catchAll|catchAll]] <a name="catchAll"></a>
このプロパティは [[yii\web\Application|ウェブアプリケーション]] においてのみサポートされます。
これは、全てのユーザリクエストを処理すべき [コントローラアクション](structure-controllers.md) を規定します。
これは主としてアプリケーションがメンテナンスモードにあって、入ってくる全てのリクエストを単一のアクションで処理する必要があるときに使われます。
コンフィギュレーションは配列の形を取り、最初の要素はアクションのルートを指定します。
そして、配列の残りの要素 (キー・値のペア) は、アクションに渡されるパラメータを指定します。
例えば、
```
php
[
'catchAll' =>
[
'offline/notice',
'param1' => 'value1',
'param2' => 'value2',
],
]
```
#### [[yii\base\Application::components|components]] <a name="components"></a>
これが唯一最重要なプロパティです。これによって、[アプリケーションコンポーネント](structure-application-components.md) と呼ばれる一連の名前付きのコンポーネントを登録して、それらを他の場所で使うことが出来るようになります。
例えば、
```
php
[
'components' =>
[
'cache' =>
[
'class' => 'yii
\c
aching
\F
ileCache',
],
'user' =>
[
'identityClass' => 'app
\m
odels
\U
ser',
'enableAutoLogin' => true,
],
],
]
```
全てのアプリケーションコンポーネントは、それぞれ、配列の中で「キー・値」のペアとして規定されます。
キーはコンポーネントの ID を示し、値はコンポーネントのクラス名または [コンフィギュレーション](concept-configurations.md) を示します。
どのようなコンポーネントでもアプリケーションとともに登録することが出来ます。
そして登録されたコンポーネントは、後で、`\Yii::$app->ComponentID` という式を使ってグローバルにアクセスすることが出来ます。
詳細は [アプリケーションコンポーネント](structure-application-components.md) の節を呼んでください。
#### [[yii\base\Application::controllerMap|controllerMap]] <a name="controllerMap"></a>
このプロパティは、コントローラ ID を任意のコントローラクラスに割り付けることを可能にするものです。
既定では、Yii は [規約](#controllerNamespace) に基いてコントローラ ID をコントローラクラスに割り付けます
(例えば、`post` という ID は `app\controllers\PostController` に割り付けられます)。
このプロパティを構成することによって、特定のコントローラに対する規約を破ることが出来ます。
下記の例では、`account` は `app\controllers\UserController` に割り付けられ、
`article` は `app\controllers\PostController` に割り付けられることになります。
```
php
[
'controllerMap' =>
[
[
'account' => 'app
\c
ontrollers
\U
serController',
'article' =>
[
'class' => 'app
\c
ontrollers
\P
ostController',
'enableCsrfValidation' => false,
],
],
],
]
```
このプロパティの配列のキーはコントローラ ID を表し、配列の値は対応するコントローラクラスの名前または [コンフィギュレーション](concept-configurations.md) を表します。
#### [[yii\base\Application::controllerNamespace|controllerNamespace]] <a name="controllerNamespace"></a>
このプロパティは、コントローラクラスが配置されるべき既定の名前空間を指定するものです。
デフォルト値は `app\controllers` です。
コントローラ ID が `post` である場合、規約によって対応するコントローラの (名前空間を略した) クラス名は `PostController` となり、
完全修飾クラス名は `app\controllers\PostController` となります。
コントローラクラスは、この名前空間に対応するディレクトリのサブディレクトリに配置されても構いません。
例えば、コントローラ ID として `admin/post` を仮定すると、対応するコントローラの完全修飾クラス名は `app\controllers\admin\PostController` となります。
完全修飾のコントローラクラスが [オートロード可能](concept-autoloading.md) でなければならず、
コントローラクラスの実際の名前空間がこのプロパティと合致していなければならない、
ということは非常に重要なことです。
そうでないと、アプリケーションにアクセスしたときに "ページがみつかりません" というエラーを受け取ることになります。
上述の規約を破りたい場合は、[controllerMap](#controllerMap) プロパティを構成することが出来ます。
#### [[yii\base\Application::language|language]] <a name="language"></a>
このプロパティは、アプリケーションがコンテンツをエンドユーザに表示するときに使うべき言語を規定します。
このプロパティのデフォルト値は `en` であり、英語を意味します。
アプリケーションが多言語をサポートする必要があるときは、このプロパティを構成すべきです。
このプロパティの値が、メッセージの翻訳、日付の書式、数字の書式などを含めて、[国際化](tutorial-i18n.md) のさまざまな側面を決定します。
例えば、[[yii\jui\DatePicker]] ウィジェットは、どの言語でカレンダーを表示すべきか、そして日付をどのように書式設定すべきかを、既定では、このプロパティを使用して決定します。
言語を指定するのには、[IETF 言語タグ](http://ja.wikipedia.org/wiki/IETF%E8%A8%80%E8%AA%9E%E3%82%BF%E3%82%B0) に従うことが推奨されます。
例えば、`en` は英語を意味し、`en-US` はアメリカ合衆国の英語を意味します。
このプロパティに関する更なる詳細は [国際化](tutorial-i18n.md) の節で読むことが出来ます。
#### [[yii\base\Application::modules|modules]] <a name="modules"></a>
このプロパティはアプリケーションが含む [モジュール](structure-modules.md) を規定します。
このプロパティは、モジュールのクラスまたは [コンフィギュレーション](concept-configurations.md) の配列であり、
その配列のキーはモジュールの ID です。例えば、
```
php
[
'modules' =>
[
// モジュールクラスで規定された "booking" モジュール
'booking' => 'app
\m
odules
\b
ooking
\B
ookingModule',
// コンフィギュレーション配列で規定された "comment" モジュール
'comment' => [
'class' => 'app\modules\comment\CommentModule',
'db' => 'db',
],
],
]
```
詳細は [モジュール](structure-modules.md) の節を参照してください。
#### [[yii\base\Application::name|name]] <a name="name"></a>
このプロパティはアプリケーション名を規定します。これは、エンドユーザに対して表示されるかも知れません。
[[yii\base\Application::id|id]] プロパティがユニークな値でなければならないのとは違って、このプロパティの値は
主として表示目的であり、ユニークである必要はありません。
コードで使わないのであれば、このプロパティを構成する必要はありません。
#### [[yii\base\Application::params|params]] <a name="params"></a>
このプロパティは、グローバルにアクセス可能なアプリケーションパラメータの配列を規定します。
コードの中のいたる処でハードコードされた数値や文字列を使う代りに、それらをアプリケーションパラメータとして
一ヶ所で定義し、必要な場所ではそのパラメータを使うというのが良い慣行です。
例えば、次のように、サムネール画像のサイズをパラメータとして定義することが出来ます:
```
php
[
'params' =>
[
'thumbnail.size' =>
[
128, 128
]
,
],
]
```
そして、このサイズの値を使う必要があるコードにおいては、ただ単に下記のようなコードを使うことが出来ます:
```
php
$size =
\Y
ii::$app->params
[
'thumbnail.size'
]
;
$width =
\Y
ii::$app->params
[
'thumbnail.size'
][
0
]
;
```
後でサムネールのサイズを変更すると決めたときは、アプリケーションのコンフィギュレーションにおいてのみサイズを修正すればよく、
これに依存するコードには少しも触れる必要がありません。
#### [[yii\base\Application::sourceLanguage|sourceLanguage]] <a name="sourceLanguage"></a>
このプロパティはアプリケーションコードが書かれている言語を規定します。デフォルト値は`'en-US'`、アメリカ合衆国の英語です。
あなたのコードのテキスト内容が英語以外で書かれているときは、このプロパティを構成すべきです。
[language](#language) プロパティと同様に、このプロパティは [IETF 言語タグ](http://ja.wikipedia.org/wiki/IETF%E8%A8%80%E8%AA%9E%E3%82%BF%E3%82%B0) に従って構成すべきです。
例えば、`en` は英語を意味し、`en-US` はアメリカ合衆国の英語を意味します。
このプロパティに関する更なる詳細は [国際化](tutorial-i18n.md) の節で読むことが出来ます。
#### [[yii\base\Application::timeZone|timeZone]] <a name="timeZone"></a>
このプロパティは、PHP ランタイムのデフォルトタイムゾーンを設定する代替手段として提供されています。
このプロパティを構成すると、本質的には PHP 関数 [date_default_timezone_set()](http://php.net/manual/ja/function.date-default-timezone-set.php) を呼ぶことになります。
例えば、
```
php
[
'timeZone' => 'Asia/Tokyo',
]
```
#### [[yii\base\Application::version|version]] <a name="version"></a>
このプロパティはアプリケーションのバージョンを規定します。デフォルト値は `'1.0'` です。
コードの中で使わないのであれば、必ずしも構成する必要はありません。
### 有用なプロパティ <a name="useful-properties"></a>
この項で説明されるプロパティは通常は構成されません。というのは、そのデフォルト値が通常の規約を規定するものだからです。
しかしながら、規約を破る必要がある場合には、これらのプロパティを構成することが出来ます。
#### [[yii\base\Application::charset|charset]] <a name="charset"></a>
このプロパティはアプリケーションが使う文字セットを規定します。デフォルト値は `'UTF-8'` であり、
あなたのアプリケーションが多数の非ユニコードデータを使うレガシーシステムと連携するのでなければ、
そのままにしておくべきです。
#### [[yii\base\Application::defaultRoute|defaultRoute]] <a name="defaultRoute"></a>
このプロパティは、リクエストがルートを指定していないときにアプリケーションが使用すべき [route](runtime-routing.md) を規定します。
ルートは、チャイルドモジュール ID、コントローラ ID、および/または アクション ID を構成要素とすることが出来ます。
例えば、`help`、`post/create`、`admin/post/create` などです。
アクション ID が与えられていない場合は、[[yii\base\Controller::defaultAction]] で規定されるデフォルト値を取ります。
[[yii\web\Application|ウェブアプリケーション]] では、このプロパティのデフォルト値は `'site'` であり、
その意味するところは、`SiteController` コントローラとそのデフォルトアクションが使用されるべきである、ということです。
結果として、ルートを指定せずにアプリケーションにアクセスすると、`app\controllers\SiteController::actionIndex()` の結果が表示されます。
[[yii\console\Application|コンソールアプリケーション]] では、デフォルト値は `'help'` であり、コアコマンドの [[yii\console\controllers\HelpController::actionIndex()]] が使用されるべきであるという意味です。
結果として、引数を与えずに `yii` というコマンドを走らせると、ヘルプ情報が表示されることになります。
#### [[yii\base\Application::extensions|extensions]] <a name="extensions"></a>
このプロパティは、アプリケーションにインストールされて使われる [エクステンション](structure-extensions.md) を規定するリストです。
デフォルトでは、`@vendor/yiisoft/extensions.php` というファイルによって返される配列を取ります。
`extensions.php` は、[Composer](http://getcomposer.org) を使ってエクステンションをインストールすると、自動的に生成され保守されます。
ですから、たいていの場合、このプロパティをあなたが構成する必要はありません。
エクステンションを手作業で保守したいという特殊なケースにおいては、次のようにしてこのプロパティを構成することが出来ます:
```
php
[
'extensions' =>
[
[
'name' => 'extension name',
'version' => 'version number',
'bootstrap' => 'BootstrapClassName', // オプション、コンフィギュレーション配列でもよい
'alias' =>
[
// optional
'@alias1' => 'to/path1',
'@alias2' => 'to/path2',
],
],
// ... 上記と同じように、更にエクステンションを構成 ...
],
]
```
見て分かるように、このプロパティはエクステンションの仕様を示す配列を取ります。
それぞれのエクステンションは、`name` と `version` の要素を含む配列によって規定されます。
エクステンションが [ブートストラップ](runtime-bootstrapping.md) の過程で走る必要がある場合には、
`bootstrap` 要素をブートストラップのクラス名または [コンフィギュレーション](concept-configurations.md) 配列によって規定することが出来ます。
また、エクステンションはいくつかの [エイリアス](concept-aliases.md) を定義することも出来ます。
#### [[yii\base\Application::layout|layout]] <a name="layout"></a>
このプロパティは、[ビュー](structure-views.md) を描画するときに使われるべきデフォルトのレイアウトを規定します。
デフォルト値は `'main'` であり、[レイアウトパス](#layoutPath) の下にある `main.php` というファイルが使われるべき事を意味します。
[レイアウトパス](#layoutPath) と [ビューパス](#viewPath) の両方がデフォルト値を取る場合、
デフォルトのレイアウトファイルは `@app/views/layouts/main.php` というパスエイリアスとして表すことが出来ます。
滅多には無いことですが、レイアウトをデフォルトで無効にしたい場合は、このプロパティを `false` として構成することが出来ます。
#### [[yii\base\Application::layoutPath|layoutPath]] <a name="layoutPath"></a>
このプロパティは、レイアウトファイルが捜されるべきパスを規定します。
デフォルト値は、[ビューパス](#viewPath) の下の `layouts` サブディレクトリです。
[ビューパス](#viewPath) がデフォルト値を取る場合、デフォルトのレイアウトパスは `@app/views/layouts` というパスエイリアスとして表すことが出来ます。
このプロパティはディレクトリまたはパス [エイリアス](concept-aliases.md) として構成することが出来ます。
#### [[yii\base\Application::runtimePath|runtimePath]] <a name="runtimePath"></a>
このプロパティは、ログファイルやキャッシュファイルなどの一時的ファイルを生成することが出来るパスを規定します。
デフォルト値は、`@app/runtime` というエイリアスで表現されるディレクトリです。
このプロパティはディレクトリまたはパス [エイリアス](concept-aliases.md) として構成することが出来ます。
ランタイムパスは、アプリケーションを走らせているプロセスによって書き込みが可能なものでなければならないことに注意してください。
そして、この下にある一時的ファイルは秘匿を要する情報を含みうるものですので、ランタイムパスはエンドユーザによるアクセスから保護されるべきです。
このパスに簡単にアクセスできるように、Yii は `@runtime` というパスエイリアスを事前に定義しています。
#### [[yii\base\Application::viewPath|viewPath]] <a name="viewPath"></a>
このプロパティはビューファイルが配置されるルートディレクトリを規定します。
デフォルト値は、`@app/views` というエイリアスで表現されるディレクトリです。
このプロパティはディレクトリまたはパス [エイリアス](concept-aliases.md) として構成することが出来ます。
#### [[yii\base\Application::vendorPath|vendorPath]] <a name="vendorPath"></a>
このプロパティは、[Composer](http://getcomposer.org) によって管理される vendor ディレクトリを規定します。
Yii フレームワークを含めて、あなたのアプリケーションによって使われる全てのサードパーティライブラリを格納するディレクトリです。
デフォルト値は、`@app/vendor` というエイリアスで表現されるディレクトリです。
このプロパティはディレクトリまたはパス [エイリアス](concept-aliases.md) として構成することが出来ます。
このプロパティを修正するときは、必ず、Composer の構成もそれに合せて調整してください。
You may configure this property as a directory or a path [alias](concept-aliases.md). When you modify
this property, make sure you also adjust the Composer configuration accordingly.
このパスに簡単にアクセスできるように、Yii は `@vendor` というパスエイリアスを事前に定義しています。
#### [[yii\console\Application::enableCoreCommands|enableCoreCommands]] <a name="enableCoreCommands"></a>
このプロパティは [[yii\console\Application|コンソールアプリケーション]] においてのみサポートされています。
Yii リリースに含まれているコアコマンドを有効にすべきか否かを規定します。デフォルト値は `true` です。
## アプリケーションのイベント<a name="application-events"></a>
アプリケーションはリクエストを処理するライフサイクルの中でいくつかのイベントを発生させます。
これらのイベントに対して、下記のようにして、アプリケーションのコンフィギュレーションの中でイベントハンドラを付けることが出来ます。
An application triggers several events during the lifecycle of handling an request. You may attach event
handlers to these events in application configurations like the following,
```
php
[
'on beforeRequest' => function ($event) {
// ...
},
]
```
`on eventName` という構文の使い方については、[コンフィギュレーション](concept-configurations.md#configuration-format) の節で説明されています。
別の方法として、アプリケーションのインスタンスが生成された後、[ブートストラップの過程](runtime-bootstrapping.md) の中でイベントハンドラを付けることも出来ます。
例えば、
```
php
\Y
ii::$app->on(
\y
ii
\b
ase
\A
pplication::EVENT_BEFORE_REQUEST, function ($event) {
// ...
});
```
### [[yii\base\Application::EVENT_BEFORE_REQUEST|EVENT_BEFORE_REQUEST]] <a name="beforeRequest"></a>
このイベントは、アプリケーションがリクエストを処理する *前* に発生します。
実際のイベント名は `beforeRequest` です。
このイベントが発生するときには、アプリケーションのインスタンスは既に構成されて初期化されています。
ですから、イベントメカニズムを使って、リクエスト処理のプロセスに横槍を入れるカスタムコードを挿入するのには、ちょうど良い場所です。
例えば、このイベントハンドラの中で、何らかのパラメータに基いて [[yii\base\Application::language]] プロパティを動的にセットすることが出来ます。
### [[yii\base\Application::EVENT_AFTER_REQUEST|EVENT_AFTER_REQUEST]] <a name="afterRequest"></a>
このイベントは、アプリケーションがリクエストの処理を完了した *後*、レスポンスを送信する *前* に発生します。
実際のイベント名は `afterRequest` です。
このイベントが発生するときにはリクエストの処理は完了していますので、この機をとらえて、リクエストに対する何らかの後処理をしたり、レスポンスをカスタマイズしたりすることが出来ます。
[[yii\web\Response|response]] コンポーネントも、エンドユーザにレスポンスのコンテンツを送出する間にいくつかのイベントを発生させることに注意してください。
それらのイベントは、このイベントの *後* に発生します。
### [[yii\base\Application::EVENT_BEFORE_ACTION|EVENT_BEFORE_ACTION]] <a name="beforeAction"></a>
このイベントは、[コントローラアクション](structure-controllers.md) を走らせる *前* に毎回発生します。
実際のイベント名は `beforeAction` です。
イベントのパラメータは [[yii\base\ActionEvent]] のインスタンスです。
イベントハンドラは、[[yii\base\ActionEvent::isValid]] プロパティを `false` にセットして、アクションが走るのを止めることが出来ます。
例えば、
```
php
[
'on beforeAction' => function ($event) {
if (some condition) {
$event->isValid = false;
} else {
}
},
]
```
同じ `beforeAction` イベントが、[モジュール](structure-modules.md) と [コントローラ](structure-controllers.md)
からも発生することに注意してください。
アプリケーションオブジェクトが最初にこのイベントを発生させ、次に (もし有れば) モジュールが、そして最後にコントローラがこのイベントを発生させます。
イベントハンドラが [[yii\base\ActionEvent::isValid]] を `false` にセットすると、後続のイベントは発生しません。
### [[yii\base\Application::EVENT_AFTER_ACTION|EVENT_AFTER_ACTION]] <a name="afterAction"></a>
このイベントは、[コントローラアクション](structure-controllers.md) が走った *後* に毎回発生します。
実際のイベント名は `afterAction` です。
イベントのパラメータは [[yii\base\ActionEvent]] のインスタンスです。
[[yii\base\ActionEvent::result]] プロパティを通じて、イベントハンドラはアクションの結果にアクセスしたり、またはアクションの結果を修正したり出来ます。
例えば、
```
php
[
'on afterAction' => function ($event) {
if (some condition) {
// $event->result を修正する
} else {
}
},
]
```
同じ
`afterAction`
イベントが、
[
モジュール
](
structure-modules.md
)
と
[
コントローラ
](
structure-controllers.md
)
からも発生することに注意してください。
これらのオブジェクトは、
`beforeAction`
の場合とは逆の順でイベントを発生させます。
すなわち、コントローラオブジェクトが最初にこのイベントを発生させ、次に (もし有れば) モジュールが、そして最後にアプリケーションがこのイベントを発生させます。
## アプリケーションのライフサイクル<a name="application-lifecycle"></a>
[
エントリスクリプト
](
structure-entry-scripts.md
)
が実行されて、リクエストが処理されるとき、
アプリケーションは次のようなライフサイクルを経ます:
1.
エントリスクリプトがアプリケーションのコンフィギュレーションを配列として読み出す。
2.
エントリスクリプトがアプリケーションの新しいインスタンスを作成する:
*
[
[yii\base\Application::preInit()|preInit()
]
] が呼び出されて、
[
[yii\base\Application::basePath|basePath
]
]
のような、優先度の高いアプリケーションプロパティを構成する。
*
[
[yii\base\Application::errorHandler|エラーハンドラ
]
] を登録する。
*
アプリケーションのプロパティを構成する。
*
[
[yii\base\Application::init()|init()
]
] が呼ばれ、そこから更に、ブートストラップコンポーネントを
走らせるために、
[
[yii\base\Application::bootstrap()|bootstrap()
]
] が呼ばれる。
3.
エントリスクリプトが
[
[yii\base\Application::run()
]
] を呼んで、アプリケーションを走らせる:
*
[
[yii\base\Application::EVENT_BEFORE_REQUEST|EVENT_BEFORE_REQUEST
]
] イベントを発生させる。
*
リクエストを処理する: リクエストを
[
ルート
](
runtime-routing.md
)
とそれに結び付くパラメータとして解決する;
ルートによって指定されたモジュール、コントローラ、および、アクションを作成する; そしてアクションを走らせる。
*
[
[yii\base\Application::EVENT_AFTER_REQUEST|EVENT_AFTER_REQUEST
]
] イベントを発生させる。
*
エンドユーザにレスポンスを送信する。
4.
エントリスクリプトがアプリケーションから終了ステータスを受け取り、リクエストの処理を完了する。
docs/guide-ja/structure-entry-scripts.md
View file @
74666f74
...
@@ -19,7 +19,7 @@
...
@@ -19,7 +19,7 @@
*
グローバルな定数を定義する;
*
グローバルな定数を定義する;
*
[
Composer のオートローダ
](
http://getcomposer.org/doc/01-basic-usage.md#autoloading
)
を登録する;
*
[
Composer のオートローダ
](
http://getcomposer.org/doc/01-basic-usage.md#autoloading
)
を登録する;
*
[
[Yii
]
] クラスファイルをインクルードする;
*
[
[Yii
]
] クラスファイルをインクルードする;
*
アプリケーション
設定
を読み出す;
*
アプリケーション
のコンフィギュレーション
を読み出す;
*
[
アプリケーション
](
structure-applications.md
)
のインスタンスを生成して構成する;
*
[
アプリケーション
](
structure-applications.md
)
のインスタンスを生成して構成する;
*
[
[yii\base\Application::run()
]
] を呼んで、受け取ったリクエストを処理する。
*
[
[yii\base\Application::run()
]
] を呼んで、受け取ったリクエストを処理する。
...
@@ -40,7 +40,7 @@ require(__DIR__ . '/../vendor/autoload.php');
...
@@ -40,7 +40,7 @@ require(__DIR__ . '/../vendor/autoload.php');
// Yii クラスファイルをインクルード
// Yii クラスファイルをインクルード
require
(
__DIR__
.
'/../vendor/yiisoft/yii2/Yii.php'
);
require
(
__DIR__
.
'/../vendor/yiisoft/yii2/Yii.php'
);
// アプリケーション
設定
を読み出す
// アプリケーション
のコンフィギュレーション
を読み出す
$config
=
require
(
__DIR__
.
'/../config/web.php'
);
$config
=
require
(
__DIR__
.
'/../config/web.php'
);
// アプリケーションを作成し、構成して、走らせる
// アプリケーションを作成し、構成して、走らせる
...
@@ -75,7 +75,7 @@ require(__DIR__ . '/vendor/autoload.php');
...
@@ -75,7 +75,7 @@ require(__DIR__ . '/vendor/autoload.php');
// Yii クラスファイルをインクルード
// Yii クラスファイルをインクルード
require
(
__DIR__
.
'/vendor/yiisoft/yii2/Yii.php'
);
require
(
__DIR__
.
'/vendor/yiisoft/yii2/Yii.php'
);
// アプリケーション
設定
を読み出す
// アプリケーション
のコンフィギュレーション
を読み出す
$config
=
require
(
__DIR__
.
'/config/console.php'
);
$config
=
require
(
__DIR__
.
'/config/console.php'
);
$application
=
new
yii\console\Application
(
$config
);
$application
=
new
yii\console\Application
(
$config
);
...
@@ -95,7 +95,7 @@ Yii は下記の三つの定数をサポートしています:
...
@@ -95,7 +95,7 @@ Yii は下記の三つの定数をサポートしています:
この理由により、デバッグモードは主として開発時に使用されるべきものとなります。
この理由により、デバッグモードは主として開発時に使用されるべきものとなります。
`YII_DEBUG`
の既定値は false です。
`YII_DEBUG`
の既定値は false です。
*
`YII_ENV`
: どういう環境でアプリケーションが走るかを規定します。
*
`YII_ENV`
: どういう環境でアプリケーションが走るかを規定します。
詳細については、
[
設定
](
concept-configurations.md#environment-constants
)
の節で説明されます。
詳細については、
[
コンフィギュレーション
](
concept-configurations.md#environment-constants
)
の節で説明されます。
`YII_ENV`
の既定値は
`'prod'`
です。これはアプリケーションが実運用環境で走ることを意味します。
`YII_ENV`
の既定値は
`'prod'`
です。これはアプリケーションが実運用環境で走ることを意味します。
*
`YII_ENABLE_ERROR_HANDLER`
: Yii によって提供されるエラーハンドラを有効にするかどうかを規定します。
*
`YII_ENABLE_ERROR_HANDLER`
: Yii によって提供されるエラーハンドラを有効にするかどうかを規定します。
この定数の既定値は true です。
この定数の既定値は true です。
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment