后端Web框架【免費(fèi)下載鏈接】CodeIgniter4Open Source PHP Framework (originally from EllisLab)項(xiàng)目地址https://gitcode.com/gh_mirrors/co/CodeIgniter4點(diǎn)擊查看免費(fèi)下載本指南以 CodeIgniter 4 官方用戶指南 request.rst 為主體系統(tǒng)講解框架中CodeIgniter\HTTP\Request類的設(shè)計(jì)定位、完整 API 與底層實(shí)現(xiàn)。閱讀本文后你將掌握如何獲取并校驗(yàn)客戶端 IP、如何讀取與偽造 HTTP 請(qǐng)求方法、如何安全地帶過濾地訪問$_SERVER/$_ENV等 PHP 全局?jǐn)?shù)據(jù)以及如何在測(cè)試場(chǎng)景中通過setGlobal()/fetchGlobal()注入和取回?cái)?shù)據(jù)。一、Request 類的定位一個(gè)類兩種角色Request類是 CodeIgniter 4 對(duì) HTTP 請(qǐng)求的面向?qū)ο驩OP表示。它的設(shè)計(jì)初衷是同時(shí)服務(wù)于兩類請(qǐng)求傳入請(qǐng)求Incoming瀏覽器等客戶端發(fā)往應(yīng)用程序的請(qǐng)求傳出請(qǐng)求Outgoing應(yīng)用程序向第三方服務(wù)發(fā)出的請(qǐng)求。為此Request類提供了這兩類請(qǐng)求共同需要的通用功能而具體的差異化能力則交給兩個(gè)繼承它的子類去擴(kuò)展子類用途對(duì)應(yīng)文檔CodeIgniter\HTTP\IncomingRequest處理來自瀏覽器等客戶端的請(qǐng)求IncomingRequest 類CodeIgniter\HTTP\CURLRequest應(yīng)用向第三方應(yīng)用發(fā)送請(qǐng)求基于 cURLCURLRequest 類從源碼看Request類位于 system/HTTP/Request.php它繼承自O(shè)utgoingRequest并實(shí)現(xiàn)RequestInterface同時(shí)通過use RequestTrait引入大部分實(shí)際方法實(shí)現(xiàn)。構(gòu)造時(shí)Request.php#L32-L43若未顯式指定請(qǐng)求方法它會(huì)從$_SERVER[REQUEST_METHOD]讀取缺省時(shí)回退為Method::GETpublic function __construct($config null) { $this-config $config ?? config(App::class); if ($this-method null || $this-method ) { $this-method $this-getServer(REQUEST_METHOD) ?? Method::GET; } if (! $this-uri instanceof URI) { $this-uri new URI(); } }因此在實(shí)際開發(fā)中你通常直接使用兩個(gè)子類而Request類與RequestTrait中的方法IP 獲取、方法讀寫、全局?jǐn)?shù)據(jù)訪問則會(huì)被它們自動(dòng)繼承。提示RequestTrait位于 system/HTTP/RequestTrait.php其中標(biāo)注了 4.7.0 起$globals屬性與populateGlobals()方法已逐步遷移到獨(dú)立的 Superglobals 服務(wù)但公開 API 保持不變本文所述方法仍可正常使用。二、獲取客戶端 IPgetIPAddress()getIPAddress()用于返回當(dāng)前用戶的 IP 地址。若 IP 無效則返回0.0.0.0echo $request-getIPAddress();示例出自 request/001.php底層實(shí)現(xiàn)邏輯結(jié)合 RequestTrait.php#L62-L105 的實(shí)現(xiàn)其執(zhí)行流程為若屬性已緩存$this-ipAddress ! 直接返回緩存值從$_SERVER[REMOTE_ADDR]讀取地址CLI 請(qǐng)求下該項(xiàng)為null直接返回0.0.0.0遍歷Config\App::$proxyIPs中配置的可信代理若REMOTE_ADDR命中可信代理則改從對(duì)應(yīng) HTTP 頭如X-Forwarded-For、X-Real-IP讀取真實(shí)客戶端 IP使用FormatRules::valid_ip校驗(yàn)最終地址不合法則返回0.0.0.0。關(guān)鍵Config\App::$proxyIPs反向代理配置getIPAddress()會(huì)參考Config\App::$proxyIPs設(shè)置只有當(dāng)請(qǐng)求來自允許的代理 IP 時(shí)才會(huì)采信 HTTP 頭中上報(bào)的客戶端 IP避免偽造。配置位于 app/Config/App.php#L162-L183public array $proxyIPs [];示例配置鍵為代理 IP 或 CIDR 網(wǎng)段值為對(duì)應(yīng)客戶端 IP 的 HTTP 頭public array $proxyIPs [ 10.0.1.200 X-Forwarded-For, 192.168.5.0/24 X-Real-IP, ];注意proxyIPs必須以“代理 IP 地址為鍵、HTTP 頭名為值”的數(shù)組形式給出否則getIPAddress()會(huì)拋出ConfigException。底層通過checkIPAgainstProxy()支持 IPv4 / IPv6 及 CIDR 網(wǎng)段匹配見 RequestTrait.php#L167-L219。常見坑雙棧服務(wù)器上代理的 IPv4 地址可能被報(bào)告為 IPv4 映射的 IPv6 形式如::ffff:192.168.5.21與192.168.5.0/24這類 IPv4 條目不匹配。此時(shí)需將映射形式如::ffff:192.168.5.21或::ffff:192.168.5.0/120也加入proxyIPs。該提示同樣適用于isSecure()對(duì)X-Forwarded-Proto/Front-End-Https頭的信任判斷詳見 incomingrequest.rst。三、IP 合法性校驗(yàn)isValidIP()已棄用isValidIP($ip[, $which ])接收一個(gè) IP 地址返回布爾值表示其是否合法if (! $request-isValidIP($ip)) { echo Not Valid; } else { echo Valid; }示例出自 request/002.php第二個(gè)可選參數(shù)$which用于指定協(xié)議格式取值為ipv4或ipv6默認(rèn)同時(shí)檢查兩種格式。值得注意的是getIPAddress()內(nèi)部已經(jīng)自動(dòng)完成 IP 校驗(yàn)無需再額外調(diào)用本方法。棄用說明自4.0.5起該方法被標(biāo)記為棄用官方建議改用 Validation 庫 中的valid_ip規(guī)則未來版本將徹底移除。四、請(qǐng)求方法HTTP Method的讀取與設(shè)置4.1 getMethod()讀取請(qǐng)求方法getMethod()返回$_SERVER[REQUEST_METHOD]的值即當(dāng)前請(qǐng)求的 HTTP 方法echo $request-getMethod(); // 輸出: POST示例出自 request/003.php關(guān)于大小寫需要特別留意HTTP 方法區(qū)分大小寫按約定標(biāo)準(zhǔn)化方法使用全大寫 US-ASCII 字母如GET、POST、DELETE。CodeIgniter 4 中 HTTP 方法以常量形式集中定義在 system/HTTP/Method.phpMethod::GET、Method::POST、Method::PUT、Method::PATCH、Method::DELETE等以及返回全部方法的Method::all()。如需小寫形式自行用strtolower()包裝即可。注意v4.5.0 之前getMethod()默認(rèn)返回小寫字符串如get、post這被官方認(rèn)定為一個(gè) bug當(dāng)前版本返回大寫。在 incomingrequest.rst 中另有更完整的is()方法v4.3.0 起可對(duì) HTTP 方法、ajax、json做布爾判斷。4.2 setMethod() 與 withMethod()設(shè)置/偽造請(qǐng)求方法方法版本行為返回值setMethod($method)自 4.0.5 棄用直接修改當(dāng)前實(shí)例用于請(qǐng)求偽裝/spoofing返回$thiswithMethod($method)4.0.5 新增克隆當(dāng)前實(shí)例并修改方法原實(shí)例不變返回新請(qǐng)求實(shí)例withMethod()的不變性immutability實(shí)現(xiàn)見 Request.php#L68-L75public function withMethod($method) { $request clone $this; $request-method $method; return $request; }官方明確建議新代碼一律使用withMethod()setMethod()僅作向后兼容保留源碼中標(biāo)注deprecated 4.0.5。OutgoingRequest基類中同樣存在這兩組方法見 system/HTTP/OutgoingRequest.php供傳出請(qǐng)求場(chǎng)景使用。五、讀取服務(wù)器與環(huán)境數(shù)據(jù)getServer() / getEnv()5.1 getServer()讀取 $_SERVERgetServer()與IncomingRequest中的getPost()、getGet()、getCookie()用法一致只是數(shù)據(jù)源為$_SERVER。其簽名如下getServer([$index null[, $filter null[, $flags null]]])讀取單個(gè)值$request-getServer(some_data);示例出自 request/004.php同時(shí)讀取多個(gè)鍵時(shí)把所需的鍵以數(shù)組傳入返回以鍵名為下標(biāo)的結(jié)果數(shù)組$request-getServer([SERVER_PROTOCOL, REQUEST_URI]);示例出自 request/005.php5.2 getEnv()讀取 $_ENV已棄用getEnv()用法與getServer()完全一致只是數(shù)據(jù)源為$_ENV$request-getEnv(some_data);示例出自 request/006.php同樣支持?jǐn)?shù)組形式的批量讀取$request-getEnv([CI_ENVIRONMENT, S3_BUCKET]);示例出自 request/007.php棄用說明自4.4.4起官方在源碼中明確標(biāo)注“該方法自始就無法正常工作”并建議改用全局輔助函數(shù)env()。請(qǐng)勿在新代碼中使用getEnv()。5.3 參數(shù)詳解與過濾能力getServer()的完整參數(shù)與 PHPfilter_input系列保持一致參考 RequestTrait.php#L230-L233參數(shù)類型說明$indexmixed取值鍵名為null時(shí)返回整個(gè)全局?jǐn)?shù)組為數(shù)組時(shí)批量返回多個(gè)鍵$filterint要應(yīng)用的過濾器類型取值見 PHP 手冊(cè)“Types of filters”$flagsint\|array要應(yīng)用的過濾器標(biāo)志取值見 PHP 手冊(cè)“Filter flags”fetchGlobal()是這一切的底層引擎未指定$filter時(shí)默認(rèn)使用FILTER_UNSAFE_RAW原樣返回不丟失任何內(nèi)容指定過濾器后標(biāo)量值經(jīng)filter_var()處理數(shù)組值會(huì)通過array_walk_recursive()遞歸應(yīng)用過濾器見 RequestTrait.php#L288-L366。六、操作 PHP 全局setGlobal() 與 fetchGlobal()這兩個(gè)方法直接面向 PHP 超級(jí)全局變量$_GET、$_POST、$_COOKIE、$_SERVER、$_REQUEST是測(cè)試與自定義數(shù)據(jù)流場(chǎng)景的重要工具。6.1 setGlobal()手動(dòng)設(shè)置全局值setGlobal($method, $value)$method全局名稱小寫如get、post、server、cookie、request$value要寫入的數(shù)據(jù)返回$this以支持鏈?zhǔn)秸{(diào)用。底層實(shí)現(xiàn)見 RequestTrait.php#L260-L269它同時(shí)更新內(nèi)部的$globals緩存并通過service(superglobals)-setGlobalArray()同步到新的 Superglobals 服務(wù)保證向后兼容。6.2 fetchGlobal()從全局讀取并可選過濾fetchGlobal($method [, $index null[, $filter null[, $flags null]]])$method輸入過濾器常量對(duì)應(yīng)的全局名稱小寫其余參數(shù)與getServer()相同。其特性包括$index為null時(shí)返回整個(gè)全局?jǐn)?shù)組支持?jǐn)?shù)組下標(biāo)語法取深層值例如fetchGlobal(post, clients[address][zipcode])可直接獲取嵌套數(shù)組中的元素支持批量獲取多個(gè)鍵傳入數(shù)組支持遞歸過濾嵌套數(shù)組。這些行為在 tests/system/HTTP/RequestTest.php 中均有完整測(cè)試佐證例如testFetchGlobalsFiltersValues驗(yàn)證了FILTER_SANITIZE_ENCODED過濾后barscript變?yōu)閎ar%3Cscript%3EtestFetchGlobalReturnsSelectedKeys驗(yàn)證了數(shù)組鍵的批量讀取。七、實(shí)戰(zhàn)小結(jié)與安全建議優(yōu)先使用繼承子類日常開發(fā)中訪問Request功能應(yīng)通過IncomingRequest控制器內(nèi)可用$this-request屬性控制器外可通過 Services 獲取傳出場(chǎng)景使用CURLRequest具體見 IncomingRequest 類文檔 與 CURLRequest 類文檔。避開兩個(gè)已棄用方法isValidIP()用 Validation 的valid_ip規(guī)則替代getEnv()用env()輔助函數(shù)替代。IP 獲取務(wù)必配置可信代理一旦應(yīng)用部署在反向代理Nginx、負(fù)載均衡等之后請(qǐng)務(wù)必在Config\App::$proxyIPs白名單中登記代理地址否則getIPAddress()可能讀取到偽造的客戶端 IP。訪問全局?jǐn)?shù)據(jù)時(shí)善用過濾器getServer()/fetchGlobal()的$filter/$flags參數(shù)可讓你在取數(shù)的同時(shí)完成輸入凈化避免先取回再手工處理的繁瑣與遺漏。保持對(duì)象不變性需要臨時(shí)改變請(qǐng)求方法如測(cè)試、偽裝時(shí)使用withMethod()它返回新實(shí)例而不會(huì)污染原請(qǐng)求對(duì)象。延伸閱讀Request類還繼承自Message類后者提供了headers()、header()、getBody()、getProtocolVersion()等消息級(jí)能力完整方法清單可在 incomingrequest.rst 的“Class Reference”一節(jié)查看。贊分享后端Web框架【免費(fèi)下載鏈接】CodeIgniter4Open Source PHP Framework (originally from EllisLab)項(xiàng)目地址https://gitcode.com/gh_mirrors/co/CodeIgniter4點(diǎn)擊查看免費(fèi)下載相關(guān)推薦FastAPI Request 類參考直接訪問原始 HTTP 請(qǐng)求對(duì)象的機(jī)制與源碼解析FastAPI Request 類參考直接訪問原始 HTTP 請(qǐng)求對(duì)象的機(jī)制與源碼解析 本篇基于 FastAPI 官方參考文檔 docs/en/docs/re后端Web框架API設(shè)計(jì)OpCore Simplify智能自動(dòng)化黑蘋果配置的革命性工具OpCore Simplify智能自動(dòng)化黑蘋果配置的革命性工具 還在為復(fù)雜的黑蘋果配置過程而煩惱嗎OpCore Simplify作為一款革命性的 OpenC開發(fā)工具CLIStarlette 請(qǐng)求對(duì)象完全指南從 ASGI scope 到 Request 的優(yōu)雅封裝Starlette 請(qǐng)求對(duì)象完全指南從 ASGI scope 到 Request 的優(yōu)雅封裝 導(dǎo)讀 Request 是 Starlette 為 ASGI 應(yīng)用后端Web框架創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考