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
84976bd7
Commit
84976bd7
authored
Feb 01, 2015
by
Nobuo Kihara
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
docs/guide-ja/runtime - review [ci skip]
parent
0f5051b3
Show whitespace changes
Inline
Side-by-side
Showing
7 changed files
with
66 additions
and
79 deletions
+66
-79
input-tabular-input.md
docs/guide-ja/input-tabular-input.md
+0
-2
runtime-bootstrapping.md
docs/guide-ja/runtime-bootstrapping.md
+4
-6
runtime-overview.md
docs/guide-ja/runtime-overview.md
+1
-1
runtime-requests.md
docs/guide-ja/runtime-requests.md
+4
-4
runtime-responses.md
docs/guide-ja/runtime-responses.md
+7
-8
runtime-routing.md
docs/guide-ja/runtime-routing.md
+38
-46
runtime-sessions-cookies.md
docs/guide-ja/runtime-sessions-cookies.md
+12
-12
No files found.
docs/guide-ja/input-tabular-input.md
View file @
84976bd7
...
@@ -60,8 +60,6 @@ class SettingsController extends Controller
...
@@ -60,8 +60,6 @@ class SettingsController extends Controller
次に、
`update`
ビューにあるフォームです。
次に、
`update`
ビューにあるフォームです。
Now the form that's in
`update`
view:
```
php
```
php
<?php
<?php
use
yii\helpers\Html
;
use
yii\helpers\Html
;
...
...
docs/guide-ja/runtime-bootstrapping.md
View file @
84976bd7
...
@@ -17,10 +17,8 @@
...
@@ -17,10 +17,8 @@
4.
[
[yii\base\Application::init()|init()
]
] が呼ばれます。
4.
[
[yii\base\Application::init()|init()
]
] が呼ばれます。
そして
`init()`
が
[
[yii\base\Application::bootstrap()|bootstrap()
]
] を呼んで、ブートストラップコンポーネントを走らせます。
そして
`init()`
が
[
[yii\base\Application::bootstrap()|bootstrap()
]
] を呼んで、ブートストラップコンポーネントを走らせます。
-
エクステンションマニフェストファイル
`vendor/yiisoft/extensions.php`
をインクルードします。
-
エクステンションマニフェストファイル
`vendor/yiisoft/extensions.php`
をインクルードします。
-
エクステンションによって宣言された
[
ブートストラップコンポーネント
](
structure-extensions.md#bootstrapping-classes
)
を作成して走らせます。
-
エクステンションによって宣言された
[
ブートストラップコンポーネント
](
structure-extensions.md#bootstrapping-classes
)
を作成して実行します。
-
アプリケーションの
[
bootstrap プロパティ
](
structure-applications.md#bootstrap
)
に宣言されている
-
アプリケーションの
[
bootstrap プロパティ
](
structure-applications.md#bootstrap
)
に宣言されている
[
アプリケーションコンポーネント
](
structure-application-components.md
)
および/または
[
モジュール
](
structure-modules.md
)
を作成して実行します。
[
アプリケーションコンポーネント
](
structure-application-components.md
)
および/または
[
モジュール
](
structure-modules.md
)
を作成して走らせます。
ブートストラップの仕事は
*全て*
のリクエストを処理する前に、毎回しなければなりませんので、この過程を軽いものに保って可能な限り最適化することは非常に重要なことです。
ブートストラップの仕事は
*全て*
のリクエストを処理する前に、毎回しなければなりませんので、この過程を軽いものに保って可能な限り最適化することは非常に重要なことです。
...
@@ -29,10 +27,10 @@
...
@@ -29,10 +27,10 @@
例えば、モジュールが追加の URL 解析規則を登録する必要がある場合は、モジュールを
[
bootstrap プロパティ
](
structure-applications.md#bootstrap
)
のリストに挙げなければなりません。
例えば、モジュールが追加の URL 解析規則を登録する必要がある場合は、モジュールを
[
bootstrap プロパティ
](
structure-applications.md#bootstrap
)
のリストに挙げなければなりません。
なぜなら、URL 規則を使ってリクエストが解決される前に、新しい URL 規則を有効にしなければならないからです。
なぜなら、URL 規則を使ってリクエストが解決される前に、新しい URL 規則を有効にしなければならないからです。
実
運用モードにおいては、
[
PHP OPCache
]
や
[
APC
]
など、バイトコードキャッシュを有効にして、PHP ファイルをインクルードして解析するのに要する時間を最小化してください。
本番
運用モードにおいては、
[
PHP OPCache
]
や
[
APC
]
など、バイトコードキャッシュを有効にして、PHP ファイルをインクルードして解析するのに要する時間を最小化してください。
[
PHP OPcache
]:
http://php.net/manual/ja/book.opcache.php
[
PHP OPcache
]:
http://php.net/manual/ja/book.opcache.php
[
APC
]:
http://php.net/manual/ja/book.apc.php
[
APC
]:
http://php.net/manual/ja/book.apc.php
大規模なアプリケーションには、多数の小さな構成情報ファイルに分割された、非常に複雑なアプリケーション
[
構成情報
](
concept-configurations.md
)
を持つものがあります。
大規模なアプリケーションには、多数の小さな構成情報ファイルに分割された、非常に複雑なアプリケーション
[
構成情報
](
concept-configurations.md
)
を持つものがあります。
そのような場合には、構成情報配列全体をキャッシュしておき、エントリスクリプトでアプリケーションのインスタンスを作成する前に
は、構成情報配列を
キャッシュからロードするという方法を考慮してください。
そのような場合には、構成情報配列全体をキャッシュしておき、エントリスクリプトでアプリケーションのインスタンスを作成する前に
構成情報をロードするときには、配列全体を直接に
キャッシュからロードするという方法を考慮してください。
docs/guide-ja/runtime-overview.md
View file @
84976bd7
概要
概要
====
====
Yii のアプリケーションがリクエストを処理するときは、毎回、同じような
作業の流れを経験し
ます。
Yii のアプリケーションがリクエストを処理するときは、毎回、同じような
ワークフローになり
ます。
1.
ユーザが
[
エントリスクリプト
](
structure-entry-scripts.md
)
`web/index.php`
にリクエストをします。
1.
ユーザが
[
エントリスクリプト
](
structure-entry-scripts.md
)
`web/index.php`
にリクエストをします。
2.
エントリスクリプトは、アプリケーションの
[
構成情報
](
concept-configurations.md
)
をロードして、リクエストを処理するための
[
アプリケーション
](
structure-applications.md
)
のインスタンスを作成します。
2.
エントリスクリプトは、アプリケーションの
[
構成情報
](
concept-configurations.md
)
をロードして、リクエストを処理するための
[
アプリケーション
](
structure-applications.md
)
のインスタンスを作成します。
...
...
docs/guide-ja/runtime-requests.md
View file @
84976bd7
...
@@ -58,7 +58,7 @@ $param = $request->getBodyParam('id');
...
@@ -58,7 +58,7 @@ $param = $request->getBodyParam('id');
## リクエストメソッド <span id="request-methods"></span>
## リクエストメソッド <span id="request-methods"></span>
現在のリクエストに使用された HTTP メソッドは、
`Yii::$app->request->method`
という式によって取得することが出来ます。
現在のリクエストに使用された HTTP メソッドは、
`Yii::$app->request->method`
という式によって取得することが出来ます。
現在のメソッドが特定のタイプであるかどうかをチェックするための、一
連
の真偽値のプロパティも提供されています。
現在のメソッドが特定のタイプであるかどうかをチェックするための、一
揃い
の真偽値のプロパティも提供されています。
例えば、
例えば、
```
php
```
php
...
@@ -80,8 +80,8 @@ if ($request->isPut) { // リクエストメソッドは PUT }
...
@@ -80,8 +80,8 @@ if ($request->isPut) { // リクエストメソッドは PUT }
*
[
[yii\web\Request::absoluteUrl|absoluteUrl
]
]:
`http://example.com/admin/index.php/product?id=100`
を返します。
*
[
[yii\web\Request::absoluteUrl|absoluteUrl
]
]:
`http://example.com/admin/index.php/product?id=100`
を返します。
ホスト情報の部分を含んだ URL です。
ホスト情報の部分を含んだ URL です。
*
[
[yii\web\Request::hostInfo|hostInfo
]
]:
`http://example.com`
を返します。URL のホスト情報の部分です。
*
[
[yii\web\Request::hostInfo|hostInfo
]
]:
`http://example.com`
を返します。URL のホスト情報の部分です。
*
[
[yii\web\Request::pathInfo|pathInfo
]
]:
`/product`
を返します。エントリスクリプトの後、
かつ、クエスチョンマーク
(クエリ文字列) の前の部分です。
*
[
[yii\web\Request::pathInfo|pathInfo
]
]:
`/product`
を返します。エントリスクリプトの後、
疑問符
(クエリ文字列) の前の部分です。
*
[
[yii\web\Request::queryString|queryString
]
]:
`id=100`
を返します。
クエスチョンマーク
の後の部分です。
*
[
[yii\web\Request::queryString|queryString
]
]:
`id=100`
を返します。
疑問符
の後の部分です。
*
[
[yii\web\Request::baseUrl|baseUrl
]
]:
`/admin`
を返します。ホスト情報の後、かつ、エントリスクリプトの前の部分です。
*
[
[yii\web\Request::baseUrl|baseUrl
]
]:
`/admin`
を返します。ホスト情報の後、かつ、エントリスクリプトの前の部分です。
*
[
[yii\web\Request::scriptUrl|scriptUrl
]
]:
`/admin/index.php`
を返します。パス情報とクエリ文字列を省略した URL です。
*
[
[yii\web\Request::scriptUrl|scriptUrl
]
]:
`/admin/index.php`
を返します。パス情報とクエリ文字列を省略した URL です。
*
[
[yii\web\Request::serverName|serverName
]
]:
`example.com`
を返します。URL の中のホスト名です。
*
[
[yii\web\Request::serverName|serverName
]
]:
`example.com`
を返します。URL の中のホスト名です。
...
@@ -90,7 +90,7 @@ if ($request->isPut) { // リクエストメソッドは PUT }
...
@@ -90,7 +90,7 @@ if ($request->isPut) { // リクエストメソッドは PUT }
## HTTP ヘッダ <span id="http-headers"></span>
## HTTP ヘッダ <span id="http-headers"></span>
[
[yii\web\Request::headers
]
] プロパティによって返される
[
[yii\web\HeaderCollection|header コレクション
]
] を通じて、HTTP ヘッダ情報を取得することが出来ます。例えば、
[
[yii\web\Request::headers
]
] プロパティによって返される
[
[yii\web\HeaderCollection|header コレクション
]
] を通じて、HTTP ヘッダ情報を取得することが出来ます。例えば、
```
php
```
php
// $headers は yii\web\HeaderCollection のオブジェクト
// $headers は yii\web\HeaderCollection のオブジェクト
...
...
docs/guide-ja/runtime-responses.md
View file @
84976bd7
...
@@ -5,8 +5,7 @@
...
@@ -5,8 +5,7 @@
レスポンスオブジェクトは、HTTP ステータスコード、HTTP ヘッダ、HTTP ボディなどの情報を含みます。
レスポンスオブジェクトは、HTTP ステータスコード、HTTP ヘッダ、HTTP ボディなどの情報を含みます。
ウェブアプリケーション開発の最終的な目的は、本質的には、さまざまなリクエストに対してそのようなレスポンスオブジェクトを作成することにあります。
ウェブアプリケーション開発の最終的な目的は、本質的には、さまざまなリクエストに対してそのようなレスポンスオブジェクトを作成することにあります。
ほとんどの場合は、主として
`response`
[
アプリケーションコンポーネント
](
structure-application-components.md
)
を使用すべきです。
ほとんどの場合は、主として、デフォルトでは
[
[yii\web\Response
]
] のインスタンスである
`response`
[
アプリケーションコンポーネント
](
structure-application-components.md
)
を使用すべきです。
このコンポーネントは、デフォルトでは、
[
[yii\web\Response
]
] のインスタンスです。
しかしながら、Yii は、以下で説明するように、あなた自身のレスポンスオブジェクトを作成してエンドユーザに送信することも許容しています。
しかしながら、Yii は、以下で説明するように、あなた自身のレスポンスオブジェクトを作成してエンドユーザに送信することも許容しています。
この節では、レスポンスを構成してエンドユーザに送信する方法を説明します。
この節では、レスポンスを構成してエンドユーザに送信する方法を説明します。
...
@@ -22,7 +21,7 @@
...
@@ -22,7 +21,7 @@
Yii
::
$app
->
response
->
statusCode
=
200
;
Yii
::
$app
->
response
->
statusCode
=
200
;
```
```
けれども
、たいていの場合、ステータスコードを明示的に設定する必要はありません。
ただし
、たいていの場合、ステータスコードを明示的に設定する必要はありません。
これは、
[
[yii\web\Response::statusCode
]
] のデフォルト値が 200 であるからです。
これは、
[
[yii\web\Response::statusCode
]
] のデフォルト値が 200 であるからです。
そして、リクエストが失敗したことを示したいときは、下記のように、適切な HTTP 例外を投げることが出来ます。
そして、リクエストが失敗したことを示したいときは、下記のように、適切な HTTP 例外を投げることが出来ます。
...
@@ -100,7 +99,7 @@ $response->data = ['message' => 'hello world'];
...
@@ -100,7 +99,7 @@ $response->data = ['message' => 'hello world'];
Yii は下記の形式を初めからサポートしています。
Yii は下記の形式を初めからサポートしています。
それぞれ、
[
[yii\web\ResponseFormatterInterface|フォーマッタ
]
] クラスとして実装されています。
それぞれ、
[
[yii\web\ResponseFormatterInterface|フォーマッタ
]
] クラスとして実装されています。
[
[yii\web\Response::formatters
]
] プロパティを構成することで、これらのフォーマッタをカスタマイズしたり、
または、新しいフォーマッタを追加
することが出来ます。
[
[yii\web\Response::formatters
]
] プロパティを構成することで、これらのフォーマッタをカスタマイズしたり、
新しいフォーマッタを追加したり
することが出来ます。
*
[
[yii\web\Response::FORMAT_HTML|HTML
]
]:
[
[yii\web\HtmlResponseFormatter
]
] によって実装
*
[
[yii\web\Response::FORMAT_HTML|HTML
]
]:
[
[yii\web\HtmlResponseFormatter
]
] によって実装
*
[
[yii\web\Response::FORMAT_XML|XML
]
]:
[
[yii\web\XmlResponseFormatter
]
] によって実装
*
[
[yii\web\Response::FORMAT_XML|XML
]
]:
[
[yii\web\XmlResponseFormatter
]
] によって実装
...
@@ -177,7 +176,7 @@ public function actionOld()
...
@@ -177,7 +176,7 @@ public function actionOld()
上記のコードでは、アクションメソッドが
`redirect()`
メソッドの結果を返しています。
上記のコードでは、アクションメソッドが
`redirect()`
メソッドの結果を返しています。
前に説明したように、アクションメソッドによって返されるレスポンスオブジェクトが、エンドユーザに送信されるレスポンスとして使用されることになります。
前に説明したように、アクションメソッドによって返されるレスポンスオブジェクトが、エンドユーザに送信されるレスポンスとして使用されることになります。
アクションメソッド以外の場所では、
[
[yii\web\Response::redirect()
]
] を直接に呼び出し、メソッドチェーンで
[
[yii\web\Response::send()
]
] メソッドを呼んで、レスポンスに余計なコンテントが追加されないことを保証
すべきです
。
アクションメソッド以外の場所では、
[
[yii\web\Response::redirect()
]
] を直接に呼び出し、メソッドチェーンで
[
[yii\web\Response::send()
]
] メソッドを呼んで、レスポンスに余計なコンテントが追加されないことを保証
しなければなりません
。
```
php
```
php
\Yii
::
$app
->
response
->
redirect
(
'http://example.com/new'
,
301
)
->
send
();
\Yii
::
$app
->
response
->
redirect
(
'http://example.com/new'
,
301
)
->
send
();
...
@@ -191,7 +190,7 @@ public function actionOld()
...
@@ -191,7 +190,7 @@ public function actionOld()
この問題を解決するために、
[
[yii\web\Response::redirect()
]
] メソッドは
`X-Redirect`
ヘッダにリダイレクト先 URL を値としてセットします。
この問題を解決するために、
[
[yii\web\Response::redirect()
]
] メソッドは
`X-Redirect`
ヘッダにリダイレクト先 URL を値としてセットします。
そして、クライアントサイドで、このヘッダの値を読み、それに応じてブラウザをリダイレクトする JavaScript を書くことが出来ます。
そして、クライアントサイドで、このヘッダの値を読み、それに応じてブラウザをリダイレクトする JavaScript を書くことが出来ます。
> Info|情報: Yii には `yii.js` という JavaScript ファイルが付
い
ています。
> Info|情報: Yii には `yii.js` という JavaScript ファイルが付
属し
ています。
これは、よく使われる一連の JavaScript 機能を提供するもので、その中には
`X-Redirect`
ヘッダに基づくブラウザのリダイレクトも含まれています。
これは、よく使われる一連の JavaScript 機能を提供するもので、その中には
`X-Redirect`
ヘッダに基づくブラウザのリダイレクトも含まれています。
従って、あなたが (
[
[yii\web\YiiAsset
]
] アセットバンドルを登録して) この JavaScript ファイルを使うつもりなら、AJAX のリダイレクトをサポートするためには、何も書く必要がなくなります。
従って、あなたが (
[
[yii\web\YiiAsset
]
] アセットバンドルを登録して) この JavaScript ファイルを使うつもりなら、AJAX のリダイレクトをサポートするためには、何も書く必要がなくなります。
...
@@ -216,7 +215,7 @@ public function actionDownload()
...
@@ -216,7 +215,7 @@ public function actionDownload()
}
}
```
```
ファイル送信メソッドをアクションメソッド以外の場所で呼ぶ場合は、その後で
[
[yii\web\Response::send()
]
] メソッドも呼んで、レスポンスに余計なコンテントが追加されないことを保証
すべきです
。
ファイル送信メソッドをアクションメソッド以外の場所で呼ぶ場合は、その後で
[
[yii\web\Response::send()
]
] メソッドも呼んで、レスポンスに余計なコンテントが追加されないことを保証
しなければなりません
。
```
php
```
php
\Yii
::
$app
->
response
->
sendFile
(
'path/to/file.txt'
)
->
send
();
\Yii
::
$app
->
response
->
sendFile
(
'path/to/file.txt'
)
->
send
();
...
@@ -254,5 +253,5 @@ public function actionDownload()
...
@@ -254,5 +253,5 @@ public function actionDownload()
[
[yii\web\Response::send()
]
] メソッドが一度呼び出された後では、このメソッドに対する更なる呼び出しは無視されます。
[
[yii\web\Response::send()
]
] メソッドが一度呼び出された後では、このメソッドに対する更なる呼び出しは無視されます。
このことは、いったんレスポンスが送出された後では、それにコンテントを追加することは出来なくなる、ということを意味します。
このことは、いったんレスポンスが送出された後では、それにコンテントを追加することは出来なくなる、ということを意味します。
ごらんのように、
the
[
[yii\web\Response::send()
]
] メソッドはいくつかの有用なイベントをトリガします。
ごらんのように、
[
[yii\web\Response::send()
]
] メソッドはいくつかの有用なイベントをトリガします。
これらのイベントに反応することによって、レスポンスを調整したり修飾したりすることが出来ます。
これらのイベントに反応することによって、レスポンスを調整したり修飾したりすることが出来ます。
docs/guide-ja/runtime-routing.md
View file @
84976bd7
...
@@ -6,12 +6,11 @@ Yii 縺ョ繧「繝励Μ繧ア繝シ繧キ繝ァ繝ウ縺後Μ繧ッ繧ィ繧ケ繝医&繧後◆ URL 縺ョ蜃ヲ逅r髢句ァ
...
@@ -6,12 +6,11 @@ Yii 縺ョ繧「繝励Μ繧ア繝シ繧キ繝ァ繝ウ縺後Μ繧ッ繧ィ繧ケ繝医&繧後◆ URL 縺ョ蜃ヲ逅r髢句ァ
このプロセスの全体が
*ルーティング*
と呼ばれます。
このプロセスの全体が
*ルーティング*
と呼ばれます。
ルーティングの逆のプロセスが
*URL 生成*
と呼ばれます。
ルーティングの逆のプロセスが
*URL 生成*
と呼ばれます。
これは、与えられたルートとそれに結び付いたクエリパラメータか
らURL を生成するものです。
これは、与えられたルートとそれに結び付けられたクエリパラメー
タから URL を生成するものです。
生成された URL が後でリクエストされたとき、ルーティングのプロセ
スは、その URL を解決して、元のルートとクエリパラメータに戻すことが出来ます。
生成された URL が後でリクエストされたときには、ルーティングのプ
ロセスがその URL を解決して元のルートとクエリパラメータに戻すことが出来ます。
ルーティングと URL 生成について責任を持つ主要コンポーネントが
[
[yii\web\UrlManager|URL マネージャ
]
] であり、
`urlManager`
アプリケーションコンポーネントとして登録されているものです。
ルーティングと URL 生成について主たる役割を果たすのが
`urlManager`
アプリケーションコンポーネントとして登録されている
[
[yii\web\UrlManager|URL マネージャ
]
] です。
[
[yii\web\UrlManager|URL マネージャ
]
] は、入ってくるリクエストをルートとそれに結び付いたクエリパラメータとして解析するための
[
[yii\web\UrlManager::parseRequest()|parseRequest()
]
] メソッドと、
[
[yii\web\UrlManager|URL マネージャ
]
] は、入ってくるリクエストをルートとそれに結び付けられたクエリパラメータとして解析するための
[
[yii\web\UrlManager::parseRequest()|parseRequest()
]
] メソッドと、与えられたルートとそれに結び付けられたクエリパラメータから URL を生成するための
[
[yii\web\UrlManager::createUrl()|createUrl()
]
] メソッドを提供します。
与えられたルートとそれに結び付いたクエリパラメータから URL を生成するための
[
[yii\web\UrlManager::createUrl()|createUrl()
]
] メソッドを提供するものです。
アプリケーション構成情報の
`urlManager`
コンポーネントを構成することによって、既存のアプリケーションコードを修正することなく、任意の URL 形式をアプリケーションに認識させることが出来ます。
アプリケーション構成情報の
`urlManager`
コンポーネントを構成することによって、既存のアプリケーションコードを修正することなく、任意の URL 形式をアプリケーションに認識させることが出来ます。
例えば、
`post/view`
アクションのための URL を生成するためには、次のコードを使うことが出来ます。
例えば、
`post/view`
アクションのための URL を生成するためには、次のコードを使うことが出来ます。
...
@@ -23,8 +22,8 @@ use yii\helpers\Url;
...
@@ -23,8 +22,8 @@ use yii\helpers\Url;
$url
=
Url
::
to
([
'post/view'
,
'id'
=>
100
]);
$url
=
Url
::
to
([
'post/view'
,
'id'
=>
100
]);
```
```
このコードによって生成される URL は、
`urlManager`
の構成に応じて、下記の形式のうちの一つ (または
その他の形式) になります。
このコードによって生成される URL は、
`urlManager`
の構成に応じて、下記のどれか (またはその他)
になります。
そしてまた
、生成された URL が後でリクエストされたときには、解析されて元のルートとクエリパラメータに戻されます。
そして、こ
うして生成された URL が後でリクエストされた場合には、解析されて元のルートとクエリパラメータの値に戻されます。
```
```
/index.php?r=post/view&id=100
/index.php?r=post/view&id=100
...
@@ -37,21 +36,20 @@ $url = Url::to(['post/view', 'id' => 100]);
...
@@ -37,21 +36,20 @@ $url = Url::to(['post/view', 'id' => 100]);
[
[yii\web\UrlManager|URL マネージャ
]
] は二つの URL 形式、すなわち、デフォルトの URL 形式と、綺麗な URL 形式をサポートします。
[
[yii\web\UrlManager|URL マネージャ
]
] は二つの URL 形式、すなわち、デフォルトの URL 形式と、綺麗な URL 形式をサポートします。
デフォルトの URL 形式は、
`r`
というクエリパラメータを使用してルートを表し、通常のクエリパラメータを使用してルートに結び付いたクエリパラメータを表します。
デフォルトの URL 形式は、
`r`
というクエリパラメータを使用してルートを表し、通常のクエリパラメータを使用してルートに結び付けられたクエリパラメータを表します。
例えば、
`/index.php?r=post/view&id=100`
という URL は、
`post/view`
というルートと、
`id`
というクエリパラメータが 100 であることを表します。
例えば、
`/index.php?r=post/view&id=100`
という URL は、
`post/view`
というルートと、
`id`
というクエリパラメータが 100 であることを表します。
デフォルトの URL 形式は、
[
[yii\web\UrlManager|URL マネージャ
]
] についての構成を何も必要とせず、ウェブサーバの設定がどのようなものでも動作します。
デフォルトの URL 形式は、
[
[yii\web\UrlManager|URL マネージャ
]
] についての構成を何も必要とせず、ウェブサーバの設定がどのようなものでも動作します。
綺麗な URL 形式は、エントリスクリプトの名前に続く追加のパスを使用して、ルートとそれに結び付いたクエリパラメータを表します。
綺麗な URL 形式は、エントリスクリプトの名前に続く追加のパスを使用して、ルートとそれに結び付けられたクエリパラメータを表します。
例えば、
`/index.php/post/100`
という URL の追加のパスは
`/post/100`
ですが、適切な
[
[yii\web\UrlManager::rules|URL 規則
]
] があれば、この URL が
`post/view`
というルートと
`id`
というクエリパラメータが 100 であることを表すことが出来ます。
例えば、
`/index.php/post/100`
という URL の追加のパスは
`/post/100`
ですが、適切な
[
[yii\web\UrlManager::rules|URL 規則
]
] があれば、この URL が
`post/view`
というルートと
`id`
というクエリパラメータが 100 であることを表すことが出来ます。
綺麗な URL 形式を使用するためには、URL をどのように表現すべきかという実際の要求に従って、一連の
[
[yii\web\UrlManager::rules|URL 規則
]
] を設計する必要があります。
綺麗な URL 形式を使用するためには、URL をどのように表現すべきかという実際の要求に従って、一連の
[
[yii\web\UrlManager::rules|URL 規則
]
] を設計する必要があります。
この二つの URL 形式は、
[
[yii\web\UrlManager|URL マネージャ
]
] の
[
[yii\web\UrlManager::enablePrettyUrl|enablePrettyUrl
]
]
この二つの URL 形式は、
[
[yii\web\UrlManager|URL マネージャ
]
] の
[
[yii\web\UrlManager::enablePrettyUrl|enablePrettyUrl
]
] プロパティを ON/OFF することによって、他のアプリケーションコードを少しも変えることなく、切り替えることが出来ます。
プロパティを ON/OFF することによって、他のアプリケーションコードを少しも変えることなく、切り替えることが出来ます。
## ルーティング <span id="routing"></span>
## ルーティング <span id="routing"></span>
ルーティングは二つのステップを含みます。最初のステップでは、入ってくるリクエストが解析されて、ルートとそれに結び付いたクエリパラメータに分解されます。
ルーティングは二つのステップを含みます。最初のステップでは、入ってくるリクエストが解析されて、ルートとそれに結び付けられたクエリパラメータに分解されます。
そして、第二のステップでは、解析されたルートに対応する
[
コントローラアクション
](
structure-controllers.md
)
がリクエストを処理するために生成されます。
そして、第二のステップでは、解析されたルートに対応する
[
コントローラアクション
](
structure-controllers.md
)
がリクエストを処理するために生成されます。
デフォルトの URL 形式を使っている場合は、リクエストからルートを解析することは、
`r`
という名前の
`GET`
クエリパラメータを取得するだけの簡単なことです。
デフォルトの URL 形式を使っている場合は、リクエストからルートを解析することは、
`r`
という名前の
`GET`
クエリパラメータを取得するだけの簡単なことです。
...
@@ -62,21 +60,21 @@ $url = Url::to(['post/view', 'id' => 100]);
...
@@ -62,21 +60,21 @@ $url = Url::to(['post/view', 'id' => 100]);
いったんリクエストからルートが解析されたら、今度はルートによって特定されるコントローラアクションを生成する番です。
いったんリクエストからルートが解析されたら、今度はルートによって特定されるコントローラアクションを生成する番です。
ルートはその中にあるスラッシュによって複数の部分に分けられます。例えば、
`site/index`
は
`site`
と
`index`
に分割されます。
ルートはその中にあるスラッシュによって複数の部分に分けられます。例えば、
`site/index`
は
`site`
と
`index`
に分割されます。
その各部分
がモジュール、コントローラ、アクションを参照する ID となります。
その各部分
は、モジュール、コントローラ、または、アクションを参照する ID です。
アプリケーションは、ルートの中の最初の部分から始
めて、下記のステップを踏んで
、モジュール (もし有れば)、コントローラ、アクションを生成します。
アプリケーションは、ルートの最初の部分の ID
から始めて、下記のステップを
踏んで、モジュール (もし有れば)、コントローラ、アクションを生成します。
1.
アプリケーションをカレントモジュールとして設定します。
1.
アプリケーションをカレントモジュールとして設定します。
2.
カレントモジュールの
[
[yii\base\Module::controllerMap|コントローラマップ
]
] がカレント ID を含むかどうか
を調べます。
2.
カレントモジュールの
[
[yii\base\Module::controllerMap|コントローラマップ
]
] が現在の ID を含むかどうかを
調べます。
もしそうであれば、マップの中で見つかったコントローラのオブジェクトが構成情報に従って生成されます。
含んでいる場合は、マップの中で見つかった構成情報に従ってコントローラのオブジェクトが生成されます。
そして、ルート
の残りの部分を処理するために、ステップ 5 に飛びます。
そして、ステッ
プ 5 に跳んで、ルートの残りの部分を処理します。
3.
ID がカレントモジュールの
[
[yii\base\Module::modules|modules
]
] プロパティのリストに挙げられたモジュールを指すかどうかを調べます。
3.
現在の ID がカレントモジュールの
[
[yii\base\Module::modules|modules
]
] プロパティのリストに挙げられたモジュールを指すものかどうかを調べます。
もしそうであれば、モジュールのリストで見つかったモジュールが構成情報に従って生成
されます。
もしそうであれば、モジュールのリストで見つかった構成情報に従ってモジュールが生成
されます。
そして、ステ
ップ 2 に戻って、新しく生成されたモジュールのコンテキストのもとで、ルートの次の部分を処理します。
そして、新し
く生成されたモジュールのコンテキストのもとで、ステップ 2 に戻って、ルートの次の部分を処理します。
4.
ID をコントローラ ID として扱ってコントローラオブジェクトを生成します。
4.
現在の ID
をコントローラ ID として扱ってコントローラオブジェクトを生成します。
そしてルートの残りの部分を持って次のステップに進みます。
そしてルートの残りの部分を持って次のステップに進みます。
5.
コントローラは、
[
[yii\base\Controller::actions()|アクションマップ
]
] の中にカレント ID があるかどうか
を調べます。
5.
コントローラは、
[
[yii\base\Controller::actions()|アクションマップ
]
] の中に現在の ID があるかどうかを
調べます。
もし有れば、マップの中で見つかったアクションを構
成情報に従って生成します。
もし有れば、マップの中で見つかった構成情報に従っ
てアクションを生成します。
もし無ければ、カレント
ID に対応するアクションメソッドによって定義されるインラインアクションを生成しよ
うと試みます。
もし無ければ、現在の
ID に対応するアクションメソッドで定義されるインラインアクションを生成
しようと試みます。
上記のステップの中で、何かエラーが発生すると、
[
[yii\web\NotFoundHttpException
]
] が投げられて、ルーティングのプロセスが失敗したことが示されます。
上記のステップの中で、何かエラーが発生すると、
[
[yii\web\NotFoundHttpException
]
] が投げられて、ルーティングのプロセスが失敗したことが示されます。
...
@@ -109,14 +107,12 @@ $url = Url::to(['post/view', 'id' => 100]);
...
@@ -109,14 +107,12 @@ $url = Url::to(['post/view', 'id' => 100]);
上記の構成によって、入ってくる全てのリクエストを処理するために
`site/offline`
アクションが使われるようになります。
上記の構成によって、入ってくる全てのリクエストを処理するために
`site/offline`
アクションが使われるようになります。
`catchAll`
プロパティは配列を取り、最初の要素はルートを指定し、残りの要素 (「名前-値」のペア) は
`catchAll`
プロパティは配列を取り、最初の要素はルートを指定し、残りの要素 (「名前-値」のペア) は
[
アクションのパラメータ
](
structure-controllers.md#action-parameters
)
を指定するものでなければなりません。
[
アクションのパラメータ
](
structure-controllers.md#action-parameters
)
を指定するものでなければなりません。
## URL を生成する <span id="creating-urls"></span>
## URL を生成する <span id="creating-urls"></span>
Yii は、与えられたルートとそれに結び付けられるクエリパラメータからさまざまな URL を生成する
Yii は、与えられたルートとそれに結び付けられたクエリパラメータからさまざまな URL を生成する
[
[yii\helpers\Url::to()
]
] というヘルパメソッドを提供しています。例えば、
[
[yii\helpers\Url::to()
]
] というヘルパメソッドを提供しています。例えば、
```
php
```
php
use
yii\helpers\Url
;
use
yii\helpers\Url
;
...
@@ -171,9 +167,7 @@ echo Url::to(['/post/index']);
...
@@ -171,9 +167,7 @@ echo Url::to(['/post/index']);
echo
Url
::
to
([
'@posts'
]);
echo
Url
::
to
([
'@posts'
]);
```
```
[
[yii\helpers\Url::to()
]
] メソッドは、
[
[yii\web\UrlManager|URL マネージャ
]
] の
[
[yii\helpers\Url::to()
]
] メソッドは、
[
[yii\web\UrlManager|URL マネージャ
]
] の
[
[yii\web\UrlManager::createUrl()|createUrl()
]
] メソッド、および、
[
[yii\web\UrlManager::createAbsoluteUrl()|createAbsoluteUrl()
]
] を呼び出すことによって実装されています。
[
[yii\web\UrlManager::createUrl()|createUrl()
]
] メソッド、および、
[
[yii\web\UrlManager::createAbsoluteUrl()|createAbsoluteUrl()
]
]
を呼び出すことによって実装されています。
次に続くいくつかの項では、
[
[yii\web\UrlManager|URL マネージャ
]
] を構成して、生成される URL の形式をカスタマイズする方法を説明します。
次に続くいくつかの項では、
[
[yii\web\UrlManager|URL マネージャ
]
] を構成して、生成される URL の形式をカスタマイズする方法を説明します。
[
[yii\helpers\Url::to()
]
] メソッドは、特定のルートとの関係を持たない URL の生成もサポートしています。
[
[yii\helpers\Url::to()
]
] メソッドは、特定のルートとの関係を持たない URL の生成もサポートしています。
...
@@ -238,11 +232,11 @@ echo Url::previous();
...
@@ -238,11 +232,11 @@ echo Url::previous();
その他のプロパティはオプションですが、上記で示されている構成が最もよく用いられているものです。
その他のプロパティはオプションですが、上記で示されている構成が最もよく用いられているものです。
* [[yii\web\UrlManager::showScriptName|showScriptName]]: このプロパティは、生成される URL にエントリスクリプトを含めるべきかどうかを決定します。
* [[yii\web\UrlManager::showScriptName|showScriptName]]: このプロパティは、生成される URL にエントリスクリプトを含めるべきかどうかを決定します。
例えば、このプロパティを false にすると、`
/index.php/post/100
` という URL を生成する代りに、`
/post/100
` という URL を生成することが出来ます。
例えば、このプロパティを false にすると、`
/index.php/post/100
` という URL を生成する代りに、`
/post/100
` という URL を生成することが出来ます。
* [[yii\web\UrlManager::enableStrictParsing|enableStrictParsing]]: このプロパティは、厳密なリクエスト解析を有効にするかどうかを決定します。
* [[yii\web\UrlManager::enableStrictParsing|enableStrictParsing]]: このプロパティは、厳密なリクエスト解析を有効にするかどうかを決定します。
厳密な解析が有効にされた場合、リクエストされた URL が有効なリクエストとして扱われるためには、それが [[yii\web\UrlManager::rules|rules]] の少なくとも一つに合致しなければなりません。
厳密な解析が有効にされた場合、リクエストされた URL が有効なリクエストとして扱われるためには、それが [[yii\web\UrlManager::rules|rules]] の少なくとも一つに合致しなければなりません。
そうでなければ、[[yii\web\NotFoundHttpException]] が投げられます。
そうでなければ、[[yii\web\NotFoundHttpException]] が投げられます。
厳密な解析が無効にされると、リクエス
トされ
た URL が [[yii\web\UrlManager::rules|rules]] のどれにも合致しない場合は、URL のパス情報の部分がリクエストされたルートとして扱われます。
厳密な解析が無効にされた場合は、リク
エストされ
た URL が [[yii\web\UrlManager::rules|rules]] のどれにも合致しない場合は、URL のパス情報の部分がリクエストされたルートとして扱われます。
* [[yii\web\UrlManager::rules|rules]]: このプロパティが URL を解析および生成するための一連の規則を含みます。
* [[yii\web\UrlManager::rules|rules]]: このプロパティが URL を解析および生成するための一連の規則を含みます。
このプロパティが、アプリケーションの固有の要求を満たす形式を持つ URL を生成するために、あなたが主として使うプロパティです。
このプロパティが、アプリケーションの固有の要求を満たす形式を持つ URL を生成するために、あなたが主として使うプロパティです。
...
@@ -257,10 +251,9 @@ URL 隕丞援縺ッ [[yii\web\UrlRule]] 縺セ縺溘縺昴蟄舌け繝ゥ繧ケ縺ョ繧、繝ウ繧ケ繧ソ繝ウ
...
@@ -257,10 +251,9 @@ URL 隕丞援縺ッ [[yii\web\UrlRule]] 縺セ縺溘縺昴蟄舌け繝ゥ繧ケ縺ョ繧、繝ウ繧ケ繧ソ繝ウ
URL 規則は、パターンがリクエストされた URL と合致する場合に、リクエストの解析に使用することが出来ます。
URL 規則は、パターンがリクエストされた URL と合致する場合に、リクエストの解析に使用することが出来ます。
また、URL 規則は、ルートとクエリパラメータ名が与えられたものと合致する場合に、URL の生成に使用することが出来ます。
また、URL 規則は、ルートとクエリパラメータ名が与えられたものと合致する場合に、URL の生成に使用することが出来ます。
綺麗な URL 形式が有効にされている場合、[[yii\web\UrlManager|URL マネージャ]] は、その [[yii\web\UrlManager::rules|rules]]
綺麗な URL 形式が有効にされている場合、[[yii\web\UrlManager|URL マネージャ]] は、その [[yii\web\UrlManager::rules|rules]] プロパティに宣言されている URL 規則を使って、入ってくるリクエストの解析と URL の生成を行います。
プロパティに宣言されている URL 規則を使って、入ってくるリクエストの解析と URL の生成を行います。
具体的に言えば、入ってくるリクエストを解析するためには、[[yii\web\UrlManager|URL マネージャ]] は宣言されている順に規則を調べて、リクエストされた URL に合致する *最初の* 規則を探します。
具体的に言えば、入ってくるリクエストを解析するためには、[[yii\web\UrlManager|URL マネージャ]] は宣言されている順に規則を調べて、リクエストされた URL に合致する *最初の* 規則を探します。
そして、その合致する規則を使って URL を解析して、ルートとそれと結合されたパラメータを得ます。
そして、その合致する規則を使って URL を解析して、ルートとそれに結び付けられたパラメータを得ます。
同じように、URL を生成するためには、[[yii\web\UrlManager|URL マネージャ]] は、与えられたルートとパラメータに合致する最初の規則を探して、それを使って URL を生成します。
同じように、URL を生成するためには、[[yii\web\UrlManager|URL マネージャ]] は、与えられたルートとパラメータに合致する最初の規則を探して、それを使って URL を生成します。
[[yii\web\UrlManager::rules]] は、パターンをキーとし、それに対応するルートを値とする配列として構成することが出来ます。
[[yii\web\UrlManager::rules]] は、パターンをキーとし、それに対応するルートを値とする配列として構成することが出来ます。
...
@@ -280,7 +273,7 @@ URL 隕丞援縺ッ縲√ヱ繧ソ繝シ繝ウ縺後Μ繧ッ繧ィ繧ケ繝医&繧後◆ URL 縺ィ蜷郁縺吶k蝣エ蜷
...
@@ -280,7 +273,7 @@ URL 隕丞援縺ッ縲√ヱ繧ソ繝シ繝ウ縺後Μ繧ッ繧ィ繧ケ繝医&繧後◆ URL 縺ィ蜷郁縺吶k蝣エ蜷
例えば、`
/index.php/post/100?source=ad
` のパス情報は `
post/100
` であり (先頭と末尾のスラッシュは無視します)、これは `
post/(
\d
+)
` というパターンに合致します。
例えば、`
/index.php/post/100?source=ad
` のパス情報は `
post/100
` であり (先頭と末尾のスラッシュは無視します)、これは `
post/(
\d
+)
` というパターンに合致します。
URL 規則は、「パターン - ルート」のペアとして宣言する以外に、構成情報配列として宣言することも出来ます。
URL 規則は、「パターン - ルート」のペアとして宣言する以外に、構成情報配列として宣言することも出来ます。
すべての構成情報配列が
、それぞれ、一つの URL 規則のオブジェクトを構成するために使われます。
構成情報の一つの配列が
、それぞれ、一つの URL 規則のオブジェクトを構成するために使われます。
この形式は、URL 規則の他のプロパティを構成したい場合に、よく必要になります。
この形式は、URL 規則の他のプロパティを構成したい場合に、よく必要になります。
例えば、
例えば、
...
@@ -296,7 +289,7 @@ URL 隕丞援縺ッ縲√後ヱ繧ソ繝シ繝ウ - 繝ォ繝シ繝医阪繝壹い縺ィ縺励※螳」險縺吶k莉・
...
@@ -296,7 +289,7 @@ URL 隕丞援縺ッ縲√後ヱ繧ソ繝シ繝ウ - 繝ォ繝シ繝医阪繝壹い縺ィ縺励※螳」險縺吶k莉・
]
]
```
```
規則の構成情報で `
class
` を指定しない場合は、デフォルトとして、[[yii\web\UrlRule]] が使われます。
URL
規則の構成情報で `
class
` を指定しない場合は、デフォルトとして、[[yii\web\UrlRule]] が使われます。
### 名前付きパラメータ <span id="named-parameters"></span>
### 名前付きパラメータ <span id="named-parameters"></span>
...
@@ -305,10 +298,10 @@ URL 隕丞援縺ッ縲√ヱ繧ソ繝シ繝ウ縺ョ荳ュ縺ァ `<ParamName:RgExp>` 縺ョ蠖「蠑上〒謖ョ壹&
...
@@ -305,10 +298,10 @@ URL 隕丞援縺ッ縲√ヱ繧ソ繝シ繝ウ縺ョ荳ュ縺ァ `<ParamName:RgExp>` 縺ョ蠖「蠑上〒謖ョ壹&
ここで、`
ParamName
` はパラメータ名を指定し、`
RegExp
` はパラメータの値との照合に使われるオプションの正規表現を指定するものです。
ここで、`
ParamName
` はパラメータ名を指定し、`
RegExp
` はパラメータの値との照合に使われるオプションの正規表現を指定するものです。
`
RegExp
` が指定されていない場合は、パラメータの値がスラッシュを含まない文字列であるべきことを意味します。
`
RegExp
` が指定されていない場合は、パラメータの値がスラッシュを含まない文字列であるべきことを意味します。
> Note|注意: 正規表現はパラメータに対してのみ指定できます。パターンの残りの部分は平文テキストであると見なされます。
> Note|注意: 正規表現はパラメータに対してのみ指定できます。パターンの残りの部分はプレーンテキストとして解釈されます。
規則が URL の解析に使われるときには、結び付けられたパラ
メータに、URL の対応する部分に合致する値が入れられます。
規則が URL の解析に使われるときには、URL の対応する
部分に合致した値が、結び付けられたパラメータに入れられます。
そして、これら
のパラメ
ータは、後に `
request
` アプリケーションコンポーネントによって、`
$_GET
` に入れられて利用できるようになります。
そして、そのパ
ラ
メータは、後に `
request
` アプリケーションコンポーネントによって、`
$_GET
` に入れられて利用できるようになります。
規則が URL の生成に使われるときは、提供されたパラメータの値を受けて、パラメータが宣言されている所にその値が挿入されます。
規則が URL の生成に使われるときは、提供されたパラメータの値を受けて、パラメータが宣言されている所にその値が挿入されます。
名前付きパラメータの動作を説明するためにいくつかの例を挙げましょう。次の三つの URL 規則を宣言したと仮定してください。
名前付きパラメータの動作を説明するためにいくつかの例を挙げましょう。次の三つの URL 規則を宣言したと仮定してください。
...
@@ -361,11 +354,11 @@ URL 隕丞援縺ョ繝ォ繝シ繝医↓縺ッ繝代Λ繝。繝シ繧ソ蜷阪r蝓九a霎シ繧縺薙→縺悟譚・縺セ
...
@@ -361,11 +354,11 @@ URL 隕丞援縺ョ繝ォ繝シ繝医↓縺ッ繝代Λ繝。繝シ繧ソ蜷阪r蝓九a霎シ繧縺薙→縺悟譚・縺セ
> Info|情報: ルートをパラメータ化することによって、URL 規則の数を大幅に減らすことが可能になり、[[yii\web\UrlManager|URL マネージャ]] のパフォーマンスを目に見えて改善することが出来ます。
> Info|情報: ルートをパラメータ化することによって、URL 規則の数を大幅に減らすことが可能になり、[[yii\web\UrlManager|URL マネージャ]] のパフォーマンスを目に見えて改善することが出来ます。
デフォルトでは、規則の中で宣言されたパラメータは必須となります。
デフォルトでは、規則の中で宣言されたパラメータは必須となります。
リクエストされた URL が特定のパラメータを含まない場合や、URL が特定のパラメータなし
で生成される場合には、規則は適用されません。
リクエストされた URL が特定のパラメータを含まない場合や、特定のパラメータなしで URL
を生成する場合には、規則は適用されません。
パラメータのどれかをオプション扱いにしたい場合は、規則の [[yii\web\UrlRule::defaults|defaults]] プロパティを構成することが出来ます。
パラメータのどれかをオプション扱いにしたい場合は、規則の [[yii\web\UrlRule::defaults|defaults]] プロパティを構成することが出来ます。
このプロパティのリストに挙げられたパラメータはオプション扱いとなり、規定されなかった場合は指定された値を取るよ
うになりま
す。
このプロパティのリストに挙げられたパラメータはオプション扱いとなり、提供されなかった場合は指定された値を取るよ
うになり
ます。
次の規則の宣言においては、`
page
` と `
tag
` のパラメータは両方ともオプション扱いで、規定されなかった場合は、それぞれ、1 と空文字列
を取ります
。
次の規則の宣言においては、`
page
` と `
tag
` のパラメータは両方ともオプション扱いで、提供されなかった場合は、それぞれ、1 と空文字列
を取りま
す。
```php
```php
[
[
...
@@ -438,8 +431,7 @@ URL 隕丞援縺ョ繝代ち繝シ繝ウ縺ォ縺ッ縲√え繧ァ繝悶し繝シ繝仙錐繧貞性繧縺薙→縺悟譚・
...
@@ -438,8 +431,7 @@ URL 隕丞援縺ョ繝代ち繝シ繝ウ縺ォ縺ッ縲√え繧ァ繝悶し繝シ繝仙錐繧貞性繧縺薙→縺悟譚・
]
]
```
```
上記の構成によって、[[yii\web\UrlManager|URL マネージャ]] は、接尾辞として `
.html
` の付いた URL
上記の構成によって、[[yii\web\UrlManager|URL マネージャ]] は、接尾辞として `
.html
` の付いた URL を認識し、また、生成するようになります。
を認識し、また、生成するようになります。
> Tip|ヒント: URL が全てスラッシュで終るようにするためには、URL 接尾辞として `
/
` を設定することが出来ます。
> Tip|ヒント: URL が全てスラッシュで終るようにするためには、URL 接尾辞として `
/
` を設定することが出来ます。
...
...
docs/guide-ja/runtime-sessions-cookies.md
View file @
84976bd7
セッションとクッキー
セッションとクッキー
====================
====================
セッションとクッキーは、データが複数のユーザリクエストを超
えて持続することを可能にします。
セッションとクッキーは、データが複数回のユーザリクエストに
またがって持続することを可能にします。
素の PHP では、それぞれ、グローバル変数
`$_SESSION`
と
`$_COOKIE`
によってアクセスすることが出来ます。
素の PHP では、それぞれ、グローバル変数
`$_SESSION`
と
`$_COOKIE`
によってアクセスすることが出来ます。
Yii はセッションとクッキーをオブジェクトとしてカプセル化し、オブジェクト指向の流儀でアクセスできるようにするとともに、有用な機能強化を追加しています。
Yii はセッションとクッキーをオブジェクトとしてカプセル化し、オブジェクト指向の流儀でアクセスできるようにするとともに、有用な機能強化を追加しています。
...
@@ -42,27 +42,27 @@ $session->destroy();
...
@@ -42,27 +42,27 @@ $session->destroy();
```
php
```
php
$session
=
Yii
::
$app
->
session
;
$session
=
Yii
::
$app
->
session
;
// セッション変数を取得する。次の三つの用法は同義。
// セッション変数を取得する。次の三つの用法は等価。
$language
=
$session
->
get
(
'language'
);
$language
=
$session
->
get
(
'language'
);
$language
=
$session
[
'language'
];
$language
=
$session
[
'language'
];
$language
=
isset
(
$_SESSION
[
'language'
])
?
$_SESSION
[
'language'
]
:
null
;
$language
=
isset
(
$_SESSION
[
'language'
])
?
$_SESSION
[
'language'
]
:
null
;
// セッション変数を設定する。次の三つの用法は同義。
// セッション変数を設定する。次の三つの用法は等価。
$session
->
set
(
'language'
,
'en-US'
);
$session
->
set
(
'language'
,
'en-US'
);
$session
[
'language'
]
=
'en-US'
;
$session
[
'language'
]
=
'en-US'
;
$_SESSION
[
'language'
]
=
'en-US'
;
$_SESSION
[
'language'
]
=
'en-US'
;
// セッション変数を削除する。次の三つの用法は同義。
// セッション変数を削除する。次の三つの用法は等価。
$session
->
remove
(
'language'
);
$session
->
remove
(
'language'
);
unset
(
$session
[
'language'
]);
unset
(
$session
[
'language'
]);
unset
(
$_SESSION
[
'language'
]);
unset
(
$_SESSION
[
'language'
]);
// セッション変数が存在するかどうかをチェックする。次の三つの用法は同義。
// セッション変数が存在するかどうかをチェックする。次の三つの用法は等価。
if
(
$session
->
has
(
'language'
))
...
if
(
$session
->
has
(
'language'
))
...
if
(
isset
(
$session
[
'language'
]))
...
if
(
isset
(
$session
[
'language'
]))
...
if
(
isset
(
$_SESSION
[
'language'
]))
...
if
(
isset
(
$_SESSION
[
'language'
]))
...
// 全てのセッション変数をたどる。次の二つの用法は同義。
// 全てのセッション変数をたどる。次の二つの用法は等価。
foreach
(
$session
as
$name
=>
$value
)
...
foreach
(
$session
as
$name
=>
$value
)
...
foreach
(
$_SESSION
as
$name
=>
$value
)
...
foreach
(
$_SESSION
as
$name
=>
$value
)
...
```
```
...
@@ -116,7 +116,7 @@ $session['captcha.lifetime'] = 3600;
...
@@ -116,7 +116,7 @@ $session['captcha.lifetime'] = 3600;
```
```
パフォーマンスとコードの可読性を高めるためには、最後の回避策を推奨します。
パフォーマンスとコードの可読性を高めるためには、最後の回避策を推奨します。
すなわち、配列を一つのセッション変数として保存する代りに、配列の個々の要素を他の要素と同じキー接頭辞を共有する一つのセッション変数として保存することです。
すなわち、配列を一つのセッション変数として保存する代りに、配列の個々の要素を他の要素と同じキー接頭辞を共有する一個ずつのセッション変数として保存することです。
### カスタムセッションストレージ <span id="custom-session-storage"></span>
### カスタムセッションストレージ <span id="custom-session-storage"></span>
...
@@ -133,7 +133,7 @@ Yii 縺ッ縲√∪縺溘√&縺セ縺悶∪縺ェ繧サ繝す繝ァ繝ウ繧ケ繝医Ξ繝シ繧ク繧貞ョ溯」☆繧倶
...
@@ -133,7 +133,7 @@ Yii 縺ッ縲√∪縺溘√&縺セ縺悶∪縺ェ繧サ繝す繝ァ繝ウ繧ケ繝医Ξ繝シ繧ク繧貞ョ溯」☆繧倶
その結果として、セッションを使用するアプリケーションコードを修正することなしに、セッションストレージクラスを切り替えることが出来ます。
その結果として、セッションを使用するアプリケーションコードを修正することなしに、セッションストレージクラスを切り替えることが出来ます。
> Note|注意: カスタムセッションストレージを使っているときに `$_SESSION` を通じてセッションデータにアクセスしたい場合は、セッションが [[yii\web\Session::open()]] によって既に開始されていることを確認しなければなりません。
> Note|注意: カスタムセッションストレージを使っているときに `$_SESSION` を通じてセッションデータにアクセスしたい場合は、セッションが [[yii\web\Session::open()]] によって既に開始されていることを確認しなければなりません。
これは、カスタムセッションストレージのハンドラが、このメソッドの中で登録される
からです。
これは、カスタムセッションストレージのハンドラは、この
`open()`
メソ
ッドの中で登録されるからです。
これらのコンポーネントクラスの構成方法と使用方法については、それらの API ドキュメントを参照してください。
これらのコンポーネントクラスの構成方法と使用方法については、それらの API ドキュメントを参照してください。
下記の例は、アプリケーションの構成情報において、データベーステーブルをセッションストレージとして使うために
[
[yii\web\DbSession
]
] を構成する方法を示すものです。
下記の例は、アプリケーションの構成情報において、データベーステーブルをセッションストレージとして使うために
[
[yii\web\DbSession
]
] を構成する方法を示すものです。
...
@@ -223,7 +223,7 @@ $alerts = $session->getFlash('alerts');
...
@@ -223,7 +223,7 @@ $alerts = $session->getFlash('alerts');
Yii は個々のクッキーを
[
[yii\web\Cookie
]
] のオブジェクトとして表します。
Yii は個々のクッキーを
[
[yii\web\Cookie
]
] のオブジェクトとして表します。
[
[yii\web\Request
]
] と
[
[yii\web\Response
]
] は、ともに、
`cookies`
という名前のプロパティによって、クッキーのコレクションを保持します。
[
[yii\web\Request
]
] と
[
[yii\web\Response
]
] は、ともに、
`cookies`
という名前のプロパティによって、クッキーのコレクションを保持します。
後者のクッキーコレクションはリクエストの中で送信されたクッキーを表し、一方、後者のクッキ
ーコレクションは、ユーザに送信されることになるクッキーを表します。
後者のクッキーコレクションはリクエストの中で送信されてきたクッキーを表し、一方、後者のク
ッキーコレクションは、これからユーザに送信されるクッキーを表します。
### クッキーを読み出す <span id="reading-cookies"></span>
### クッキーを読み出す <span id="reading-cookies"></span>
...
@@ -288,9 +288,9 @@ unset($cookies['language']);
...
@@ -288,9 +288,9 @@ unset($cookies['language']);
アプリケーションは、サインを見て、クッキーがクライアントサイドで修正されたかどうかを知ることが出来ます。
アプリケーションは、サインを見て、クッキーがクライアントサイドで修正されたかどうかを知ることが出来ます。
もし、修正されていれば、そのクッキーは
`request`
コンポーネントの
[
[yii\web\Request::cookies|クッキーコレクション
]
] からはアクセスすることが出来なくなります。
もし、修正されていれば、そのクッキーは
`request`
コンポーネントの
[
[yii\web\Request::cookies|クッキーコレクション
]
] からはアクセスすることが出来なくなります。
> Note|注意: クッキー検証はクッキーの値
が修正されるのを防止するだけです。
> Note|注意: クッキー検証は値が修正され
たクッキーの読み込みを防止するだけです。
クッキーが検証に失敗した場合でも、
`$_COOKIE`
を通じてそれにアクセスすることは引き続
いて可能です。
検証に失敗した場合でも、
`$_COOKIE`
を通じてそのクッキーにアクセスすることは引
き続いて可能です。
これは、サードパーティのライブラリが、クッキー検証を含まない、ライブラリ自体の方法でクッキーを操
作し得るためです。
これは、サードパーティのライブラリが、クッキー検証を含まない独自の方法でクッキーを操作することが
出来るようにするするためです。
クッキー検証はデフォルトで有効になっています。
クッキー検証はデフォルトで有効になっています。
[
[yii\web\Request::enableCookieValidation
]
] プロパティを false に設定することによって無効にすることが出来ますが、無効にしないことを強く推奨します。
[
[yii\web\Request::enableCookieValidation
]
] プロパティを false に設定することによって無効にすることが出来ますが、無効にしないことを強く推奨します。
...
...
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