{"id":1411,"date":"2025-12-16T22:15:20","date_gmt":"2025-12-16T14:15:20","guid":{"rendered":"http:\/\/www.preluna.xyz\/?p=1411"},"modified":"2025-12-16T22:15:21","modified_gmt":"2025-12-16T14:15:21","slug":"%e5%8e%86%e5%8f%b2%e9%81%97%e7%95%99%e4%bb%a3%e7%a0%81%e9%87%8d%e6%9e%84%e9%80%9a%e7%94%a8%e6%96%b9%e6%b3%95%e8%ae%ba","status":"publish","type":"post","link":"http:\/\/www.preluna.xyz\/index.php\/2025\/12\/16\/%e5%8e%86%e5%8f%b2%e9%81%97%e7%95%99%e4%bb%a3%e7%a0%81%e9%87%8d%e6%9e%84%e9%80%9a%e7%94%a8%e6%96%b9%e6%b3%95%e8%ae%ba\/preluna\/text\/","title":{"rendered":"\u5386\u53f2\u9057\u7559\u4ee3\u7801\u91cd\u6784\u901a\u7528\u65b9\u6cd5\u8bba"},"content":{"rendered":"\n

\u6838\u5fc3\u91cd\u6784\u6d41\u7a0b\uff08\u4e03\u6b65\u6cd5\uff09<\/h2>\n\n\n\n

\u7b2c\u4e00\u6b65\uff1a\u53d1\u73b0\u4e0e\u8bc6\u522b\u9636\u6bb5<\/strong><\/h3>\n\n\n\n
\/\/ 1. \u4f7f\u7528\u641c\u7d22\u5de5\u5177\u5b9a\u4f4d\u91cd\u590d\u65b9\u6cd5\n\/\/ IDE\u641c\u7d22: \"function get_xxx\" \u6216 \"->get_xxx(\"\n\/\/ \u547d\u4ee4\u884c: grep -r \"function get_\" .\n\n\/\/ 2. \u8bb0\u5f55\u6240\u6709\u53d1\u73b0\n\/\/ \u521b\u5efa\u91cd\u6784\u6e05\u5355\uff1a\n\/\/ | \u65b9\u6cd5\u540d | \u5b9a\u4e49\u4f4d\u7f6e | \u8c03\u7528\u4f4d\u7f6e | \u5b9e\u73b0\u5dee\u5f02 |<\/code><\/pre>\n\n\n\n
\u7b2c\u4e8c\u6b65\uff1a\u6df1\u5ea6\u5206\u6790\u9636\u6bb5<\/strong><\/h3>\n\n\n\n
\u5206\u6790\u7ef4\u5ea6\u68c0\u67e5\u8868\uff1a<\/strong><\/p>\n\n\n\n
    \n
  • \u529f\u80fd\u662f\u5426\u5b8c\u5168\u76f8\u540c\uff1f<\/li>\n\n\n\n
  • \u53c2\u6570\u7b7e\u540d\u662f\u5426\u4e00\u81f4\uff1f\uff08\u7c7b\u578b\u3001\u6570\u91cf\u3001\u987a\u5e8f\uff09<\/li>\n\n\n\n
  • \u8fd4\u56de\u503c\u662f\u5426\u4e00\u81f4\uff1f<\/li>\n\n\n\n
  • \u5f02\u5e38\u5904\u7406\u662f\u5426\u4e00\u81f4\uff1f<\/li>\n\n\n\n
  • \u4f9d\u8d56\u5173\u7cfb\u662f\u4ec0\u4e48\uff1f\uff08\u9700\u8981\u4ec0\u4e48\u4e0a\u4e0b\u6587\uff1f\uff09<\/li>\n\n\n\n
  • \u662f\u5426\u6709\u526f\u4f5c\u7528\uff1f\uff08\u4fee\u6539\u4e86\u54ea\u4e9b\u72b6\u6001\uff1f\uff09<\/li>\n<\/ul>\n\n\n\n
    \u7279\u522b\u5173\u6ce8\u53c2\u6570\u547d\u540d\uff1a<\/strong><\/p>\n\n\n\n
    \/\/ \u8bc6\u522b\u53c2\u6570\u547d\u540d\u6a21\u5f0f\uff1a\n\/\/ $user, $current_user, $wp_user, $user_object\n\/\/ $id, $user_id, $uid\n\/\/ $data, $params, $args\n\n\/\/ \u786e\u5b9a\u8bed\u4e49\u7b49\u4ef7\u6027\uff1a\n\/\/ $current_user \u2248 $user (\u5f53\u6765\u81ea wp_get_current_user())\n\/\/ $user_id \u2248 $id (\u5f53\u8868\u793a\u7528\u6237ID)<\/code><\/pre>\n\n\n\n
    \u7b2c\u4e09\u6b65\uff1a\u8bbe\u8ba1\u7edf\u4e00\u63a5\u53e3<\/strong><\/h3>\n\n\n\n
    \u8bbe\u8ba1\u539f\u5219\uff1a<\/strong><\/p>\n\n\n\n
    \/\/ \u539f\u52191\uff1a\u5411\u4e0b\u517c\u5bb9\npublic static function unified_method($param = null) {\n    \/\/ \u5904\u7406\u65e7\u7248\u6240\u6709\u8c03\u7528\u65b9\u5f0f\n}\n\n\/\/ \u539f\u52192\uff1a\u6e05\u6670\u6587\u6863\n\/**\n * \u7edf\u4e00\u65b9\u6cd5\u540d\n * \n * @param mixed $input \u652f\u6301\u591a\u79cd\u8f93\u5165\u683c\u5f0f\uff1a\n *                    - WP_User\u5bf9\u8c61\n *                    - \u7528\u6237ID (\u6574\u6570)\n *                    - null (\u4f7f\u7528\u5f53\u524d\u7528\u6237)\n *                    - \u5176\u4ed6\u5386\u53f2\u683c\u5f0f...\n * @return mixed \u660e\u786e\u8fd4\u56de\u503c\u7c7b\u578b\n * @throws \u660e\u786e\u5f02\u5e38\u7c7b\u578b\n *\/<\/code><\/pre>\n\n\n\n
    \u7b2c\u56db\u6b65\uff1a\u521b\u5efa\u7edf\u4e00\u5b9e\u73b0<\/strong><\/h3>\n\n\n\n
    \u677f\u793a\u4f8b\uff1a<\/strong><\/p>\n\n\n\n
    class Unified_Helper {\n    \/**\n     * \u7edf\u4e00\u65b9\u6cd5 - \u5904\u7406\u6240\u6709\u5386\u53f2\u8c03\u7528\n     * \n     * \u5386\u53f2\u8c03\u7528\u53ef\u80fd\u5305\u62ec\uff1a\n     * 1. SomeClass::old_method($user)\n     * 2. $this->old_method($current_user)\n     * 3. OtherClass::old_method($id)\n     *\/\n    public static function unified_method($input = null) {\n        \/\/ 1. \u53c2\u6570\u6807\u51c6\u5316\n        $standardized_input = self::standardize_input($input);\n        \n        \/\/ 2. \u4e1a\u52a1\u903b\u8f91\uff08\u539f\u591a\u4e2a\u65b9\u6cd5\u7684\u4ea4\u96c6\uff09\n        $result = self::core_logic($standardized_input);\n        \n        \/\/ 3. \u7ed3\u679c\u6807\u51c6\u5316\n        return self::standardize_output($result);\n    }\n    \n    private static function standardize_input($input) {\n        \/\/ \u5904\u7406\u6240\u6709\u5386\u53f2\u53c2\u6570\u683c\u5f0f\n        if (is_null($input)) {\n            return wp_get_current_user();\n        }\n        \n        if (is_numeric($input)) {\n            return get_user_by('id', $input);\n        }\n        \n        if ($input instanceof WP_User) {\n            return $input;\n        }\n        \n        \/\/ \u5176\u4ed6\u5386\u53f2\u683c\u5f0f...\n        throw new InvalidArgumentException('\u4e0d\u652f\u6301\u7684\u53c2\u6570\u683c\u5f0f');\n    }\n}<\/code><\/pre>\n\n\n\n
    \u7b2c\u4e94\u6b65\uff1a\u6e10\u8fdb\u5f0f\u66ff\u6362\u7b56\u7565<\/strong><\/h3>\n\n\n\n
    \u66ff\u6362\u987a\u5e8f\uff1a<\/strong><\/p>\n\n\n\n
    \/\/ \u9636\u6bb51\uff1a\u5148\u6dfb\u52a0\u7edf\u4e00\u65b9\u6cd5\uff0c\u4fdd\u6301\u65e7\u65b9\u6cd5\nclass Old_Class {\n    public function old_method($user) {\n        return Unified_Helper::unified_method($user);\n    }\n}\n\n\/\/ \u9636\u6bb52\uff1a\u4fee\u6539\u8c03\u7528\u70b9\uff08\u5206\u6279\u6b21\uff09\n\/\/ \u4f18\u5148\u7ea7\u987a\u5e8f\uff1a\n\/\/ 1. \u7b80\u5355\u8c03\u7528\uff08\u53c2\u6570\u660e\u786e\uff09\n\/\/ 2. \u5185\u90e8\u8c03\u7528\uff08\u540c\u4e00\u7c7b\u5185\uff09\n\/\/ 3. \u5916\u90e8\u8c03\u7528\uff08\u8de8\u7c7b\u8c03\u7528\uff09\n\n\/\/ \u9636\u6bb53\uff1a\u5220\u9664\u65e7\u65b9\u6cd5\uff08\u6807\u8bb0\u4e3a\u5f03\u7528\uff09\n\/**\n * @deprecated 3.0.0 \u4f7f\u7528 Unified_Helper::unified_method()\n *\/\npublic function old_method($user) {\n    _deprecated_function(__METHOD__, '3.0.0', 'Unified_Helper::unified_method');\n    return Unified_Helper::unified_method($user);\n}<\/code><\/pre>\n\n\n\n
    \u7b2c\u516d\u6b65\uff1a\u53d8\u91cf\u540d\u5904\u7406\u7b56\u7565<\/strong><\/h3>\n\n\n\n
    \u53d8\u91cf\u540d\u7edf\u4e00\u6307\u5357\uff1a<\/strong><\/p>\n\n\n\n
    \/\/ \u89c4\u52191\uff1a\u4e0a\u4e0b\u6587\u4f18\u5148\nfunction process_current_user() {\n    $current_user = wp_get_current_user(); \/\/ \u597d\uff1a\u660e\u786e\u5f53\u524d\u7528\u6237\n    $user_level = get_user_level($current_user);\n}\n\nfunction process_user($user) {\n    $user_level = get_user_level($user); \/\/ \u597d\uff1a\u53c2\u6570\u5df2\u547d\u540d\n}\n\n\/\/ \u89c4\u52192\uff1a\u4f5c\u7528\u57df\u660e\u786e\nclass User_Processor {\n    private $current_user; \/\/ \u5b9e\u4f8b\u5c5e\u6027\n    \n    public function process() {\n        $local_user = $this->current_user; \/\/ \u5c40\u90e8\u53d8\u91cf\n        $level = get_user_level($local_user);\n    }\n}\n\n\/\/ \u89c4\u52193\uff1a\u907f\u514d\u5168\u5c40\u53d8\u91cf\u6ee5\u7528\n\/\/ \u274c \u4e0d\u597d\uff1a\u76f4\u63a5\u4f7f\u7528\u5168\u5c40\u53d8\u91cf\nfunction bad_example() {\n    global $current_user;\n    return get_user_level($current_user);\n}\n\n\/\/ \u2705 \u597d\uff1a\u901a\u8fc7\u51fd\u6570\u83b7\u53d6\nfunction good_example() {\n    return get_user_level(wp_get_current_user());\n}<\/code><\/pre>\n\n\n\n
    \u7b2c\u4e03\u6b65\uff1a\u6d4b\u8bd5\u4e0e\u9a8c\u8bc1<\/strong><\/h3>\n\n\n\n
    \u6d4b\u8bd5\u77e9\u9635\u793a\u4f8b\uff1a<\/strong><\/p>\n\n\n\n
    $test_cases = [\n    \/\/ \u5386\u53f2\u8c03\u7528\u65b9\u5f0f -> \u671f\u671b\u7ed3\u679c\n    ['input' => null, 'context' => '\u5f53\u524d\u7528\u6237'],\n    ['input' => 123, 'context' => '\u7528\u6237ID'],\n    ['input' => $user_object, 'context' => '\u7528\u6237\u5bf9\u8c61'],\n    ['input' => 'admin@example.com', 'context' => '\u5386\u53f2\u9057\u7559\u683c\u5f0f'],\n];\n\n\/\/ \u9a8c\u8bc1\u6240\u6709\u5386\u53f2\u8def\u5f84\nforeach ($test_cases as $case) {\n    $result = Unified_Helper::unified_method($case['input']);\n    assert_equals($result, $expected, \"Failed for: {$case['context']}\");\n}<\/code><\/pre>\n\n\n\n
    \u5177\u4f53\u5de5\u5177\u4e0e\u6280\u672f<\/h2>\n\n\n\n
    1. IDE\u91cd\u6784\u5de5\u5177<\/strong><\/p>\n\n\n\n
    # PHPStorm \u91cd\u6784\u529f\u80fd\uff1a\n# - Rename (Shift+F6)    # \u91cd\u547d\u540d\n# - Extract Method (Cmd+Alt+M) # \u63d0\u53d6\u65b9\u6cd5\n# - Inline Method (Cmd+Alt+N)  # \u5185\u8054\u65b9\u6cd5\n# - Change Signature (Cmd+F6)   # \u4fee\u6539\u7b7e\u540d<\/code><\/pre>\n\n\n\n
    2. \u9759\u6001\u5206\u6790\u5de5\u5177<\/strong><\/p>\n\n\n\n
    # PHPStan \/ Psalm \u68c0\u67e5\u7c7b\u578b\nvendor\/bin\/phpstan analyse --level max src\/\n\n# \u68c0\u6d4b\u91cd\u590d\u4ee3\u7801\nphpcpd src\/ --min-lines 5 --min-tokens 30<\/code><\/pre>\n\n\n\n
    3. \u7248\u672c\u63a7\u5236\u7b56\u7565<\/strong><\/p>\n\n\n\n
    # \u4f7f\u7528\u7279\u6027\u5206\u652f\ngit checkout -b refactor\/unified-user-method\n\n# \u5c0f\u6b65\u63d0\u4ea4\ngit add -p  # \u4ea4\u4e92\u5f0f\u6dfb\u52a0\ngit commit -m \"refactor: \u7edf\u4e00get_user_level\u8c03\u7528\u6b65\u9aa41\"\n\n# \u4fdd\u6301\u53ef\u56de\u9000\ngit tag backup-before-refactor<\/code><\/pre>\n\n\n\n
    \u6700\u4f73\u5b9e\u8df5\u6e05\u5355<\/h2>\n\n\n\n
    \u9047\u5230\u65b0\u91cd\u590d\u65b9\u6cd5\u65f6\u7684\u68c0\u67e5\u8868\uff1a<\/strong><\/p>\n\n\n\n
    \u6587\u6863\u5316\u73b0\u6709\u5b9e\u73b0<\/strong><\/p>\n\n\n\n
    \/\/ \u521b\u5efa\u5bf9\u6bd4\u8868\u683c\n\/\/ | \u4f4d\u7f6e | \u53c2\u6570 | \u8fd4\u56de\u503c | \u7279\u6b8a\u903b\u8f91 |<\/code><\/pre>\n\n\n\n
    \u5206\u6790\u8c03\u7528\u4e0a\u4e0b\u6587<\/strong><\/p>\n\n\n\n
    \/\/ \u8bb0\u5f55\u6bcf\u4e2a\u8c03\u7528\u70b9\u7684\uff1a\n\/\/ 1. \u53c2\u6570\u6765\u6e90\n\/\/ 2. \u7ed3\u679c\u7528\u9014\n\/\/ 3. \u5f02\u5e38\u5904\u7406<\/code><\/pre>\n\n\n\n
    \u8bbe\u8ba1\u517c\u5bb9\u63a5\u53e3<\/strong><\/p>\n\n\n\n
    \/\/ \u8003\u8651\uff1a\n\/\/ - \u6700\u901a\u7528\u7684\u53c2\u6570\u7c7b\u578b\n\/\/ - \u5408\u7406\u7684\u9ed8\u8ba4\u503c\n\/\/ - \u5411\u540e\u517c\u5bb9\u65b9\u6848<\/code><\/pre>\n\n\n\n
    \u5236\u5b9a\u66ff\u6362\u8def\u7ebf\u56fe<\/strong><\/p>\n\n\n\n
    \/\/ \u5206\u9636\u6bb5\u8ba1\u5212\uff1a\n\/\/ \u9636\u6bb51: \u6dfb\u52a0\u7edf\u4e00\u65b9\u6cd5 + \u5305\u88c5\u5668\n\/\/ \u9636\u6bb52: \u66ff\u6362\u4f4e\u98ce\u9669\u8c03\u7528\n\/\/ \u9636\u6bb53: \u66ff\u6362\u9ad8\u98ce\u9669\u8c03\u7528\n\/\/ \u9636\u6bb54: \u5220\u9664\u65e7\u65b9\u6cd5<\/code><\/pre>\n\n\n\n
    \u00a0\u521b\u5efa\u56de\u5f52\u6d4b\u8bd5<\/strong><\/p>\n\n\n\n
    \/\/ \u786e\u4fdd\uff1a\n\/\/ - \u6240\u6709\u5386\u53f2\u7528\u4f8b\u901a\u8fc7\n\/\/ - \u8fb9\u754c\u6761\u4ef6\u5904\u7406\n\/\/ - \u6027\u80fd\u4e0d\u53d7\u5f71\u54cd<\/code><\/pre>\n\n\n\n
    \u7ecf\u9a8c\u6cd5\u5219<\/h2>\n\n\n\n
    \u53d8\u91cf\u540d\u5904\u7406\u9ec4\u91d1\u89c4\u5219\uff1a<\/strong><\/h3>\n\n\n\n
      \n
    1. \u4e0d\u7834\u574f\u73b0\u6709\u4ee3\u7801\u7684\u60c5\u51b5\u4e0b\uff0c\u4f18\u5148\u7edf\u4e00\u903b\u8f91\uff0c\u5176\u6b21\u7edf\u4e00\u547d\u540d<\/strong><\/li>\n\n\n\n
    2. \u53d8\u91cf\u540d\u5728\u4f5c\u7528\u57df\u5185\u81ea\u89e3\u91ca\u5373\u53ef\uff0c\u4e0d\u5f3a\u6c42\u5168\u5c40\u7edf\u4e00<\/strong><\/li>\n\n\n\n
    3. \u901a\u8fc7\u4ee3\u7801\u5ba1\u67e5\u9010\u6b65\u6539\u5584\u547d\u540d\uff0c\u800c\u4e0d\u662f\u5927\u89c4\u6a21\u91cd\u547d\u540d<\/strong><\/li>\n<\/ol>\n\n\n\n
      \u53c2\u6570\u8bbe\u8ba1\u539f\u5219\uff1a<\/strong><\/h3>\n\n\n\n
      \/\/ \u597d\uff1a\u7075\u6d3b\u4f46\u660e\u786e\npublic static function get_user_data($identifier = null, $context = 'current') {\n    \/\/ $identifier: ID\u3001\u5bf9\u8c61\u3001email\u7b49\n    \/\/ $context: 'current', 'any', 'admin'\u7b49\n}\n\n\/\/ \u4e0d\u597d\uff1a\u8fc7\u4e8e\u6b7b\u677f\npublic static function get_user_data_by_id($user_id) {\n    \/\/ \u53ea\u80fd\u5904\u7406ID\n}<\/code><\/pre>\n\n\n\n
      \u5e38\u89c1\u9677\u9631\u4e0e\u89e3\u51b3\u65b9\u6848<\/h2>\n\n\n\n
      \u9677\u96311\uff1a\u8fc7\u65e9\u5220\u9664\u65e7\u65b9\u6cd5<\/strong><\/h3>\n\n\n\n
      \/\/ \u89e3\u51b3\u65b9\u6848\uff1a\u5f03\u7528\u5468\u671f\nclass Legacy_Support {\n    \/**\n     * @deprecated \u4f7f\u7528 Unified_Helper::new_method()\n     *\/\n    public static function old_method() {\n        trigger_error('\u5df2\u5f03\u7528', E_USER_DEPRECATED);\n        return Unified_Helper::new_method();\n    }\n}<\/code><\/pre>\n\n\n\n
      \u9677\u96312\uff1a\u5ffd\u7565\u8fb9\u7f18\u60c5\u51b5<\/strong><\/h3>\n\n\n\n
      \/\/ \u89e3\u51b3\u65b9\u6848\uff1a\u9632\u5fa1\u6027\u7f16\u7a0b\npublic static function unified_method($input) {\n    try {\n        return self::do_work($input);\n    } catch (Exception $e) {\n        \/\/ \u8bb0\u5f55\u5386\u53f2\u517c\u5bb9\u6027\u8b66\u544a\n        error_log(\"\u517c\u5bb9\u6027\u95ee\u9898: \" . $e->getMessage());\n        return self::fallback_for_legacy($input);\n    }\n}<\/code><\/pre>\n\n\n\n
      \u9677\u96313\uff1a\u6027\u80fd\u5012\u9000<\/strong><\/h3>\n\n\n\n
      \/\/ \u89e3\u51b3\u65b9\u6848\uff1a\u57fa\u51c6\u6d4b\u8bd5\n$start = microtime(true);\n\/\/ \u65b0\u65b9\u6cd5\u8c03\u7528\n$time_new = microtime(true) - $start;\n\n$start = microtime(true);\n\/\/ \u65e7\u65b9\u6cd5\u8c03\u7528  \n$time_old = microtime(true) - $start;\n\nassert($time_new <= $time_old * 1.2); \/\/ \u5141\u8bb820%\u6027\u80fd\u635f\u5931<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"
      \u6838\u5fc3\u91cd\u6784\u6d41\u7a0b\uff08\u4e03\u6b65\u6cd5\uff09 \u7b2c\u4e00\u6b65\uff1a\u53d1\u73b0\u4e0e\u8bc6\u522b\u9636\u6bb5 \u7b2c\u4e8c\u6b65\uff1a\u6df1\u5ea6\u5206\u6790\u9636\u6bb5 \u5206\u6790\u7ef4\u5ea6\u68c0\u67e5\u8868\uff1a \u7279\u522b\u5173\u6ce8\u53c2\u6570\u547d\u540d\uff1a \u7b2c […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[54],"tags":[],"class_list":["post-1411","post","type-post","status-publish","format-standard","hentry","category-text"],"_links":{"self":[{"href":"http:\/\/www.preluna.xyz\/index.php\/wp-json\/wp\/v2\/posts\/1411","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/www.preluna.xyz\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.preluna.xyz\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.preluna.xyz\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/www.preluna.xyz\/index.php\/wp-json\/wp\/v2\/comments?post=1411"}],"version-history":[{"count":1,"href":"http:\/\/www.preluna.xyz\/index.php\/wp-json\/wp\/v2\/posts\/1411\/revisions"}],"predecessor-version":[{"id":1412,"href":"http:\/\/www.preluna.xyz\/index.php\/wp-json\/wp\/v2\/posts\/1411\/revisions\/1412"}],"wp:attachment":[{"href":"http:\/\/www.preluna.xyz\/index.php\/wp-json\/wp\/v2\/media?parent=1411"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.preluna.xyz\/index.php\/wp-json\/wp\/v2\/categories?post=1411"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.preluna.xyz\/index.php\/wp-json\/wp\/v2\/tags?post=1411"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}