{"id":10020846,"date":"2025-06-23T17:00:40","date_gmt":"2025-06-23T09:00:40","guid":{"rendered":"https:\/\/itmax.cn\/?p=10020846"},"modified":"2025-06-23T17:00:40","modified_gmt":"2025-06-23T09:00:40","slug":"%e4%bb%8b%e7%bb%8d%e4%b8%80%e4%b8%aa-laravel-%e4%b8%ad%e6%9c%89%e7%94%a8%e7%9a%84%e5%b7%a5%e5%85%b7%e7%b1%bb%ef%bc%9afluent","status":"publish","type":"post","link":"https:\/\/itmax.cn\/?p=10020846","title":{"rendered":"\u4ecb\u7ecd\u4e00\u4e2a Laravel \u4e2d\u6709\u7528\u7684\u5de5\u5177\u7c7b\uff1aFluent"},"content":{"rendered":"

\u524d\u8a00<\/h2>\n

\u5728\u4e4b\u524d\u4f7f\u7528 PHPStan \u5bf9\u4ee3\u7801\u8fdb\u884c\u9759\u6001\u68c0\u67e5\u7684\u65f6\u5019\uff0c\u5982\u679c\u628a\u68c0\u67e5\u7b49\u7ea7\u63d0\u5347\u5230 9\uff0c\u5728\u628a\u4e00\u4e2a mixed<\/code> \u7c7b\u578b\u7684\u503c\u4f20\u9012\u7ed9\u9700\u8981\u660e\u786e\u7c7b\u578b\u7684\u53c2\u6570\u65f6\uff0c\u5c31\u4f1a\u51fa\u73b0\u63d0\u793a\u3002<\/p>\n

function foo(int $a): int\n{\n    return $a * 1;\n}\n\nfunction bar(): mixed\n{\n    return 'a';\n}\n\n$a = bar();\n$b = foo($a); \/\/ Parameter #1 $a of function foo expects int, mixed given.\nvar_dump($b);<\/code><\/pre>\n
\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u8fd9\u91cc bar<\/code> \u8fd4\u56de\u4e86\u4e00\u4e2a mixed<\/code> \u7c7b\u578b\uff0c\u800c foo<\/code> \u671f\u5f85\u4e00\u4e2a int<\/code> \u7c7b\u578b\u7684\u53c2\u6570\u3002<\/p>\n
\u8fd9\u65f6\u5019\u4f60\u53ef\u80fd\u89c9\u5f97\u5f88\u7b80\u5355\uff0c\u4f7f\u7528 (int)<\/code> \u5c06 bar<\/code> \u7684\u8fd4\u56de\u503c\u5f3a\u5236\u8f6c\u6362\u4e00\u4e0b\u4e0d\u5c31\u597d\u4e86\u5417\uff1f<\/p>\n
$a = (int) bar(); \/\/ Cannot cast mixed to string.\n$b = foo($a);\nvar_dump($b);<\/code><\/pre>\n
\u800c\u8fd9\u6837\u540c\u6837\u4f1a\u89e6\u53d1\u53e6\u4e00\u4e2a\u95ee\u9898\uff0c\u56e0\u4e3a mixed<\/code> \u53ef\u4ee5\u662f\u4efb\u610f\u7c7b\u578b\uff0c\u5b83\u662f\u4e0d\u53ef\u9760\u7684\uff0c\u8fd9\u6837\u5f3a\u5236\u8f6c\u6362\u7684\u8bdd\uff0c\u6709\u53ef\u80fd\u51fa\u73b0\u5f02\u5e38\u3002<\/p>\n
\u8981\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u6709\u591a\u79cd\u65b9\u6848\uff1a<\/p>\n
\/\/ 1\u3001\u4f7f\u7528 is_int \u8fdb\u884c\u68c0\u67e5\uff0c\u786e\u4fdd `$a` \u7684\u4e00\u5b9a\u662f int \u7c7b\u578b\u7684\u65f6\u5019\uff0c\u624d\u8fdb\u884c\u4e0b\u9762\u7684\u64cd\u4f5c\u3002\n$a = bar();\nif (is_int($a)) {\n    $b = foo($a);\n    var_dump($b);\n}\n\n\/\/ 2\u3001\u4f7f\u7528\u6ce8\u91ca\uff0c\u4eba\u4e3a\u5730\u544a\u8bc9 PHPStan\uff0c`$a` \u662f\u4e00\u4e2a int\n\/** @var int $a *\/\n$a = bar();\n$b = foo($a);\nvar_dump($b);\n\n\/\/ 3\u3001\u4f7f\u7528 assert\uff08\u5185\u7f6e\u6216\u8005\u7b2c\u4e09\u65b9\u7684\uff0c\u5176\u5b9e\u8ddf\u7b2c\u4e00\u79cd\u5dee\u4e0d\u591a\uff0c\u662f\u5728\u5931\u8d25\u65f6\u4f1a\u629b\u51fa\u5f02\u5e38\uff09\uff0c\u6b64\u5904\u4ee5 webmozart\/assert \u4e3e\u4f8b\nuse Webmozart\/Assert\/Assert;\n\/\/ ...\n\n$a = bar();\nAssert::integer($a);\n\/\/ \u6ce8\u610f\uff0c\u5982\u679c\u6211\u4eec\u542f\u7528\u4e86 PHP \u7684\u4e25\u683c\u6a21\u5f0f\u7684\u8bdd\uff0c\u6211\u4eec\u5b9e\u9645\u8fd8\u9700\u8981\u5728\u8fd9\u91cc\u5bf9 $a \u6267\u884c\u5f3a\u5236\u8f6c\u6362\u624d\u884c\u3002\n$b = foo($a);\nvar_dump($b);<\/code><\/pre>\n
\u5176\u4e2d\u7b2c\u4e00\u79cd\u548c\u7b2c\u4e09\u79cd\u660e\u663e\u6700\u5b89\u5168\uff0c\u4f46\u662f\u8981\u5f15\u5165\u989d\u5916\u7684\u5224\u65ad\uff0c\u9002\u5408\u4e00\u4e9b\u786e\u5b9e\u6765\u6e90\u7c7b\u578b\u4e0d\u786e\u5b9a\u7684\u573a\u666f\u3002<\/p>\n
\u7b2c\u4e00\u79cd\u6ca1\u6709\u6dfb\u52a0 else<\/code> \u7684\u5904\u7406\uff0c\u800c\u7b2c\u4e09\u79cd\u4f1a\u5728\u68c0\u67e5\u5230\u4e0d\u662f int<\/code> \u65f6\u629b\u51fa\u5f02\u5e38\uff0c\u8fd9\u4e9b\u90fd\u9700\u8981\u989d\u5916\u5904\u7406\u3002<\/p>\n
\u800c\u7b2c\u4e8c\u79cd\u5219\u662f\u4e00\u79cd\u6b3a\u9a97<\/strong>\uff0c\u4f46\u5728\u4e00\u4e9b\u573a\u666f\u4e2d\uff0c\u6211\u4eec\u9047\u5230\u7684\u66f4\u591a\u5176\u5b9e\u662f\u8fd9\u6837\u7684\u60c5\u51b5\u3002<\/p>\n
\u800c\u5728 Laravel \u4e2d\uff0c\u6211\u4eec\u6700\u5e38\u9047\u5230\u7684\u5c31\u662f\u4ece\u8bf7\u6c42\u83b7\u53d6\u53c2\u6570\uff0c\u5927\u90e8\u5206\u65f6\u5019\uff0c\u6211\u4eec\u90fd\u5728\u4f7f\u7528 Request<\/code> \u7684 input<\/code>\u3001get<\/code> \u65b9\u6cd5\uff0c\u800c\u8fd9\u4e24\u4e2a\u65b9\u6cd5\uff0c\u8fd4\u56de\u7684\u503c\u5c31\u662f mixed<\/code> \u7c7b\u578b\u7684\uff0c\u800c\u5b9e\u9645\u4e0a\u6211\u4eec\u53ef\u80fd\u5df2\u7ecf\u5728\u8868\u5355\u9a8c\u8bc1\u4e2d\uff0c\u8fd9\u4e2a\u5b57\u6bb5\u53ea\u80fd\u662f\u5b57\u7b26\u3001\u6570\u5b57\u3001\u5e03\u5c14\u3002\u5982\u679c\u6211\u4eec\u8fd9\u91cc\u4e3a\u4e86\u7cca\u5f04 PHPStan \u7684\u8bdd\uff0c\u5c31\u5f97\u7f16\u5199\u7c7b\u4f3c\u4e8e\u4e0a\u9762\u7684\u4ee3\u7801\u3002<\/p>\n
\n
\u8ba4\u8bc6 Fluent<\/h2>\n
\u90a3\u6709\u6ca1\u6709\u66f4\u597d\u7684\u65b9\u6848\uff1f\u7b54\u6848\u662f\u6709\u7684\uff0c\u90a3\u5c31\u662f \/Illuminate\/Support\/Fluent<\/code>\uff08\u4e0b\u6587\u7b80\u79f0 Fluent \u6216 Fluent<\/code>\uff09\u3002<\/p>\n
Fluent<\/code> \u8fd9\u4e2a\u7c7b\u5728 Laravel \u4e2d\u5b58\u5728\u4e86\u5f88\u4e45\uff0c\u65e9\u671f\u5b83\u4e3b\u8981\u627f\u62c5\u4e86\u4e00\u4e9b\u7b80\u5355\u7684 get<\/code> \u548c\u7c7b\u6570\u7ec4\u8bbf\u95ee\u7684\u64cd\u4f5c\u3002<\/p>\n
\u800c\u5728 Laravel \u4e2d\uff0c\u56e0\u4e3a\u8fd9\u4e2a PR\/# 53665<\/a>\uff0c\u5f00\u59cb\u53d8\u5f97\u4e0e\u4f17\u4e0d\u540c\u3002<\/p>\n
\u6839\u636e PR \u7684\u4ecb\u7ecd\uff0c\u4e0b\u9762\u8fd9\u4e9b\u65b9\u6cd5\uff0c\u4ece \/Illuminate\/Http\/Concerns\/InteractsWithInput<\/code> \u79fb\u52a8\u5230\u4e86 \/Illuminate\/Support\/Traits\/InteractsWithData<\/code>\uff0cFluent<\/code> \u4f7f\u7528 InteractsWithData<\/code> \u8fd9\u4e2a Trait\u3002<\/p>\n
has($key)\nonly($keys)\nexists($key)\nfilled($key)\nhasAny($keys)\nmissing($key)\nexcept($keys)\nanyFilled($keys)\nisNotFilled($key)\ncollect($key = null)\nenum($key, $enumClass)\nenums($key, $enumClass)\nstr($key, $default = null)\ninteger($key, $default = 0)\nfloat($key, $default = 0.0)\nstring($key, $default = null)\nboolean($key = null, $default = false)\ndate($key, $format = null, $tz = null)\nwhenHas($key, callable $callback, ?callable $default = null)\nwhenFilled($key, callable $callback, ?callable $default = null)\nwhenMissing($key, callable $callback, ?callable $default = null)<\/code><\/pre>\n
\u6ce8\u610f\u5176\u4e2d\u7684 enum<\/code>\/enums<\/code>\/str<\/code>\/int<\/code>\/float<\/code>\/string<\/code>\/boolean<\/code>\/date<\/code>\/collect<\/code>\/array<\/code> \u65b9\u6cd5\uff0c\u8fd9\u4e9b\u65b9\u6cd5\u5176\u5b9e\u662f\u81ea Laravel 9 \u5f00\u59cb\u88ab\u9646\u9646\u7eed\u7eed\u6dfb\u52a0\u5230 InteractsWithInput<\/code> \u4e2d\u3002\u8fd9\u4e9b\u65b9\u6cd5\u4f1a\u5c06\u63a5\u6536\u5230\u7684\u53c2\u6570\u7ecf\u8fc7\u8f6c\u6362\uff0c\u7136\u540e\u8fd4\u56de\u9884\u5b9a\u7684\u7c7b\u578b\uff0c\u6211\u4eec\u4fbf\u53ef\u4ee5\u5728 Request<\/code> \u4e0a\u4f7f\u7528 integer<\/code>\/bool<\/code> \u7b49\u65b9\u6cd5\u6765\u63a5\u6536\u8bf7\u6c42\u53c2\u6570\u3002<\/p>\n
\u56e0\u4e3a PHPStan \u5e76\u4e0d\u68c0\u67e5 vendor<\/code> \u91cc\u9762\u7684\u5b9e\u73b0\uff0c\u6240\u4ee5\uff0c\u5f53\u8fd9\u4e9b\u65b9\u6cd5\u7684\u7b7e\u540d\uff08\u6216\u8005\u5b58\u6839\u6587\u4ef6\uff09\u4e2d\u58f0\u660e\u4e86\u5c06\u4f1a\u8fd4\u56de\u9884\u5b9a\u7684\u7c7b\u578b\uff0c\u90a3\u4e48 PHPStan \u5c31\u4f1a\u9009\u62e9\u4fe1\u4efb\u3002\u81f3\u6b64\uff0c\u8fd9\u4e9b\u9519\u8bef\u5c06\u6d88\u5931\uff0c\u540c\u65f6\u6211\u4eec\u83b7\u5f97\u4e86\u7c7b\u578b\u5b89\u5168\u7684\u6570\u636e\u3002\u6ce8\u610f\uff0c\u8fd9\u91cc\u6846\u67b6\u5185\u90e8\u5e76\u6ca1\u6709\u6b3a\u9a97 PHPStan\uff0c\u800c\u662f\u786e\u786e\u5b9e\u5b9e\u5730\u5bf9\u6570\u636e\u8fdb\u884c\u4e86\u8f6c\u6362\uff0c\u53ea\u662f\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\uff0c\u8fd9\u4e9b\u8f6c\u6362\u53ef\u80fd\u4e0d\u7b26\u5408\u6211\u4eec\u7684\u9884\u671f\u3002<\/p>\n
\u540c\u65f6\uff0c\u4e5f\u610f\u5473\u7740\u6211\u4eec\u5728\u4f7f\u7528\u65f6\u4e5f\u8981\u6ce8\u610f\uff0c\u56e0\u4e3a\u5927\u591a\u6570\u65b9\u6cd5\uff0c\u5b83\u5176\u5b9e\u5c31\u662f\u4f7f\u7528\u7684\u5f3a\u5236\u7c7b\u578b\u8f6c\u6362\uff0c\u6bd4\u5982\u5728\u4e00\u4e9b\u4e3a null<\/code> \u7684\u5b57\u6bb5\uff0c\u53ef\u80fd\u63a5\u6536\u5230\u7684\u5c31\u4e0d\u7b26\u5408\u9884\u671f\u4e86\u3002\u8fd9\u65f6\u5019\u53ef\u4ee5\u4f7f\u7528 blank<\/code> \u6216\u8005 filled<\/code> \u65b9\u6cd5\u6765\u68c0\u67e5\u3002<\/p>\n
\u81f3\u6b64\uff0c\u8fd9\u7bc7\u6587\u7ae0\u5df2\u7ecf\u63a5\u8fd1\u4e86\u5c3e\u58f0\uff0c\u6211\u4eec\u73b0\u5728\u77e5\u9053 Fluent<\/code> \u7c7b\u4f7f\u7528\u4e86 InteractsWithData<\/code> \u6240\u4ee5\u652f\u6301\u8fd9\u91cc\u9762\u6240\u6709\u7684\u65b9\u6cd5\uff0c\u4ee5\u53ca\u672a\u6765\u53ef\u80fd\u7684\u65b9\u6cd5\u3002<\/p>\n
\u800c\u5728 Laravel 11 \u4e4b\u540e\uff0c\u5728\u5176\u5185\u90e8\u4e5f\u6709\u8bb8\u591a\u5e94\u7528\uff1a<\/p>\n