{"id":46716,"date":"2024-12-02T15:55:39","date_gmt":"2024-12-02T07:55:39","guid":{"rendered":"https:\/\/fwq.ai\/blog\/46716\/"},"modified":"2024-12-02T15:55:39","modified_gmt":"2024-12-02T07:55:39","slug":"%e5%a6%82%e4%bd%95%e4%bd%bf%e7%94%a8php%e7%9a%84phpdoc%e5%ae%9e%e7%8e%b0%e5%8f%82%e6%95%b0%e7%b1%bb%e5%9e%8b%e6%a3%80%e6%9f%a5%ef%bc%9f","status":"publish","type":"post","link":"https:\/\/fwq.ai\/blog\/46716\/","title":{"rendered":"\u5982\u4f55\u4f7f\u7528PHP\u7684PHPDoc\u5b9e\u73b0\u53c2\u6570\u7c7b\u578b\u68c0\u67e5\uff1f"},"content":{"rendered":"

<\/b> <\/p>\n

\u5982\u4f55\u4f7f\u7528PHP\u7684PHPDoc\u5b9e\u73b0\u53c2\u6570\u7c7b\u578b\u68c0\u67e5\uff1f<\/h1>\n

\u5927\u5bb6\u597d\uff0c\u6211\u4eec\u53c8\u89c1\u9762\u4e86\u554a~\u672c\u6587\u300a\u5982\u4f55\u4f7f\u7528PHP\u7684PHPDoc\u5b9e\u73b0\u53c2\u6570\u7c7b\u578b\u68c0\u67e5\uff1f\u300b<\/span>\u7684\u5185\u5bb9\u4e2d\u5c06\u4f1a\u6d89\u53ca\u5230<\/span>\u7b49\u7b49\u3002\u5982\u679c\u4f60\u6b63\u5728\u5b66\u4e60\u6587\u7ae0<\/span>\u76f8\u5173\u77e5\u8bc6\uff0c\u6b22\u8fce\u5173\u6ce8\u6211\uff0c\u4ee5\u540e\u4f1a\u7ed9\u5927\u5bb6\u5e26\u6765\u66f4\u591a\u6587\u7ae0<\/span>\u76f8\u5173\u6587\u7ae0\uff0c\u5e0c\u671b\u6211\u4eec\u80fd\u4e00\u8d77\u8fdb\u6b65\uff01\u4e0b\u9762\u5c31\u5f00\u59cb\u672c\u6587\u7684\u6b63\u5f0f\u5185\u5bb9~<\/p>\n

\"\u5982\u4f55\u4f7f\u7528PHP\u7684PHPDoc\u5b9e\u73b0\u53c2\u6570\u7c7b\u578b\u68c0\u67e5\uff1f\u63d2\u56fe\"<\/p>\n

\u5982\u4f55\u4f7f\u7528 PHP \u7684 PHPDoc \u5b9e\u73b0\u53c2\u6570\u7c7b\u578b\u68c0\u67e5<\/strong><\/p>\n

PHPDoc \u662f\u4e00\u79cd\u4ee3\u7801\u6ce8\u91ca\u8bed\u6cd5\uff0c\u53ef\u8ba9\u60a8\u5411\u60a8\u7684 PHP \u4ee3\u7801\u6dfb\u52a0\u5143\u6570\u636e\uff0c\u4ee5\u4f7f\u5f00\u53d1\u4eba\u5458\u548c\u5de5\u5177\u66f4\u597d\u5730\u7406\u89e3\u5176\u7528\u9014\u548c\u884c\u4e3a\u3002\u5b83\u5141\u8bb8\u60a8\u6307\u5b9a\u51fd\u6570\u548c\u65b9\u6cd5\u7684\u53c2\u6570\u7c7b\u578b\uff0c\u4ee5\u4fbf\u5728\u8fd0\u884c\u65f6\u8fdb\u884c\u7c7b\u578b\u68c0\u67e5\u3002<\/p>\n

\u7c7b\u578b\u6ce8\u91ca<\/strong><\/p>\n

\u8981\u6307\u5b9a\u53c2\u6570\u7c7b\u578b\uff0c\u8bf7\u5728\u7c7b\u578b\u540e\u8ddf\u5192\u53f7 (:)\uff0c\u7136\u540e\u662f\u7c7b\u578b\u540d\u79f0\u3002\u4f8b\u5982\uff0c\u8981\u6307\u5b9a foo()<\/code> \u51fd\u6570\u63a5\u53d7\u6574\u6570\u7c7b\u578b\u7684\u53c2\u6570\uff0c\u53ef\u4ee5\u8fd9\u6837\u5199\uff1a<\/p>\n

\/**\n * @param int $number\n *\/\nfunction foo($number)\n{\n    \/\/ $number \u4e3a int \u7c7b\u578b\n}<\/pre>\n
\u652f\u6301\u7684\u7c7b\u578b<\/strong><\/p>\n
PHPDoc \u652f\u6301\u4ee5\u4e0b\u7c7b\u578b\u6ce8\u91ca\uff1a<\/p>\n
    \n
  • int<\/code><\/li>\n
  • float<\/code><\/li>\n
  • string<\/code><\/li>\n
  • boolean<\/code><\/li>\n
  • array<\/code><\/li>\n
  • object<\/code><\/li>\n
  • callable<\/code><\/li>\n
  • null<\/code><\/li>\n
  • mixed<\/code> (\u8868\u793a\u4efb\u4f55\u7c7b\u578b)<\/li>\n<\/ul>\n
    \u5b9e\u6218\u6848\u4f8b<\/strong><\/p>\n
    \u8ba9\u6211\u4eec\u7f16\u5199\u4e00\u4e2a add()<\/code> \u51fd\u6570\uff0c\u5b83\u63a5\u53d7\u4e24\u4e2a\u6574\u6570\u53c2\u6570\u5e76\u8fd4\u56de\u5b83\u4eec\u7684\u548c\u3002<\/p>\n
    \/**\n * @param int $number1\n * @param int $number2\n * @return int\n *\/\nfunction add($number1, $number2)\n{\n    return $number1 + $number2;\n}\n\n\/\/ \u8c03\u7528\u51fd\u6570\n$result = add(10, 20);\n\n\/\/ $result \u4e3a int \u7c7b\u578b\uff0820\uff09<\/pre>\n
    \u5de5\u5177\u652f\u6301<\/strong><\/p>\n
    IDE \u548c\u4ee3\u7801\u5206\u6790\u5de5\u5177\uff0c\u5982 PHPStan \u548c Psalm\uff0c\u5229\u7528 PHPDoc \u6ce8\u91ca\u8fdb\u884c\u9759\u6001\u5206\u6790\u3002\u8fd9\u610f\u5473\u7740\u5b83\u4eec\u53ef\u4ee5\u8bc6\u522b\u7c7b\u578b\u9519\u8bef\u5e76\u5728\u7f16\u8bd1\u65f6\u53d1\u51fa\u8b66\u544a\uff0c\u4ece\u800c\u5e2e\u52a9\u60a8\u7f16\u5199\u66f4\u5065\u58ee\u7684\u4ee3\u7801\u3002<\/p>\n
    \u6ce8\u610f\uff1a<\/strong><\/p>\n
      \n
    • PHPDoc \u6ce8\u91ca\u4ec5\u7528\u4e8e\u6587\u6863\u548c\u7c7b\u578b\u68c0\u67e5\u3002\u5b83\u4eec\u4e0d\u4f1a\u5728\u8fd0\u884c\u65f6\u5f3a\u5236\u6267\u884c\u7c7b\u578b\u3002<\/li>\n
    • \u5982\u679c\u60a8\u5728\u4ee3\u7801\u4e2d\u6307\u5b9a\u4e86\u4e0d\u6b63\u786e\u7684\u7c7b\u578b\uff0c\u60a8\u4ecd\u7136\u53ef\u4ee5\u7f16\u8bd1\u5e76\u8fd0\u884c\u7a0b\u5e8f\uff0c\u4f46\u53ef\u80fd\u4f1a\u5bfc\u81f4\u610f\u5916\u7684\u884c\u4e3a\u3002<\/li>\n
    • PHPDoc \u5bf9\u4e8e\u7406\u89e3\u4ee3\u7801\u7ed3\u6784\u548c\u9884\u671f\u884c\u4e3a\u975e\u5e38\u6709\u5e2e\u52a9\uff0c\u4f46\u5b83\u65e0\u6cd5\u53d6\u4ee3\u5355\u5143\u6d4b\u8bd5\u3002<\/li>\n<\/ul>\n
      \u7ec8\u4e8e\u4ecb\u7ecd\u5b8c\u5566\uff01\u5c0f\u4f19\u4f34\u4eec\uff0c\u8fd9\u7bc7\u5173\u4e8e\u300a\u5982\u4f55\u4f7f\u7528PHP\u7684PHPDoc\u5b9e\u73b0\u53c2\u6570\u7c7b\u578b\u68c0\u67e5\uff1f\u300b\u7684\u4ecb\u7ecd\u5e94\u8be5\u8ba9\u4f60\u6536\u83b7\u591a\u591a\u4e86\u5427\uff01\u6b22\u8fce\u5927\u5bb6\u6536\u85cf\u6216\u5206\u4eab\u7ed9\u66f4\u591a\u9700\u8981\u5b66\u4e60\u7684\u670b\u53cb\u5427~\u7c73\u4e91\u516c\u4f17\u53f7\u4e5f\u4f1a\u53d1\u5e03\u6587\u7ae0\u76f8\u5173\u77e5\u8bc6\uff0c\u5feb\u6765\u5173\u6ce8\u5427\uff01<\/p>\n","protected":false},"excerpt":{"rendered":"
      \u5982\u4f55\u4f7f\u7528PHP\u7684PHPDoc\u5b9e\u73b0\u53c2\u6570\u7c7b\u578b\u68c0\u67e5\uff1f \u5927\u5bb6\u597d\uff0c\u6211\u4eec\u53c8\u89c1\u9762\u4e86\u554a~\u672c\u6587\u300a\u5982\u4f55\u4f7f\u7528PHP\u7684PHPDoc\u5b9e\u73b0\u53c2\u6570\u7c7b\u578b\u68c0\u67e5\uff1f\u300b\u7684\u5185\u5bb9\u4e2d\u5c06\u4f1a\u6d89\u53ca\u5230\u7b49\u7b49\u3002\u5982\u679c\u4f60\u6b63\u5728\u5b66\u4e60\u6587\u7ae0\u76f8\u5173\u77e5\u8bc6\uff0c\u6b22\u8fce\u5173\u6ce8\u6211\uff0c\u4ee5\u540e\u4f1a\u7ed9\u5927\u5bb6\u5e26\u6765\u66f4\u591a\u6587\u7ae0\u76f8\u5173\u6587\u7ae0\uff0c\u5e0c\u671b\u6211\u4eec\u80fd\u4e00\u8d77\u8fdb\u6b65\uff01\u4e0b\u9762\u5c31\u5f00\u59cb\u672c\u6587\u7684\u6b63\u5f0f\u5185\u5bb9~ \u5982\u4f55\u4f7f\u7528 PHP \u7684 PHPDoc \u5b9e\u73b0\u53c2\u6570\u7c7b\u578b\u68c0\u67e5 PHPDoc \u662f\u4e00\u79cd\u4ee3\u7801\u6ce8\u91ca\u8bed\u6cd5\uff0c\u53ef\u8ba9\u60a8\u5411\u60a8\u7684 PHP \u4ee3\u7801\u6dfb\u52a0\u5143\u6570\u636e\uff0c\u4ee5\u4f7f\u5f00\u53d1\u4eba\u5458\u548c\u5de5\u5177\u66f4\u597d\u5730\u7406\u89e3\u5176\u7528\u9014\u548c\u884c\u4e3a\u3002\u5b83\u5141\u8bb8\u60a8\u6307\u5b9a\u51fd\u6570\u548c\u65b9\u6cd5\u7684\u53c2\u6570\u7c7b\u578b\uff0c\u4ee5\u4fbf\u5728\u8fd0\u884c\u65f6\u8fdb\u884c\u7c7b\u578b\u68c0\u67e5\u3002 \u7c7b\u578b\u6ce8\u91ca \u8981\u6307\u5b9a\u53c2\u6570\u7c7b\u578b\uff0c\u8bf7\u5728\u7c7b\u578b\u540e\u8ddf\u5192\u53f7 (:)\uff0c\u7136\u540e\u662f\u7c7b\u578b\u540d\u79f0\u3002\u4f8b\u5982\uff0c\u8981\u6307\u5b9a foo() \u51fd\u6570\u63a5\u53d7\u6574\u6570\u7c7b\u578b\u7684\u53c2\u6570\uff0c\u53ef\u4ee5\u8fd9\u6837\u5199\uff1a \/** * @param int $number *\/ function foo($number) { \/\/ $number \u4e3a int \u7c7b\u578b } \u652f\u6301\u7684\u7c7b\u578b PHPDoc \u652f\u6301\u4ee5\u4e0b\u7c7b\u578b\u6ce8\u91ca\uff1a int float string boolean array object callable null mixed (\u8868\u793a\u4efb\u4f55\u7c7b\u578b) \u5b9e\u6218\u6848\u4f8b \u8ba9\u6211\u4eec\u7f16\u5199\u4e00\u4e2a add() \u51fd\u6570\uff0c\u5b83\u63a5\u53d7\u4e24\u4e2a\u6574\u6570\u53c2\u6570\u5e76\u8fd4\u56de\u5b83\u4eec\u7684\u548c\u3002 \/** * @param int $number1 * @param […]<\/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-46716","post","type-post","status-publish","format-standard","hentry","category-16"],"_links":{"self":[{"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/posts\/46716","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=46716"}],"version-history":[{"count":0,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/posts\/46716\/revisions"}],"wp:attachment":[{"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/media?parent=46716"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/categories?post=46716"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fwq.ai\/blog\/wp-json\/wp\/v2\/tags?post=46716"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}