リクエストとレスポンスオブジェクト¶

リクエストパラメーター¶

リクエストは、 getParam() メソッドを介して、ルーティングパラメーターを用意しています。

$controllerName = $this->request->getParam('controller');

全てのルーティングパラメーターを配列として取得するためには getAttribute() を使用します。

$parameters = $this->request->getAttribute('params');

すべての ルート要素 は、このインターフェイスを通してアクセスされます。

ルート要素 に加えて 渡された引数 へのアクセスがしばしば必要になります。 これらは両方ともリクエストオブジェクトと同様に利用可能です。

// 渡された引数
$passedArgs = $this->request->getParam('pass');

すべての渡された引数にアクセスする方法が提供されています。この中には CakePHP の内部で使っている 重要で役に立つパラメーターが存在し、また、リクエストパラメーターの中ですべて見つけられます。

• plugin リクエストを処理するプラグインです。プラグインが存在しない場合は null になります。

• controller 現在のリクエストを処理するコントローラーです。

• action 現在のリクエストを処理するアクションです。

• prefix 現在のアクションのプレフィックスです。詳しくは、 プレフィックスルーティング をご覧ください。

クエリー文字列パラメーター¶

Cake\Http\ServerRequest::getQuery($name, $default = null)¶

クエリー文字列パラメーターは、 getQuery() メソッドを使って読み取ることができます。

// URL は /posts/index?page=1&sort=title
$page = $this->request->getQuery('page');

query プロパティーに直接アクセスするか、エラーが発生しない方法で URL クエリー配列を読むために getQuery() メソッドを使用することができます。キーが存在しない場合、 null が返ります。

$foo = $this->request->getQuery('value_that_does_not_exist');
// $foo === null

// デフォルト値も提供できます。
$foo = $this->request->getQuery('does_not_exist', 'default val');

getQueryParams() を使用すると全てのクエリー文字列パラメーターにアクセスできます。

$query = $this->request->getQueryParams();

リクエストのボディーデータ¶

Cake\Http\ServerRequest::getData($name, $default = null)¶

すべての POST データは Cake\Http\ServerRequest::getData() を使ってアクセスされます。 フォームデータが data 接頭辞を含んでいる場合、接頭辞は取り除かれるでしょう。例えば

// name 属性が 'MyModel[title]' の入力は次のようにアクセスします。
$title = $this->request->getData('title');

ドット区切りの名前を使用して、ネストされたデータにアクセスできます。 例えば

$value = $this->request->getData('address.street_name');

存在しない名前の場合は $default の値が返されます。

$foo = $this->request->getData('Value.that.does.not.exist');
// $foo == null

また、異なるリクエストのボディをパースするために ボディパーサミドルウェア を使うこともできます。 これは ServerRequest::getData() でアクセスできるようにするための配列です。

すべてのデータパラメータにアクセスしたい場合は getParsedBody() を使うことができます。

$data = $this->request->getParsedBody();

ファイルのアップロード¶

アップロードしたファイルは、上で説明した Cake\Http\ServerRequest::getData() メソッドを使用して、リクエスト内容のデータからアクセスすることができます。 例えば、name属性が attachment であるinput要素のファイルは、以下のようにアクセスできます。

$attachment = $this->request->getData('attachment');

デフォルトでは、ファイルのアップロードは、リクエストデータの中で、 \Psr\Http\Message\UploadedFileInterface を実装したオブジェクトとして表現されます。 上記の例では、 $attachment がオブジェクトを保持していますが、 現在の実装では、上記の例の $attachment 変数は、 デフォルトでは \LaminasDiactorosUploadedFile のインスタンスとなります。

アップロードしたファイルへのアクセスは非常に簡単です。 ここでは、古い形式のファイルアップロード配列で提供されていたことと同じようにデータを取得する方法を説明します。

$name = $attachment->getClientFilename();
$type = $attachment->getClientMediaType();
$size = $attachment->getSize();
$tmpName = $attachment->getStream()->getMetadata('uri');
$error = $attachment->getError();

アップロードされたファイルを一時的な場所から目的の場所に移動させるのに 手動で一時的なファイルにアクセスする必要はありません。 代わりに moveTo() メソッドを使用することで簡単に行うことができます。

$attachment->moveTo($targetPath);

HTTP環境では、 moveTo() メソッドはファイルが実際にアップロードされたファイルであるかどうかを 自動的に検証し、必要に応じて例外をスローします。 アップロードされたファイルという概念自体がないCLI環境では、 それに関係なくファイルを移動できるので、ファイルアップロードのテストが非常に簡単になります。

ファイルアップロード配列を使用するように戻すには、 設定値 App.uploadedFilesAsObjects を false に設定してください。 例えば、 config/app.php で以下のように設定します。

return [
    // ...
    'App' => [
        // ...
        'uploadedFilesAsObjects' => false,
    ],
    // ...
];

このオプションを無効にすると、ファイルのアップロードはリクエストデータの中で配列として表現されます。 それは、ネストされた入力/名前があっても変わらない正規化された構造を持っています。 これは PHP のスーパーグローバル変数 $_FILES で表現する方法とは異なります。 (詳細は PHPマニュアル を参照してください)。 つまり、 $attachment の値は次のようになります。

[
    'name' => 'attachment.txt',
    'type' => 'text/plain',
    'size' => 123,
    'tmp_name' => '/tmp/hfz6dbn.tmp'
    'error' => 0
]

Cake\Http\ServerRequest::getUploadedFile($path)¶

アップロードされたファイルの特定のパスで返します。 パスは Cake\Http\ServerRequest::getData() メソッドと同じドット構文を使用します。

$attachment = $this->request->getUploadedFile('attachment');

Cake\Http\ServerRequest::getData() と違って、 Cake\Http\ServerRequest::getUploadedFile() は、実際にアップロードされたファイルが指定されたパスに存在する場合にのみデータを返します。 通常であれば、ファイルではないリクエストのbodyデータが指定されたパスに存在する場合、このメソッドは null を返します。

Cake\Http\ServerRequest::getUploadedFiles()¶

アップロードされたすべてのファイルを正規化された配列構造で返します。 上の例では、ファイルの入力名が attachment の場合、構造は次のようになります。

[
      'attachment' => object(Laminas\Diactoros\UploadedFile) {
          // ...
      }
]

Cake\Http\ServerRequest::withUploadedFiles(array $files)¶

このメソッドは、リクエストオブジェクトのアップロードファイルを設定します。 これは \Psr\Http\Message\UploadedFileInterface. を実装したオブジェクトの配列を受け付けます。 これは、既存のアップロードされている可能性のあるすべてのファイルを置き換えます。

$files = [
    'MyModel' => [
        'attachment' => new \Laminas\Diactoros\UploadedFile(
            $streamOrFile,
            $size,
            $errorStatus,
            $clientFilename,
            $clientMediaType
        ),
        'anotherAttachment' => new \Laminas\Diactoros\UploadedFile(
            '/tmp/hfz6dbn.tmp',
            123,
            \UPLOAD_ERR_OK,
            'attachment.txt',
            'text/plain'
        ),
    ],
];

$this->request = $this->request->withUploadedFiles($files);

PUT、PATCH または DELETE データ¶

Cake\Http\ServerRequest::input($callback[, $options])¶

REST サービスを構築しているとき PUT と DELETE リクエストのデータを受付けることが よくあります。 application/x-www-form-urlencoded リクエストボディーのデータは PUT と DELETE リクエストでは自動的に構文解析され $this->data に設定されます。 もし JSON や XML データを受け付けている場合、どうやってリクエストボディーにアクセスすればいいのかに ついては以下の説明を見て下さい。

入力されたデータにアクセスする場合、オプション機能でそれをデコードすることができます。 XML や JSON のリクエストボディーのコンテンツと対話するときに便利です。 デコード機能のための追加のパラメーターは、 input() の引数として渡すことができます。

$jsonData = $this->request->input('json_decode');

環境変数 ($ _SERVER と $ _ENV より)¶

Cake\Http\ServerRequest::env($key, $value = null)¶

ServerRequest::env() は、 env() グローバル関数のラッパーで、グローバルな $_SERVER や $_ENV を変更することなくゲッター/セッターとして動作します。

// ホストの取得
$host = $this->request->env('HTTP_HOST');

// 値を設定。一般的にはテストに役立ちます。
$this->request->env('REQUEST_METHOD', 'POST');

getServerParams() を使用すると、全ての環境変数にアクセスできます。

$env = $this->request->getServerParams();

XML または JSON データ¶

REST を採用しているアプリケーションでは URL エンコードされていない post 形式でデータを交換することがしばしばあります。 input() を使用すると、任意の形式の入力データを読み込むことができます。 デコード関数が提供されることでデシリアライズされたコンテンツを受け取ることができます。

// PUT/POST アクションで投稿されたデータを JSON 形式にエンコードで取得する
$jsonData = $this->request->input('json_decode');

json_decode で「結果を配列として受け取る」パラメーターのように、デシリアライズメソッドの中には 呼び出し時に追加パラメーターが必要なものがあります。同様に、 Xml を DOMDocument オブジェクトに 変換したい場合、 input() は、 追加のパラメーターを渡すことができます。

// PUT/POST アクションで投稿されたデータを XML エンコードで取得する
$data = $this->request->input('Cake\Utility\Xml::build', ['return' => 'domdocument']);

パス情報¶

リクエストオブジェクトはまたアプリケーションのパスについての役立つ情報を提供しています。 base や webroot 属性は URL の生成や、 アプリケーションが サブディレクトリーにいるのかどうかの決定に役立ちます。様々な属性が使用できます。

// 現在のリクエスト URL が /subdir/articles/edit/1?page=1 であると仮定

// /subdir/articles/edit/1?page=1 を保持
$here = $request->getRequestTarget();

// /subdir を保持
$base = $request->getAttribute('base');

// /subdir/ を保持
$base = $request->getAttribute('webroot');

リクエストの状態をチェック¶

Cake\Http\ServerRequest::is($type, $args...)¶

リクエストオブジェクトは、特定のリクエストに一定の条件を検査する簡単な方法を提供します。 is() メソッドを使用することで、多くの一般的な条件を確認するだけでなく、 他のアプリケーション固有の要求基準を検査することができます。

$isPost = $this->request->is('post');

新しい種類の検出器を作成するために Cake\Http\ServerRequest::addDetector() を使用することで利用可能なリクエスト検出器を拡張することができます。4種類の異なる検出器を作成できます。

• 環境変数の比較 - 環境変数の比較、 env() から取得された値と提供された値が 等しいかどうかを比較します。

• パターン値の比較 - パターン値の比較では env() から取得された値と正規表現を比較します。

• オプションベースの比較 - オプションベースの比較では正規表現を作成するためにオプションのリストを使います。 既に定義済みのオプション検出器を追加するための呼び出しはオプションをマージするでしょう。

• コールバック検出器 - コールバック検出器はチェックをハンドリングするために 'callback' タイプを 提供します。コールバックはパラメーターとしてだけリクエストオブジェクトを受け取ります。

Cake\Http\ServerRequest::addDetector($name, $options)¶

いくつかの例:

// environment detector の追加
$this->request->addDetector(
    'post',
    ['env' => 'REQUEST_METHOD', 'value' => 'POST']
);

// pattern value detector の追加
$this->request->addDetector(
    'iphone',
    ['env' => 'HTTP_USER_AGENT', 'pattern' => '/iPhone/i']
);

// option detector の追加
$this->request->addDetector('internalIp', [
    'env' => 'CLIENT_IP',
    'options' => ['192.168.0.101', '192.168.0.100']
]);

// header detector を value comparison 付きで追加
$this->request->addDetector('fancy', [
    'env' => 'CLIENT_IP',
    'header' => ['X-Fancy' => 1]
]);

// header detector を callable comparison 付きで追加
$this->request->addDetector('fancy', [
    'env' => 'CLIENT_IP',
    'header' => ['X-Fancy' => function ($value, $header) {
        return in_array($value, ['1', '0', 'yes', 'no'], true);
    }]
]);

// callback detector を追加。有効な callable 形式でなければなりません。
$this->request->addDetector(
    'awesome',
    function ($request) {
        return $request->getParam('awesome');
    }
);

// 追加の引数を使用する detector を追加
$this->request->addDetector(
    'csv',
    [
        'accept' => ['text/csv'],
        'param' => '_ext',
        'value' => 'csv',
    ]
);

利用可能な組み込みの検出器は以下の通りです。

• is('get') 現在のリクエストが GET かどうかを調べます。

• is('put') 現在のリクエストが PUT かどうかを調べます。

• is('patch') 現在のリクエストが PATCH かどうかを調べます。

• is('post') 現在のリクエストが POST かどうかを調べます。

• is('delete') 現在のリクエストが DELETE かどうかを調べます。

• is('head') 現在のリクエストが HEAD かどうかを調べます。

• is('options') 現在のリクエストが OPTIONS かどうかを調べます。

• is('ajax') 現在のリクエストが X-Requested-With = XMLHttpRequest に由来するものかどうかを調べます。

• is('ssl') リクエストが SSL 経由かどうかを調べます。

• is('flash') リクエストに Flash の User-Agent があるかどうかを調べます。

• is('json') リクエストに 「json」 の拡張子を持ち 「application/json」 MIME タイプを受付けるかどうかを調べます。

• is('xml') リクエストが 「xml」拡張子を持ち、「application/xml」または「text/xml」 MIME タイプを受付けるかどうかを調べます。

ServerRequest は、 Cake\Http\ServerRequest::domain() 、 Cake\Http\ServerRequest::subdomains() 、 Cake\Http\ServerRequest::host() のようにサブドメインでアプリケーションを助けるためのメソッドを含みます。

セッションデータ¶

特定のリクエストのセッションにアクセスするには、 getSession() メソッドか session 属性を使用します。

$session = $this->request->getSession();
$session = $this->request->getAttribute('session');

$userName = $session->read('Auth.User.name');

詳細については、セッションオブジェクトを使用する方法のための セッション ドキュメントを参照してください。

ホストとドメイン名¶

Cake\Http\ServerRequest::domain($tldLength = 1)¶

アプリケーションが実行されているドメイン名を返します。

// 'example.org' を表示
echo $request->domain();

Cake\Http\ServerRequest::subdomains($tldLength = 1)¶

アプリケーションが実行されているサブドメインを配列で返します。

// 'my.dev.example.org' の場合、 ['my', 'dev'] を返す
$subdomains = $request->subdomains();

Cake\Http\ServerRequest::host()¶

アプリケーションのホスト名を返します。

// 'my.dev.example.org' を表示
echo $request->host();

HTTP メソッドの読み込み¶

Cake\Http\ServerRequest::getMethod()¶

リクエストの HTTP メソッドを返します。

// POST を出力
echo $request->getMethod();

アクションが受け入れる HTTP メソッドの制限¶

Cake\Http\ServerRequest::allowMethod($methods)¶

許可された HTTP メソッドを設定します。 もしマッチしなかった場合、 MethodNotAllowedException を投げます。 405 レスポンスには、通過できるメソッドを持つ Allow ヘッダーが含まれます。

public function delete()
{
    // POST と DELETE のリクエストのみ受け入れます
    $this->request->allowMethod(['post', 'delete']);
    ...
}

HTTP ヘッダーの読み込み¶

リクエストで使われている HTTP_* ヘッダーにアクセスできます。 例えば

// 文字列としてヘッダーを取得
$userAgent = $this->request->getHeaderLine('User-Agent');

// 全ての値を配列で取得
$acceptHeader = $this->request->getHeader('Accept');

// ヘッダーの存在を確認
$hasAcceptHeader = $this->request->hasHeader('Accept');

いくつかの apache インストール環境では、 Authorization ヘッダーにアクセスできませんが、 CakePHP は、必要に応じて apache 固有のメソッドを介して利用できるようにします。

Cake\Http\ServerRequest::referer($local = true)¶

リクエストのリファラーを返します。

Cake\Http\ServerRequest::clientIp()¶

現在アクセスしているクライアントの IP アドレスを返します。

プロキシーヘッダーの信頼¶

アプリケーションがロードバランサーの背後にあったり、クラウドサービス上で実行されている場合、 しばしばリクエストでロードバランサーのホスト、ポートおよびスキームを取得します。 多くの場合、ロードバランサーはまた、オリジナルの値として HTTP-X-Forwarded-* ヘッダーを送信します。 転送されたヘッダーは、CakePHP によって使用されることはありません。リクエストオブジェクトで これらのヘッダーを使用するには、 trustProxy プロパティーを true にを設定します。

$this->request->trustProxy = true;

// これらのメソッドがプロキシーのヘッダーを使用するようになります。
$port = $this->request->port();
$host = $this->request->host();
$scheme = $this->request->scheme();
$clientIp = $this->request->clientIp();

一度プロキシが信頼されると、 clientIp() メソッドは X-Forwarded-For ヘッダの中の 最後の IPドレスを使用します。 もし、アプリケーションが複数のプロキシの背後にある場合は setTrustedProxies() を使ってコントロール内のプロキシのIPアドレスを定義することができます。

$request->setTrustedProxies(['127.1.1.1', '127.8.1.3']);

プロキシが信頼された後は clientIp() は X-Forwarded-For ヘッダの最初のIPアドレスを使用します。

Accept ヘッダーの確認¶

Cake\Http\ServerRequest::accepts($type = null)¶

クライアントがどのコンテンツタイプを受付けるかを調べます。また、特定のコンテンツタイプが 受付られるかどうかを調べます。

すべてのタイプを取得:

$accepts = $this->request->accepts();

あるタイプについての確認:

$acceptsJson = $this->request->accepts('application/json');

Cake\Http\ServerRequest::acceptLanguage($language = null)¶

クライアントが受付けるすべての言語を取得します。また、特定の言語が受付られるかどうかを調べます。

受付られる言語のリストを取得:

$acceptsLanguages = $this->request->acceptLanguage();

特定の言語が受付られるかどうかの確認:

$acceptsSpanish = $this->request->acceptLanguage('es-es');

クッキーの読込み¶

リクエストのクッキーはいくつかのメソッドを介して読むことができます。

// クッキーの値、またはクッキーが存在しない場合 null を取得
$rememberMe = $this->request->getCookie('remember_me');

// 値の読み込み、またはデフォルトの 0 を取得
$rememberMe = $this->request->getCookie('remember_me', 0);

// ハッシュとして全てのクッキーを取得
$cookies = $this->request->getCookieParams();

// Get a CookieCollection instance
$cookies = $this->request->getCookieCollection()

クッキーコレクションの操作方法については、 Cake\Http\Cookie\CookieCollection のドキュメントをご覧ください。

アップロードされたファイル¶

リクエストはアップロードされたファイルのデータを getData() または getUploadedFiles() で UploadedFileInterface オブジェクトとして公開します。

// アップロードファイルオブジェクトのリストを取得
$files = $request->getUploadedFiles();

// ファイルデータの読み込み
$files[0]->getStream();
$files[0]->getSize();
$files[0]->getClientFileName();

// ファイルの移動
$files[0]->moveTo($targetPath);

URIの操作¶

リクエストは、リクエストされたURIと対話するためのメソッドを含むURIオブジェクトを含みます。

// URIの取得
$uri = $request->getUri();

// URIからデータを読み出す
$path = $uri->getPath();
$query = $uri->getQuery();
$host = $uri->getHost();

コンテンツタイプの扱い¶

Cake\Http\Response::withType($contentType = null)¶

Cake\Http\Response::withType() を使用して、アプリケーションのレスポンスの コンテンツタイプを制御することができます。アプリケーションが Response に組み込まれていない コンテンツの種類に対処する必要がある場合は、以下のように setTypeMap() を使って設定することができます。

// vCard タイプを追加
$this->response->setTypeMap('vcf', ['text/v-card']);

// レスポンスのコンテンツタイプを vcard に設定
$this->response = $this->response->withType('vcf');

大抵の場合、追加のコンテンツタイプはコントローラーの beforeFilter() コールバックの中で設定したいと思うので、 RequestHandlerComponent が提供する ビューの自動切り替え機能を活用できます。

ファイルの送信¶

Cake\Http\Response::withFile($path, $options = [])¶

リクエストに対する応答としてファイルを送信する機会があります。 Cake\Http\Response::withFile() を使用してそれを達成することができます。

public function sendFile($id)
{
    $file = $this->Attachments->getFile($id);
    $response = $this->response->withFile($file['path']);
    // レスポンスオブジェクトを返すとコントローラーがビューの描画を中止します
    return $response;
}

上記の例のようにメソッドにファイルのパスを渡す必要があります。CakePHP は、 Cake\Http\Response::$_mimeTypes に登録された、よく知られるファイルタイプであれば 正しいコンテンツタイプヘッダーを送ります。 Cake\Http\Response::withFile() を呼ぶ前に Cake\Http\Response::withType() メソッドを使って、新しいタイプを追加できます。

もし、あなたが望むなら、 オプションを明記することによって、ブラウザー上に表示する代わりにファイルを ダウンロードさせることができます。

$response = $this->response->withFile(
    $file['path'],
    ['download' => true, 'name' => 'foo']
);

サポートされているオプションは次のとおりです。

name

name は、ユーザーに送信される代替ファイル名を指定することができます。

download

ヘッダーでダウンロードを強制するように設定する必要があるかどうかを示すブール値。

文字列をファイルとして送信¶

動的に生成された pdf や ics のようにディスク上に存在しないファイルを返すことができます。

public function sendIcs()
{
    $icsString = $this->Calendars->generateIcs();
    $response = $this->response;

    // レスポンスのボディーに文字列コンテンツを挿入する
    $response = $response->withStringBody($icsString);

    $response = $response->withType('ics');

    // 任意のダウンロードファイル名を指定できます
    $response = $response->withDownload('filename_for_download.ics');

    // レスポンスオブジェクトを返すとコントローラーがビューの描画を中止します
    return $response;
}

コールバックはボディーを文字列として返すこともできます。

$path = '/some/file.png';
$this->response->body(function () use ($path) {
    return file_get_contents($path);
});

ヘッダーの設定¶

Cake\Http\Response::withHeader($header, $value)¶

ヘッダーの設定は Cake\Http\Response::withHeader() メソッドで行われます。 すべての PSR-7 インターフェイスのメソッドと同様に、このメソッドは新しいヘッダーを含む 新しい インスタンスを返します。

// 一つのヘッダーを追加/置換
$response = $response->withHeader('X-Extra', 'My header');

// 一度に複数ヘッダーを設定
$response = $response->withHeader('X-Extra', 'My header')
    ->withHeader('Location', 'http://example.com');

// 既存のヘッダーに値を追加
$response = $response->withAddedHeader('Set-Cookie', 'remember_me=1');

セットされた際、ヘッダーは送られません。これらのヘッダーは、 Cake\Http\Server によって レスポンスが実際に送られるまで保持されます。

便利なメソッド Cake\Http\Response::withLocation() を使うと 直接リダイレクトヘッダーの設定や取得ができます。

ボディーの設定¶

Cake\Http\Response::withStringBody($string)¶

レスポンスボディーとして文字列を設定するには、次のようにします。

// ボディーの中に文字列をセット
$response = $response->withStringBody('My Body');

// json レスポンスにしたい場合
$response = $response->withType('application/json')
    ->withStringBody(json_encode(['Foo' => 'bar']));

Cake\Http\Response::withBody($body)¶

withBody() を使って、 Laminas\Diactoros\MessageTrait によって提供される レスポンスボディーを設定するには、

$response = $response->withBody($stream);

$stream が Psr\Http\Message\StreamInterface オブジェクトであることを確認してください。新しいストリームを作成する方法は、以下をご覧ください。

Laminas\Diactoros\Stream ストリームを使用して、 ファイルからレスポンスをストリーム化することもできます。

// ファイルからのストリーム化
use Laminas\Diactoros\Stream;

$stream = new Stream('/path/to/file', 'rb');
$response = $response->withBody($stream);

また、 CallbackStream を使用してコールバックをストリーム化できます。 クライアントへストリーム化する必要のある画像、CSV ファイル もしくは PDF のようなリソースがある場合に便利です。

// コールバックからのストリーム化
use Cake\Http\CallbackStream;

// 画像の作成
$img = imagecreate(100, 100);
// ...

$stream = new CallbackStream(function () use ($img) {
    imagepng($img);
});
$response = $response->withBody($stream);

文字コードの設定¶

Cake\Http\Response::withCharset($charset)¶

レスポンスの中で使われる文字コードの種類を設定します。

$this->response = $this->response->withCharset('UTF-8');

ブラウザーキャッシュとの対話¶

Cake\Http\Response::withDisableCache()¶

時々、コントローラーアクションの結果をキャッシュしないようにブラウザーに強制する必要がでてきます。 Cake\Http\Response::withDisableCache() はそういった目的で使われます。

public function index()
{
    // キャッシュの無効化
    $this->response = $this->response->withDisabledCache();
}

Cake\Http\Response::withCache($since, $time = '+1 day')¶

クライアントにレスポンスをキャッシュして欲しいことを伝えられます。 Cake\Http\Response::withCache() を使って:

public function index()
{
    // キャッシュの有効化
    $this->response = $this->response->withCache('-1 minute', '+5 days');
}

上記の例では、訪問者の体感スピード向上のため、クライアントにレスポンス結果を 5日間キャッシュするように伝えています。 withCache() メソッドは、第一引数に Last-Modified ヘッダーの値を設定します。 第二引数に Expires ヘッダーと max-age ディレクティブの値を設定します。 Cache-Control の public ディレクティブも設定されます。

HTTP キャッシュのチューニング¶

アプリケーションの速度を改善するための簡単で最善の方法の一つは HTTP キャッシュを使う事です。 このキャッシュモデルの元では、modified time, response entity tag などいくつかのヘッダーを 設定することでレスポンスのキャッシュコピーを使うべきかどうかをクライアントが決定できるように 助ける事が求められます。

キャッシュやデータが変更されたときに無効化(更新)するロジックのコードを持つのではなく、 HTTP は二つのモデル、expiration と validation を使います。これらは大抵の場合、 自身でキャッシュを管理するよりかなり単純です。

Cake\Http\Response::withCache() と独立して、HTTP キャッシュヘッダーを チューニングするための様々なメソッドが使えます。この点に関して、ブラウザーやリバースプロキシーの キャッシュよりも有利だと言えます。

Cache-Control: private, max-age=3600, must-revalidate

public function view()
{
    // ...
    // Cache-Control を 3600 秒の間、public として設定
    $this->response = $this->response->withSharable(true, 3600);
}

public function my_data()
{
    // ...
    // Cache-Control を 3600 秒の間、private として設定
    $this->response = $this->response->withSharable(false, 3600);
}

public function view()
{
    $this->response = $this->response->withExpires('+5 days');
}

public function index()
{
    $articles = $this->Articles->find('all')->all();

    // 記事内容の単純なチェックサムです
    // 現実世界のアプリケーションでは、もっと効率的な実装を使用する必要があります
    $checksum = md5(json_encode($articles));

    $response = $this->response->withEtag($checksum);
    if ($response->checkNotModified($this->request)) {
        return $response;
    }

    $this->response = $response;
    // ...
}

public function view()
{
    $article = $this->Articles->find()->first();
    $response = $this->response->withModified($article->modified);
    if ($response->checkNotModified($this->request)) {
        return $response;
    }
    $this->response;
    // ...
}

$response = $this->response->withVary('User-Agent');
$response = $this->response->withVary('Accept-Encoding', 'User-Agent');
$response = $this->response->withVary('Accept-Language');

// コントローラーアクションの中で
if ($this->response->checkNotModified($this->request)) {
    return $this->response;
}

クッキーの設定¶

クッキーは、配列または Cake\Http\Cookie\Cookie オブジェクトを使って レスポンスに追加することができます。

use Cake\Http\Cookie\Cookie;
use DateTime;

// クッキーを追加
$this->response = $this->response->withCookie(Cookie::create(
    'remember_me',
    'yes',
    // すべてのキーはオプションです
    [
        'expires' => new DateTime('+1 year'),
        'path' => '',
        'domain' => '',
        'secure' => false,
        'http' => false,
    ]
));

クッキーオブジェクトの使い方は クッキーの作成 セクションをご覧ください。 withExpiredCookie() を使ってレスポンスに期限切れのクッキーを送ることができます。 これにより、ブラウザはローカルクッキーを削除します。

$this->response = $this->response->withExpiredCookie(new Cookie('remember_me'));

クッキーの作成¶

class Cake\Http\Cookie\Cookie¶

Cookie オブジェクトは、コンストラクタオブジェクトを介して、または イミュータブルパターンに従って流れるようなインターフェースを使用することによって 定義することができます。

use Cake\Http\Cookie\Cookie;

// コンストラクタの中の全ての引数
$cookie = new Cookie(
    'remember_me', // 名前
    1, // 値
    new DateTime('+1 year'), // 有効期限、適用する場合
    '/', // パス、該当する場合
    'example.com', // ドメイン名、適用する場合
    false, // secure のみ?
    true // http のみ ?
);

// ビルダーメソッドを使用
$cookie = (new Cookie('remember_me'))
    ->withValue('1')
    ->withExpiry(new DateTime('+1 year'))
    ->withPath('/')
    ->withDomain('example.com')
    ->withSecure(false)
    ->withHttpOnly(true);

クッキーを作成したら、新規または既存の CookieCollection に追加することができます。

use Cake\Http\Cookie\CookieCollection;

// 新規のコレクションを作成
$cookies = new CookieCollection([$cookie]);

// 既存のコレクションに追加
$cookies = $cookies->add($cookie);

// 名前でクッキーを削除
$cookies = $cookies->remove('remember_me');

レスポンスにクッキーオブジェクトを追加することができます。

// クッキーを1つ追加
$response = $this->response->withCookie($cookie);

// クッキーコレクション全体を置き換える
$response = $this->response->withCookieCollection($cookies);

レスポンスにセットするクッキーは クッキー暗号化ミドルウェア を使って 暗号化することができます。

クッキーの読込み¶

CookieCollection インスタンスを取得すると、それに含まれるクッキーにアクセスできます。

// クッキーが存在するかどうかをチェック
$cookies->has('remember_me');

// コレクション内のクッキーの数を取得
count($cookies);

// クッキーインスタンスを取得
$cookie = $cookies->get('remember_me');

Cookie オブジェクトを取得すると、その状態をやりとりしたり変更したりできます。 クッキーは不変なので、クッキーを変更した場合にコレクションを更新する必要があることに 注意してください。

// 値の取得
$value = $cookie->getValue()

// JSON 値の中のデータにアクセス
$id = $cookie->read('User.id');

// 状態のチェック
$cookie->isHttpOnly();
$cookie->isSecure();