請求與輸入 · October Cms 筆記

# 請求與輸入 ### 基本輸入您可以使用一些簡單的方法訪問所有用戶輸入。使用`Input`外觀時，您無需擔心請求的HTTP動詞，因為對所有動詞的輸入方式都是相同的。全局`input`[幫助器函數](https://octobercms.com/docs/services/helpers)是的別名`Input::get`。 #### 檢索輸入值 ~~~ $name = Input::get('name'); ~~~ #### 如果輸入值不存在，則檢索默認值 ~~~ $name = Input::get('name', 'Sally'); ~~~ #### 確定是否存在輸入值 ~~~ if (Input::has('name')) { // } ~~~ #### 獲取請求的所有輸入 ~~~ $input = Input::all(); ~~~ #### 僅獲取部分請求輸入 ~~~ $input = Input::only('username', 'password'); $input = Input::except('credit_card'); ~~~ 當使用帶有“數組”輸入的表單時，可以使用點符號來訪問數組： ~~~ $input = Input::get('products.0.name'); ~~~ > **注意：**某些JavaScript庫（例如Backbone）可能會將輸入作為JSON發送到應用程序。您可以像平常一樣通過訪問此數據`Input::get`。 ### [](https://octobercms.com/docs/services/request-input#cookies)餅干默認情況下，十月份創建的所有cookie均會加密并使用身份驗證代碼簽名，這意味著如果客戶端更改了它們，它們將被視為無效。`cookie.unencryptedCookies`配置密鑰中命名的Cookies將不會被加密。 > **注意：**Cookie是使用APP\_KEY加密的，因此，如果客戶端知道APP\_KEY，則有可能由客戶端制作Cookie。如果您的應用程序的加密密鑰在惡意方的手中，則該方可以使用該加密密鑰來制作Cookie值，并利用繼承給PHP對象序列化/反序列化的漏洞，例如在應用程序內調用任意類方法。為了緩解這種情況，請在懷疑您的APP\_KEY受到威脅時始終旋轉它，并確保在使用前始終確保從cookie接收到的數據與您期望的一樣。 #### 檢索Cookie值 ~~~ $value = Cookie::get('name'); ~~~ #### 將新的Cookie附加到響應 ~~~ $response = Response::make('Hello World'); $response->withCookie(Cookie::make('name', 'value', $minutes)); ~~~ #### 為下一個響應排隊一個cookie 如果要在創建響應之前設置cookie，請使用`Cookie::queue`方法。Cookie將自動附加到您的應用程序的最終響應中。 ~~~ Cookie::queue($name, $value, $minutes); ~~~ #### 創建一個永久存在的cookie ~~~ $cookie = Cookie::forever('name', 'value'); ~~~ #### 未經加密處理cookie 如果您不希望對某些Cookie進行加密或解密，則可以在配置中指定它們。例如，當您想通過Cookie將數據從前端傳遞到服務器端后端，反之亦然時，這很有用。將不應加密或解密的cookie名稱添加到配置文件中的`unencryptedCookies`參數`config/cookie.php`。 ~~~ /* |-------------------------------------------------------------------------- | Cookies without encryption |-------------------------------------------------------------------------- | | OctoberCMS encrypts/decrypts cookies by default. You can specify cookies | that should not be encrypted or decrypted here. This is useful, for | example, when you want to pass data from frontend to server side backend | via cookies, and vice versa. | */ 'unencryptedCookies' => [ 'my_cookie', ], ~~~ 另外，對于插件，您也可以從`Plugin.php`插件中動態添加這些插件。 ~~~ public function boot() { Config::push('cookie.unencryptedCookies', "my_cookie"); } ~~~ ### [](https://octobercms.com/docs/services/request-input#old-input)舊輸入您可能需要保留一個請求的輸入，直到下一個請求。例如，檢查表單中的驗證錯誤后，您可能需要重新填充表單。 #### 將輸入閃爍到會話 ~~~ Input::flash(); ~~~ #### 僅將部分輸入閃爍 ~~~ Input::flashOnly('username', 'email'); Input::flashExcept('password'); ~~~ 由于您通常希望將輸入的Flash與重定向到上一頁相關聯，因此您可以輕松地將輸入的Flash鏈接到重定向。 ~~~ return Redirect::to('form')->withInput(); return Redirect::to('form')->withInput(Input::except('password')); ~~~ > **注意：**您可以使用[Session](https://octobercms.com/docs/services/session)類跨請求刷新其他數據。 #### 檢索舊數據 ~~~ Input::old('username'); ~~~ ### [](https://octobercms.com/docs/services/request-input#files)檔案 #### 檢索上傳的文件 ~~~ $file = Input::file('photo'); ~~~ #### 確定是否上傳了文件 ~~~ if (Input::hasFile('photo')) { // } ~~~ 該`file`方法返回的對象是`Symfony\Component\HttpFoundation\File\UploadedFile`該類的實例，該類擴展了PHP`SplFileInfo`類并提供了多種與文件進行交互的方法。 #### 確定上傳的文件是否有效 ~~~ if (Input::file('photo')->isValid()) { // } ~~~ #### 移動上傳的文件 ~~~ Input::file('photo')->move($destinationPath); Input::file('photo')->move($destinationPath, $fileName); ~~~ #### 檢索上傳文件的路徑 ~~~ $path = Input::file('photo')->getRealPath(); ~~~ #### 檢索上傳文件的原始名稱 ~~~ $name = Input::file('photo')->getClientOriginalName(); ~~~ #### 檢索上傳文件的擴展名 ~~~ $extension = Input::file('photo')->getClientOriginalExtension(); ~~~ #### 檢索上傳文件的大小 ~~~ $size = Input::file('photo')->getSize(); ~~~ #### 檢索上傳文件的MIME類型 ~~~ $mime = Input::file('photo')->getMimeType(); ~~~ ### [](https://octobercms.com/docs/services/request-input#request-information)索取資料本`Request`類提供了檢查您的應用程序的HTTP請求許多方法和擴展`Symfony\Component\HttpFoundation\Request`類。這兒是一些精彩片段。 #### 檢索請求URI ~~~ $uri = Request::path(); ~~~ #### 檢索請求方法 ~~~ $method = Request::method(); if (Request::isMethod('post')) { // } ~~~ #### 確定請求路徑是否與模式匹配 ~~~ if (Request::is('admin/*')) { // } ~~~ #### 獲取請求URL ~~~ $url = Request::url(); ~~~ #### 檢索請求URI段 ~~~ $segment = Request::segment(1); ~~~ #### 檢索請求標頭 ~~~ $value = Request::header('Content-Type'); ~~~ #### 從$ \_SERVER檢索值 ~~~ $value = Request::server('PATH_INFO'); ~~~ #### 確定請求是否通過HTTPS ~~~ if (Request::secure()) { // } ~~~ #### 確定請求是否正在使用AJAX ~~~ if (Request::ajax()) { // } ~~~ #### 確定請求是否具有JSON內容類型 ~~~ if (Request::isJson()) { // } ~~~ #### 確定請求是否要求JSON ~~~ if (Request::wantsJson()) { // } ~~~ #### 檢查請求的響應格式該`Request::format`方法將基于HTTP Accept標頭返回請求的響應格式： ~~~ if (Request::format() == 'json') { // } ~~~