{"id":24750,"date":"2024-11-21T17:00:21","date_gmt":"2024-11-21T09:00:21","guid":{"rendered":"https:\/\/fwq.ai\/blog\/24750\/"},"modified":"2024-11-21T17:00:21","modified_gmt":"2024-11-21T09:00:21","slug":"%e5%a6%82%e4%bd%95%e4%bd%bf%e7%94%a8hyperf%e6%a1%86%e6%9e%b6%e8%bf%9b%e8%a1%8capi%e6%8e%a5%e5%8f%a3%e5%bc%80%e5%8f%91","status":"publish","type":"post","link":"https:\/\/fwq.ai\/blog\/24750\/","title":{"rendered":"\u5982\u4f55\u4f7f\u7528Hyperf\u6846\u67b6\u8fdb\u884cAPI\u63a5\u53e3\u5f00\u53d1"},"content":{"rendered":"<p><img decoding=\"async\" src=\"https:\/\/img.php.cn\/upload\/article\/000\/887\/227\/169785454935603.jpg\" class=\"aligncenter\" title=\"\u5982\u4f55\u4f7f\u7528Hyperf\u6846\u67b6\u8fdb\u884cAPI\u63a5\u53e3\u5f00\u53d1\u63d2\u56fe\" alt=\"\u5982\u4f55\u4f7f\u7528Hyperf\u6846\u67b6\u8fdb\u884cAPI\u63a5\u53e3\u5f00\u53d1\u63d2\u56fe\" \/><\/p>\n<p>\u5982\u4f55\u4f7f\u7528Hyperf\u6846\u67b6\u8fdb\u884cAPI\u63a5\u53e3\u5f00\u53d1<\/p>\n<ol>\n<li>\u524d\u8a00<br \/>\u5728\u5f53\u524d\u7684Web\u5f00\u53d1\u4e2d\uff0cAPI\u63a5\u53e3\u5df2\u7ecf\u6210\u4e3a\u4e86\u4e0d\u53ef\u6216\u7f3a\u7684\u4e00\u90e8\u5206\u3002Hyperf\u662f\u4e00\u4e2a\u57fa\u4e8eSwoole\u4e0ePHP\u534f\u7a0b\u7684\u9ad8\u6027\u80fd\u6846\u67b6\uff0c\u5b83\u63d0\u4f9b\u4e86\u5404\u79cd\u5de5\u5177\u548c\u7ec4\u4ef6\uff0c\u65b9\u4fbf\u5f00\u53d1\u8005\u5feb\u901f\u6784\u5efa\u9ad8\u6027\u80fd\u7684API\u63a5\u53e3\u3002\u672c\u6587\u5c06\u4ecb\u7ecd\u5982\u4f55\u4f7f\u7528Hyperf\u6846\u67b6\u8fdb\u884cAPI\u63a5\u53e3\u5f00\u53d1\uff0c\u5e76\u63d0\u4f9b\u5177\u4f53\u7684\u4ee3\u7801\u793a\u4f8b\u3002<\/li>\n<li>\n<p>\u73af\u5883\u642d\u5efa<br \/>\u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u5728\u672c\u5730\u73af\u5883\u4e2d\u642d\u5efaHyperf\u6846\u67b6\u7684\u5f00\u53d1\u73af\u5883\u3002\u53ef\u4ee5\u4f7f\u7528Composer\u5de5\u5177\uff0c\u5728\u7ec8\u7aef\u4e2d\u8fd0\u884c\u4ee5\u4e0b\u547d\u4ee4\u6765\u521b\u5efa\u4e00\u4e2aHyperf\u9879\u76ee\uff1a<\/p>\n<pre>composer create-project hyperf\/hyperf hyperf-demo<\/pre>\n<p>  \u767b\u5f55\u540e\u590d\u5236   <\/li>\n<li>\n<p>\u521b\u5efaAPI\u63a7\u5236\u5668<br \/>\u5728Hyperf\u6846\u67b6\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u521b\u5efa\u63a7\u5236\u5668\u6765\u5b9a\u4e49API\u63a5\u53e3\u3002\u5728\u7ec8\u7aef\u4e2d\uff0c\u5207\u6362\u5230\u9879\u76ee\u6839\u76ee\u5f55\u5e76\u6267\u884c\u4ee5\u4e0b\u547d\u4ee4\u6765\u521b\u5efa\u4e00\u4e2aAPI\u63a7\u5236\u5668\uff1a<\/p>\n<pre>php bin\/hyperf.php make:controller User<\/pre>\n<p>  \u767b\u5f55\u540e\u590d\u5236   <\/p>\n<p>\u8fd9\u5c06\u5728App\/Controller\u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u540d\u4e3aUserController\u7684\u63a7\u5236\u5668\u6587\u4ef6\u3002<\/p>\n<\/li>\n<li>\n<p>\u5b9a\u4e49API\u63a5\u53e3\u65b9\u6cd5<br \/>\u5728UserController\u63a7\u5236\u5668\u6587\u4ef6\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u65b9\u6cd5\u6765\u5904\u7406\u4e0d\u540c\u7684API\u63a5\u53e3\u3002\u4f8b\u5982\uff0c\u6211\u4eec\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3agetUser\u7684\u65b9\u6cd5\uff0c\u7528\u4e8e\u83b7\u53d6\u7528\u6237\u4fe1\u606f\u3002\u65b9\u6cd5\u7684\u4ee3\u7801\u793a\u4f8b\u5982\u4e0b\uff1a<\/p>\n<pre>&lt;?php declare(strict_types=1);\n\nnamespace AppController;\n\nuse HyperfHttpServerAnnotationController;\nuse HyperfHttpServerAnnotationGetMapping;\n\n\/**\n * @Controller(prefix=\"\/user\")\n *\/\nclass UserController\n{\n \/**\n  * @GetMapping(path=\"get\")\n  *\/\n public function getUser(): array\n {\n     return [\n         'id' =&gt; 1,\n         'name' =&amp;gt; 'John Doe',\n         'email' =&amp;gt; 'john.doe@example.com',\n     ];\n }\n}<\/pre>\n<p>  \u767b\u5f55\u540e\u590d\u5236   <\/p>\n<p>\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u4e86Controller\u548cGetMapping\u6ce8\u89e3\u6765\u6807\u8bc6\u63a7\u5236\u5668\u548c\u65b9\u6cd5\u3002GetMapping\u6ce8\u89e3\u5b9a\u4e49\u4e86API\u63a5\u53e3\u7684\u8bf7\u6c42\u65b9\u5f0f\u548c\u8def\u5f84\u3002<\/p>\n<\/li>\n<li>\n<p>\u542f\u52a8Hyperf\u670d\u52a1<br \/>\u5728\u7ec8\u7aef\u4e2d\uff0c\u5207\u6362\u5230\u9879\u76ee\u6839\u76ee\u5f55\u5e76\u6267\u884c\u4ee5\u4e0b\u547d\u4ee4\u6765\u542f\u52a8Hyperf\u670d\u52a1\uff1a<\/p>\n<pre>php bin\/hyperf.php start<\/pre>\n<p>  \u767b\u5f55\u540e\u590d\u5236   <\/p>\n<p>\u542f\u52a8\u6210\u529f\u540e\uff0cHyperf\u5c06\u76d1\u542c\u5728http:\/\/127.0.0.1:9501\u5730\u5740\u4e0a\u3002<\/p>\n<\/li>\n<li>\u6d4b\u8bd5API\u63a5\u53e3<br \/>\u4f7f\u7528\u4efb\u610f\u7684API\u6d4b\u8bd5\u5de5\u5177\uff0c\u5982Postman\u6216curl\u547d\u4ee4\uff0c\u53d1\u9001GET\u8bf7\u6c42\u5230http:\/\/127.0.0.1:9501\/user\/get\u5730\u5740\uff0c\u5373\u53ef\u83b7\u53d6\u7528\u6237\u4fe1\u606f\u3002<\/li>\n<li>\u63a5\u53e3\u9a8c\u8bc1\u4e0e\u5f02\u5e38\u5904\u7406<br \/>\u5728\u5b9e\u9645\u5f00\u53d1\u4e2d\uff0c\u6211\u4eec\u7ecf\u5e38\u9700\u8981\u5bf9API\u63a5\u53e3\u8fdb\u884c\u9a8c\u8bc1\u548c\u5f02\u5e38\u5904\u7406\u3002Hyperf\u6846\u67b6\u63d0\u4f9b\u4e86\u4e30\u5bcc\u7684\u9a8c\u8bc1\u548c\u5f02\u5e38\u5904\u7406\u5de5\u5177\uff0c\u53ef\u4ee5\u8f7b\u677e\u5b9e\u73b0\u8fd9\u4e9b\u529f\u80fd\u3002<\/li>\n<\/ol>\n<p>\u4f8b\u5982\uff0c\u6211\u4eec\u53ef\u4ee5\u5728getUser\u65b9\u6cd5\u4e2d\u589e\u52a0\u53c2\u6570\u9a8c\u8bc1\u548c\u5f02\u5e38\u629b\u51fa\u7684\u4ee3\u7801\uff1a<\/p>\n<pre>&lt;?php declare(strict_types=1);\n\nnamespace AppController;\n\nuse HyperfHttpServerAnnotationController;\nuse HyperfHttpServerAnnotationGetMapping;\nuse AppRequestUserRequest;\nuse HyperfDiAnnotationInject;\nuse HyperfValidationContractValidatorFactoryInterface;\n\n\/**\n * @Controller(prefix=\"\/user\")\n *\/\nclass UserController\n{\n    \/**\n     * @Inject\n     * @var ValidatorFactoryInterface\n     *\/\n    protected $validationFactory;\n\n    \/**\n     * @GetMapping(path=\"get\")\n     *\/\n    public function getUser(UserRequest $request): array\n    {\n        $validator = $this-&gt;validationFactory-&amp;gt;make($request-&amp;gt;all(), $request-&amp;gt;rules());\n\n        if ($validator-&amp;gt;fails()) {\n            throw new InvalidArgumentException($validator-&amp;gt;errors()-&amp;gt;first());\n        }\n\n        return [\n            'id' =&amp;gt; 1,\n            'name' =&amp;gt; 'John Doe',\n            'email' =&amp;gt; 'john.doe@example.com',\n        ];\n    }\n}<\/pre>\n<p>  \u767b\u5f55\u540e\u590d\u5236   <\/p>\n<p>\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u4e86UserRequest\u7c7b\u6765\u5b9a\u4e49\u7528\u6237\u8bf7\u6c42\u53c2\u6570\u7684\u9a8c\u8bc1\u89c4\u5219\u3002\u901a\u8fc7\u4f9d\u8d56\u6ce8\u5165\u83b7\u53d6\u5230ValidatorFactoryInterface\u63a5\u53e3\uff0c\u5e76\u4f7f\u7528\u5176make\u65b9\u6cd5\u521b\u5efa\u9a8c\u8bc1\u5668\u3002\u5982\u679c\u9a8c\u8bc1\u5931\u8d25\uff0c\u6211\u4eec\u629b\u51fa\u4e86\u4e00\u4e2aInvalidArgumentException\u5f02\u5e38\u3002<\/p>\n<ol>\n<li>\u7ed3\u8bed<br \/>\u901a\u8fc7\u672c\u6587\u7684\u4ecb\u7ecd\uff0c\u6211\u4eec\u4e86\u89e3\u4e86\u5982\u4f55\u4f7f\u7528Hyperf\u6846\u67b6\u8fdb\u884cAPI\u63a5\u53e3\u5f00\u53d1\uff0c\u5e76\u63d0\u4f9b\u4e86\u5177\u4f53\u7684\u4ee3\u7801\u793a\u4f8b\u3002Hyperf\u6846\u67b6\u63d0\u4f9b\u4e86\u4e30\u5bcc\u7684\u5de5\u5177\u548c\u7ec4\u4ef6\uff0c\u53ef\u4ee5\u5e2e\u52a9\u5f00\u53d1\u8005\u5feb\u901f\u6784\u5efa\u9ad8\u6027\u80fd\u7684API\u63a5\u53e3\u3002\u5e0c\u671b\u672c\u6587\u5bf9\u60a8\u5728API\u63a5\u53e3\u5f00\u53d1\u4e2d\u6709\u6240\u5e2e\u52a9\u3002<\/li>\n<\/ol>\n<p>\u4ee5\u4e0a\u5c31\u662f\u5982\u4f55\u4f7f\u7528Hyperf\u6846\u67b6\u8fdb\u884cAPI\u63a5\u53e3\u5f00\u53d1\u7684\u8be6\u7ec6\u5185\u5bb9\uff0c\u66f4\u591a\u8bf7\u5173\u6ce8\u7c73\u4e91\u5176\u5b83\u76f8\u5173\u6587\u7ae0\uff01<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u5982\u4f55\u4f7f\u7528Hyperf\u6846\u67b6\u8fdb\u884cAPI\u63a5\u53e3\u5f00\u53d1 \u524d\u8a00\u5728\u5f53\u524d\u7684Web\u5f00\u53d1\u4e2d\uff0cAPI\u63a5\u53e3\u5df2\u7ecf\u6210\u4e3a\u4e86\u4e0d\u53ef\u6216\u7f3a\u7684\u4e00\u90e8\u5206\u3002Hyperf\u662f\u4e00\u4e2a\u57fa\u4e8eSwoole\u4e0ePHP\u534f\u7a0b\u7684\u9ad8\u6027\u80fd\u6846\u67b6\uff0c\u5b83\u63d0\u4f9b\u4e86\u5404\u79cd\u5de5\u5177\u548c\u7ec4\u4ef6\uff0c\u65b9\u4fbf\u5f00\u53d1\u8005\u5feb\u901f\u6784\u5efa\u9ad8\u6027\u80fd\u7684API\u63a5\u53e3\u3002\u672c\u6587\u5c06\u4ecb\u7ecd\u5982\u4f55\u4f7f\u7528Hyperf\u6846\u67b6\u8fdb\u884cAPI\u63a5\u53e3\u5f00\u53d1\uff0c\u5e76\u63d0\u4f9b\u5177\u4f53\u7684\u4ee3\u7801\u793a\u4f8b\u3002 \u73af\u5883\u642d\u5efa\u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u5728\u672c\u5730\u73af\u5883\u4e2d\u642d\u5efaHyperf\u6846\u67b6\u7684\u5f00\u53d1\u73af\u5883\u3002\u53ef\u4ee5\u4f7f\u7528Composer\u5de5\u5177\uff0c\u5728\u7ec8\u7aef\u4e2d\u8fd0\u884c\u4ee5\u4e0b\u547d\u4ee4\u6765\u521b\u5efa\u4e00\u4e2aHyperf\u9879\u76ee\uff1a composer create-project hyperf\/hyperf hyperf-demo \u767b\u5f55\u540e\u590d\u5236 \u521b\u5efaAPI\u63a7\u5236\u5668\u5728Hyperf\u6846\u67b6\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u521b\u5efa\u63a7\u5236\u5668\u6765\u5b9a\u4e49API\u63a5\u53e3\u3002\u5728\u7ec8\u7aef\u4e2d\uff0c\u5207\u6362\u5230\u9879\u76ee\u6839\u76ee\u5f55\u5e76\u6267\u884c\u4ee5\u4e0b\u547d\u4ee4\u6765\u521b\u5efa\u4e00\u4e2aAPI\u63a7\u5236\u5668\uff1a php bin\/hyperf.php make:controller User \u767b\u5f55\u540e\u590d\u5236 \u8fd9\u5c06\u5728App\/Controller\u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u540d\u4e3aUserController\u7684\u63a7\u5236\u5668\u6587\u4ef6\u3002 \u5b9a\u4e49API\u63a5\u53e3\u65b9\u6cd5\u5728UserController\u63a7\u5236\u5668\u6587\u4ef6\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u65b9\u6cd5\u6765\u5904\u7406\u4e0d\u540c\u7684API\u63a5\u53e3\u3002\u4f8b\u5982\uff0c\u6211\u4eec\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3agetUser\u7684\u65b9\u6cd5\uff0c\u7528\u4e8e\u83b7\u53d6\u7528\u6237\u4fe1\u606f\u3002\u65b9\u6cd5\u7684\u4ee3\u7801\u793a\u4f8b\u5982\u4e0b\uff1a &lt;?php declare(strict_types=1); namespace AppController; use HyperfHttpServerAnnotationController; use HyperfHttpServerAnnotationGetMapping; \/** * @Controller(prefix=&#8221;\/user&#8221;) *\/ class UserController { \/** * @GetMapping(path=&#8221;get&#8221;) *\/ public function getUser(): array { return [ &#8216;id&#8217; =&gt; 1, &#8216;name&#8217; =&amp;gt; &#8216;John Doe&#8217;, &#8217;email&#8217; =&amp;gt; &#8216;john.doe@example.com&#8217;, ]; } } [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[16],"tags":[],"class_list":["post-24750","post","type-post","status-publish","format-standard","hentry","category-16"],"_links":{"self":[{"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/posts\/24750","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/comments?post=24750"}],"version-history":[{"count":0,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/posts\/24750\/revisions"}],"wp:attachment":[{"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/media?parent=24750"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/categories?post=24750"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/tags?post=24750"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}