### 3.3?`Psr\Http\Message\ResponseInterface` ~~~php <?php namespace Psr\Http\Message; /** * 表示服務器返回的響應消息。 * * 根據 HTTP 規范，此接口包含以下各項的屬性： * * - 協議版本 * - 狀態碼和原因短語 * - 報頭 * - 消息體 * * HTTP 響應是被視為無法修改的，所有能修改狀態的方法，都 **必須** 有一套機制，在內部保 * 持好原有的內容，然后把修改狀態后的，新的 HTTP 響應實例返回。 */ interface ResponseInterface extends MessageInterface { /** * 獲取響應狀態碼。 * * 狀態碼是一個三位整數，用于理解請求。 * * @return int 狀態碼。 */ public function getStatusCode(); /** * 返回具有指定狀態碼和原因短語（可選）的實例。 * * 如果未指定原因短語，實現代碼 **可能** 選擇 RFC7231 或 IANA 為狀態碼推薦的原因短語。 * * 此方法在實現的時候，**必須** 保留原有的不可修改的 HTTP 消息實例，然后返回 * 一個新的修改過的 HTTP 消息實例。 * * @see http://tools.ietf.org/html/rfc7231#section-6 * @see http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml * @param int $code 三位整數的狀態碼。 * @param string $reasonPhrase 為狀態碼提供的原因短語；如果未提供，實現代碼可以使用 HTTP 規范建議的默認代碼。 * @return self * @throws \InvalidArgumentException 如果傳入無效的狀態碼，則拋出。 */ public function withStatus($code, $reasonPhrase = ''); /** * 獲取與響應狀態碼關聯的響應原因短語。 * * 因為原因短語不是響應狀態行中的必需元素，所以原因短語 **可能** 是空。 * 實現代碼可以選擇返回響應的狀態代碼的默認 RFC 7231 推薦原因短語（或 IANA HTTP 狀態碼注冊表中列出的原因短語）。 * * @see http://tools.ietf.org/html/rfc7231#section-6 * @see http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml * @return string 原因短語；如果不存在，則 **必須** 返回空字符串。 */ public function getReasonPhrase(); } ~~~