# WordPress 插件开发（核心） **状态**：生产就绪 **最后更新**：2025-11-06 **依赖项**：无（WordPress 5.9+、PHP 7.4+） **最新版本**：推荐 WordPress 6.7+、PHP 8.0+ ** ** ## 快速入门（10 分钟） ### 1\.选择您的插件结构 WordPress 插件可以使用三种架构模式： * **简单**（仅功能）- 对于具有 <5 个功能的小型插件 * **OOP**（面向对象）- 用于具有相关功能的中等插件 * **PSR-4**（命名空间 + Composer 自动加载）- 适用于大型/现代插件 **为什么这很重要：** * 简单的插件最容易启动，但扩展性不佳 * OOP 提供了没有现代 PHP 功能的组织 * PSR-4 是现代标准 (2025) 并且最易于维护 ### 2\.创建插件头每个插件必须在主文件中有一个标题注释： " /> // 4. 清理输入，转义输出 $clean = sanitize_text_field( $_POST['input'] ); 回声 esc_html( $输出 ); // 5. 数据库准备语句全局 $wpdb; $结果 = $wpdb->get_results( $wpdb->准备( “从 {$wpdb->prefix} 表中选择 *，其中 id = %d”， $id ））； ** ** ## 5 步安全基础 WordPress 插件安全性具有必须全部存在的三个组件： ### 第 1 步：对所有内容使用唯一前缀 **为什么**：防止与其他插件和 WordPress 核心发生命名冲突。 **规则**： * 最少 4-5 个字符 * 适用于：函数、类、常量、选项、瞬态、元键、全局变量 * 避免：`wp_`、`__`、`_`、"WordPress" // 好函数 mypl_function_name() {} 类 MyPL_Class_Name {} 定义（'MYPL_CONSTANT'，'值'）； add_option( 'mypl_option', '值' ); set_transient( 'mypl_cache', $data, HOUR_IN_SECONDS ); // 不好 function function_name() {} // 没有前缀，会冲突 class Settings {} // 太通用 ### 第 2 步：检查功能，而不仅仅是管理状态 **错误**：使用 `is_admin()` 进行权限检查 // 错误 - 任何人都可以访问管理区域 URL 如果（is_admin（））{ // 删除用户数据 - 安全漏洞 } // 正确 - 检查用户能力 if ( current_user_can( 'manage_options' ) ) { // 删除用户数据 - 现在安全 } **通用功能**： * `manage_options` \- 管理员 * `edit_posts` \- 编辑/作者 * `publish_posts` \- 作者 * `edit_pages` \- 编辑器 * `read` \- 订阅者 ### 步骤 3：安全三位一体 **输入→处理→输出**各自需要不同的功能： // SANITIZATION（输入）- 清理用户数据 $name = sanitize_text_field( $_POST['name'] ); $email = sanitize_email( $_POST['email'] ); $url = esc_url_raw( $_POST['url'] ); $html = wp_kses_post( $_POST['content'] ); // 允许安全 HTML $key = sanitize_key( $_POST['option'] ); $ids = array_map( 'absint', $_POST['ids'] ); // 整数数组 // VALIDATION（逻辑）-验证其满足要求 if ( !is_email( $email ) ) { wp_die( '无效的电子邮件' ); } // ESCAPING（输出）- 保证显示安全回声 esc_html( $name ); echo ''; echo '

'; 回显'<文本区域>'。 esc_textarea( $内容 ) 。 ''; **关键规则**：输入时清理，输出时转义。永远不要相信用户数据。 ### 步骤 4：随机数（CSRF 保护） **什么**：证明请求来自您的网站的一次性令牌。 **表格样式**： // 生成nonce形式 <表单方法=“帖子”> <输入类型=“文本”名称=“数据”/> // 验证处理程序中的随机数 if ( !isset( $_POST['mypl_nonce'] ) || !wp_verify_nonce( $_POST['mypl_nonce'], 'mypl_action' ) ) { wp_die( '安全检查失败' ); } // 现在可以安全地继续了 $data = sanitize_text_field( $_POST['data'] ); **AJAX 模式**： // JavaScript jQuery.ajax({ 网址：ajaxurl，数据：{ 行动：'mypl_ajax_action'，随机数：mypl_ajax_object.nonce，数据：表单数据 } }); // PHP 处理程序函数 mypl_ajax_handler() { check_ajax_referer( 'mypl-ajax-nonce', 'nonce' ); // 可以安全继续 wp_send_json_success( array( '消息' => '成功' ) ); } add_action( 'wp_ajax_mypl_ajax_action', 'mypl_ajax_handler' ); // 使用随机数本地化脚本 wp_localize_script( 'mypl-script', 'mypl_ajax_object', array( 'ajaxurl' => admin_url( 'admin-ajax.php' ), 'nonce' => wp_create_nonce( 'mypl-ajax-nonce' ), ) ); ### 步骤 5：数据库准备语句 **关键** ：始终使用 `$wpdb->prepare()` 进行带有用户输入的查询。全局 $wpdb; // 错误 - SQL 注入漏洞 $results = $wpdb->get_results( "SELECT * FROM {$wpdb->prefix}表 WHERE id = {$_GET['id']}" ); // 正确 - 准备好的语句 $结果 = $wpdb->get_results( $wpdb->准备( “从 {$wpdb->prefix} 表中选择 *，其中 id = %d”， $_GET['id'] ））； **占位符**： * `%s` \- 字符串 * `%d` \- 整数 * `%f` \- 浮点数 **LIKE 查询**（特殊情况）： $搜索='%'。 $wpdb->esc_like( $term ) 。 '%'; $结果 = $wpdb->get_results( $wpdb->准备( "SELECT * FROM {$wpdb->prefix}posts WHERE post_title LIKE %s", $搜索））； ** ** ## 关键规则 ### 总是这样做 ✅ **对所有全局代码（函数、类、选项、瞬态）使用唯一的前缀**（4-5 个字符） ✅ **向每个 PHP 文件添加 ABSPATH 检查**： `if ( ! Defined( 'ABSPATH' ) ) exit;` ✅ **检查功能** (`current_user_can()`) 而不仅仅是 `is_admin()` ✅ **验证所有表单和 AJAX 请求的随机数** ✅ **使用 $wpdb- >prepare()** 使用用户输入进行所有数据库查询 ✅ **在保存之前使用 `sanitize_*()` 函数清理输入** ✅ **在显示之前使用 `esc_*()` 函数转义输出** ✅ **注册自定义帖子类型时激活时刷新重写规则** ✅ **使用 uninstall.php** 进行永久清理（而不是停用挂钩） ✅ **遵循 WordPress 编码标准**（用于缩进、Yoda 条件的选项卡） ### 永远不要这样做 ❌ **永远不要使用 extract()** \- 创建安全漏洞 ❌ **永远不要在没有清理的情况下信任 $_POST/$_GET** ❌ **永远不要将用户输入连接到 SQL** \- 始终使用prepare() ❌ **永远不要单独使用 `is_admin()` 进行权限检查 ❌ **永远不要输出未经净化的数据** \- 始终转义 ❌ **永远不要使用通用函数/类名** \- 始终使用前缀❌ **切勿使用短 PHP 标签** `（所有漏洞的 15%） **为什么发生**：将用户输入直接串联到 SQL 查询中 **预防**：始终使用带有占位符的 `$wpdb->prepare()` // 脆弱的 $wpdb->query( "从 {$wpdb->prefix}表中删除 WHERE id = {$_GET['id']}" ); // 安全 $wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->prefix}table WHERE id = %d", $_GET['id'] ) ); ### 问题 #2：XSS（跨站脚本） **错误**：在用户浏览器中执行恶意 JavaScript **来源**：（占所有漏洞的 35%） **为什么发生**：将未经净化的用户数据输出到 HTML **预防**：始终使用上下文相关的函数转义输出 // 脆弱的回显 $_POST['名称']; echo '

'; // 安全 echo esc_html( $_POST['name'] ); echo '

我的插件需要 WooCommerce。

'; } ); 返回； } // 初始化插件 } ); ### 问题 #19：自动保存触发元保存 **错误**：Meta 保存多次，性能问题 **来源**：WordPress Post Meta **为什么会发生**：save_post 挂钩中没有自动保存检查 **预防**：检查 DOING_AUTOSAVE 常量 add_action( 'save_post', function( $post_id ) { 如果（已定义（'DOING_AUTOSAVE'）&& DOING_AUTOSAVE）{ 返回； } // 安全保存元数据 } ); ### 问题 #20：admin-ajax.php 性能 **错误**：缓慢的 AJAX 响应 **来源**： **为什么会发生**：admin-ajax.php 加载整个 WordPress 核心 **预防**：对新项目使用 REST API（速度提高 10 倍） // 旧版：admin-ajax.php（仍然有效，但速度较慢） add_action( 'wp_ajax_mypl_action', 'mypl_ajax_handler' ); // 新：REST API（速度提高 10 倍，推荐） add_action( 'rest_api_init', 函数() { register_rest_route( 'myplugin/v1', '/端点', 数组( '方法' => '发布', '回调' => 'mypl_rest_handler', 'permission_callback' => 函数() { 返回 current_user_can( 'edit_posts' ); }, ) ); } ); ** ** ## 插件架构模式 ### 模式 1：简单插件（仅限函数） **何时使用** ：具有 <5 个功能的小插件，没有复杂的状态

我的插件设置

define_constants(); $this->init_hooks(); } 私有函数define_constants() { 定义（'MYPL_VERSION'，'1.0.0'）; 定义（'MYPL_PLUGIN_DIR'，plugin_dir_path（__FILE__））; 定义（'MYPL_PLUGIN_URL'，plugin_dir_url（__FILE__））; } 私有函数 init_hooks() { add_action( 'init', array( $this, 'init' ) ); add_action( 'admin_menu', array( $this, 'admin_menu' ) ); } 公共函数 init() { // 初始化代码 } 公共函数 admin_menu() { 添加选项页面（ '我的插件', '我的插件', '管理选项', '我的插件', 数组( $this, 'settings_page' ) ）； } 公共函数settings_page() { ?>

我的插件设置

=7.4” } } **我的插件.php**： init(); } 私有函数 init() { 新的管理员（）；新前端（）； } } MyPlugin::get_instance(); **src/Admin.php**：

我的插件设置

数组( '名称' => '书籍', 'singular_name' => '书', 'add_new_item' => '添加新书', ), '公共' => 真实， 'has_archive' => 真， 'show_in_rest' => true, // 古腾堡支持 '支持' => array( '标题', '编辑器', '缩略图', '摘录' ), '重写' => 数组( 'slug' => '书籍' ), 'menu_icon' => 'dashicons-book', ) ); } add_action( 'init', 'mypl_register_cpt' ); // 关键：激活时刷新重写规则函数 mypl_activate() { mypl_register_cpt(); 刷新_重写_规则（）； } register_activation_hook( __FILE__, 'mypl_activate' ); 函数 mypl_deactivate() { 刷新_重写_规则（）； } register_deactivation_hook( __FILE__, 'mypl_deactivate' ); ### 模式 2：自定义分类法函数 mypl_register_taxonomy() { register_taxonomy( '流派', '书籍', 数组( '标签' => 数组( '名称' => '流派', 'singular_name' => '流派', ), 'hierarchical' => true, // 类似类别 'show_in_rest' => 真， '重写' => 数组( 'slug' => '流派' ), ) ); } add_action( 'init', 'mypl_register_taxonomy' ); ### 模式 3：元框函数 mypl_add_meta_box() { 添加元框（ '书籍详细信息', '书籍详细信息', 'mypl_meta_box_html', '书', '正常', ‘高’ ）； } add_action( 'add_meta_boxes', 'mypl_add_meta_box' ); 函数 mypl_meta_box_html( $post ) { $isbn = get_post_meta( $post->ID, '_book_isbn', true ); wp_nonce_field( 'mypl_save_meta', 'mypl_meta_nonce' ); ?> <标签=“book_isbn”>ISBN： '字符串', 'sanitize_callback' => 'sanitize_text_field', '默认' => '', ) ); 添加设置部分（ 'mypl_section', 'API 设置', 'mypl_section_callback', '我的插件' ）；添加设置字段（ 'mypl_api_key', 'API 密钥', 'mypl_field_callback', '我的插件', 'mypl_section' ）； } add_action( 'admin_init', 'mypl_register_settings' ); 函数 mypl_section_callback() { echo '

配置您的 API 设置。

'; } 函数 mypl_field_callback() { $value = get_option( 'mypl_api_key' ); ?>

WP_REST_Server::可读， '回调' => 'mypl_rest_callback', 'permission_callback' => 函数() { 返回 current_user_can( 'edit_posts' ); }, 'args' => 数组( 'id' => 数组( '必需' => 正确， 'validate_callback' => 函数( $param ) { 返回 is_numeric( $param ); }, 'sanitize_callback' => 'absint', ), ), ) ); } ); 函数 mypl_rest_callback( $request ) { $id = $request->get_param( 'id' ); // 处理... 返回新的 WP_REST_Response( 数组( '成功' => 正确， '数据' => $数据， ), 200); } ### 模式 6：AJAX 处理程序（旧版） // 使用本地化数据将脚本排入队列函数 mypl_enqueue_ajax_script() { wp_enqueue_script( 'mypl-ajax', plugins_url( 'js/ajax.js', __FILE__ ), array( 'jquery' ), '1.0', true ); wp_localize_script( 'mypl-ajax', 'mypl_ajax_object', 数组( 'ajaxurl' => admin_url( 'admin-ajax.php' ), 'nonce' => wp_create_nonce( 'mypl-ajax-nonce' ), ) ); } add_action( 'wp_enqueue_scripts', 'mypl_enqueue_ajax_script' ); // AJAX 处理程序（登录用户）函数 mypl_ajax_handler() { check_ajax_referer( 'mypl-ajax-nonce', 'nonce' ); $data = sanitize_text_field( $_POST['data'] ); // 处理... wp_send_json_success( array( '消息' => '成功' ) ); } add_action( 'wp_ajax_mypl_action', 'mypl_ajax_handler' ); // AJAX 处理程序（注销用户） add_action( 'wp_ajax_nopriv_mypl_action', 'mypl_ajax_handler' ); **JavaScript (js/ajax.js)** : jQuery(文档).ready(函数($) { $('#my-button').on('点击', function() { $.ajax({ 网址：mypl_ajax_object.ajaxurl，类型：'发布'，数据：{ 行动：'mypl_action'，随机数：mypl_ajax_object.nonce，数据：“值” }, 成功：函数（响应）{ console.log(response.data.message); } }); }); }); ### 模式 7：自定义数据库表函数 mypl_create_tables() { 全局 $wpdb; $table_name = $wpdb->前缀。 'mypl_data'; $charset_collate = $wpdb->get_charset_collate(); $sql = "创建表 $table_name ( id bigint(20) NOT NULL AUTO_INCRMENT, user_id bigint(20) NOT NULL, 数据文本不为空，创建日期时间 DEFAULT CURRENT_TIMESTAMP NOT NULL, 主键（id）， KEY 用户 ID（用户 ID） ) $charset_collate;"; require_once ABSPATH 。 'wp-admin/includes/upgrade.php'; dbDelta($sql); add_option( 'mypl_db_version', '1.0' ); } // 激活时创建表 register_activation_hook( __FILE__, 'mypl_create_tables' ); ### 模式 8：缓存瞬态函数 mypl_get_expense_data() { // 尝试获取缓存数据 $data = get_transient( 'mypl_expense_data' ); 如果（假===$数据）{ // 未缓存 - 重新生成 $数据=执行昂贵的操作（）； // 缓存12小时 set_transient( 'mypl_expense_data', $data, 12 * HOUR_IN_SECONDS ); } 返回$数据； } // 数据改变时清除缓存函数 mypl_clear_cache() { 删除_瞬态（“mypl_expense_data”）； } add_action( 'save_post', 'mypl_clear_cache' ); ** ** ## 使用捆绑资源 ### 模板（模板/）使用这些可用于生产的模板快速搭建插件： * `templates/plugin-simple/` \- 具有功能的简单插件 * `templates/plugin-oop/` \- 面向对象的插件结构 * `templates/plugin-psr4/` \ - 带 Composer 的现代 PSR-4 插件 * `templates/examples/meta-box.php` \- 元框实现 * `templates/examples/settings-page.php` \- 设置 API 页面 * `templates/examples/custom-post-type.php` \- CPT 注册 * `templates/examples/rest-endpoint.php` \- REST API 端点 * `templates/examples/ajax-handler.php` \- AJAX 实现 **Claude 何时应使用这些**：创建新插件或实现特定功能模式时。 ### 脚本（脚本/） * `scripts/scaffold-plugin.sh` \- 交互式插件脚手架 * `scripts/check-security.sh` \-常见问题的安全审核 * `scripts/validate-headers.sh` \- 验证插件标头 **用法示例：** # 支架新插件 ./scripts/scaffold-plugin.sh my-plugin 简单 # 检查安全问题 ./scripts/check-security.sh my-plugin.php # 验证插件标头 ./scripts/validate-headers.sh my-plugin.php ### 参考文献（参考文献/） Claude 在需要时可以加载的详细文档： * `references/security-checklist.md` \- 完整的安全审核清单 * `references/hooks-reference.md` \- 常见的 WordPress 钩子和过滤器 * `references/sanitization-guide.md` \- 所有清理/转义函数 * `references/wpdb-patterns.md` \- 数据库查询模式 * `references/common-errors.md` \- 扩展错误预防指南 **当 Claude 应该加载这些**：在处理安全问题、选择正确的钩子、清理特定数据类型、编写数据库查询或调试常见错误时。 ** ** ## 高级主题 ### 国际化 (i18n) // 加载文本域函数 mypl_load_textdomain() { load_plugin_textdomain( 'my-plugin', false, dirname(plugin_basename( __FILE__ ) ) . '/languages' ); } add_action( 'plugins_loaded', 'mypl_load_textdomain' ); // 可翻译的字符串 __( '文本', '我的插件' ); // 返回翻译后的字符串 _e( '文本', '我的插件' ); // 回显翻译后的字符串 _n( '一项', '%d 项', $count, 'my-plugin' ); // 复数形式 esc_html__( '文本', '我的插件' ); // 翻译并转义 esc_html_e( '文本', '我的插件' ); // 翻译、转义和回显 ### WP-CLI 命令如果（已定义（'WP_CLI'）&& WP_CLI）{ 类 MyPL_CLI_Command { /** * 处理数据 * * ## 示例 * * wp mypl进程--limit=100 * * @参数数组$args * @param 数组 $assoc_args */ 公共函数过程（$args，$assoc_args）{ $limit = isset( $assoc_args['limit'] ) ?绝对值( $assoc_args['limit'] ) : 10; WP_CLI::line( "正在处理 $limit 项..." ); // 处理... WP_CLI::success( '处理完成！' ); } } WP_CLI::add_command( 'mypl', 'MyPL_CLI_Command' ); } ### 预定事件 (Cron) // 激活时安排事件函数 mypl_activate() { if ( !wp_next_scheduled( 'mypl_daily_task' ) ) { wp_schedule_event( 时间(), '每日', 'mypl_daily_task' ); } } register_activation_hook( __FILE__, 'mypl_activate' ); // 停用时清除事件函数 mypl_deactivate() { wp_clear_scheduled_hook('mypl_daily_task'); } register_deactivation_hook( __FILE__, 'mypl_deactivate' ); // 挂钩预定事件函数 mypl_do_daily_task() { // 执行任务 } add_action( 'mypl_daily_task', 'mypl_do_daily_task' ); ### 插件依赖关系检查 add_action( 'admin_init', 函数() { // 检查 WooCommerce if ( !class_exists( 'WooCommerce' ) ) { deactivate_plugins(plugin_basename(__FILE__)); add_action( 'admin_notices', function() { echo '

我的插件需要安装并激活 WooCommerce。

'; } ); if ( isset( $_GET['activate'] ) ) { 取消设置( $_GET['激活'] ); } } } ); ** ** ## 分发和自动更新 ### 启用 GitHub 自动更新 WordPress.org 外部托管的插件仍然可以使用 YahnisElsts 的 **插件更新检查器** 提供自动更新。这是大多数用例的推荐解决方案。 **快速入门：** // 1. 安装库（git 子模块或 Composer） git 子模块添加 https://github.com/YahnisElsts/plugin-update-checker.git // 2. 添加到主插件文件需要plugin_dir_path( __FILE__ ) 。 '插件更新检查器/插件更新检查器.php'; 使用 YahnisElsts\PluginUpdateChecker\v5\PucFactory； $updateChecker = PucFactory::buildUpdateChecker( 'https://github.com/yourusername/your-plugin/', __文件__， '你的插件slug' ）； // 使用 GitHub Releases（推荐） $updateChecker->getVcsApi()->enableReleaseAssets(); // 对于私有存储库，使用 wp-config.php 中的令牌如果（已定义（'YOUR_PLUGIN_GITHUB_TOKEN'））{ $updateChecker->setAuthentication( YOUR_PLUGIN_GITHUB_TOKEN ); } **部署：** # 1. 更新插件头中的版本 # 2. 提交并标记 git add my-plugin.php git commit -m “将版本升级到 1.0.1” git标签1.0.1 git推送原点主要 git 推送起源 1.0.1 # 3. 创建 GitHub 版本（可选但推荐） # - 上传预构建的 ZIP 文件（不包括 .git、测试等） # - 为用户添加发行说明 **主要特点：** ✅ 可与 GitHub、GitLab、BitBucket 或自定义服务器配合使用 ✅ 支持公共和私有存储库 ✅ 使用 GitHub Releases 或标签进行版本控制 ✅ 基于 HTTPS 的安全更新 ✅ 可选的许可证密钥集成 ✅ 专业发行说明和变更日志 ✅ 约 100KB 库占用空间 **替代解决方案：** 1. **Git Updater**（用户可安装的插件，无需编码） 2. **自定义更新服务器**（完全控制，需要托管） 3. **Freemius**（商业，包括许可和付款） **综合资源：** * **完整指南** ：参见 `references/github-auto-updates.md` （21 页，所有方法） * **实现示例** ：参见 `examples/github-updater.php` （10 个示例） * **安全最佳实践**：校验和、签名、令牌存储、速率限制 * **模板集成**：所有 3 个插件模板均包含设置说明 **安全考虑：** * ✅ 始终对存储库 URL 使用 HTTPS * ✅ 切勿硬编码身份验证令牌（使用 wp-config.php） * ✅ 在提供更新之前实施许可证验证 * ✅ 可选：添加校验和以进行文件验证 * ✅ 速率限制更新检查以避免 API 限制 * ✅ 安装后清除缓存的更新数据 **何时使用每种方法：** 使用案例|推荐解决方案 ---|--- 开源、公共存储库 |插件更新检查器私人插件，客户端工作 |插件更新检查器+私人仓库商业插件 | Freemius 或自定义服务器多平台 Git 托管 | Git 更新程序定制许可需求|自定义更新服务器 **ZIP 结构要求：** 插件.zip └── my-plugin/ ← 插件文件夹必须位于 ZIP 内 ├── my-plugin.php ├── 自述.txt └── ... 不正确的结构将导致 WordPress 创建随机文件夹名称并破坏插件！ ** ** ## 依赖关系 **必填**： * WordPress 5.9+（推荐6.7+） * PHP 7.4+（推荐8.0+） **可选**： * Composer 2.0+ - 用于 PSR-4 自动加载 * WP-CLI 2.0+ - 用于命令行插件管理 * 查询监视器 - 用于调试和性能分析 ** ** ## 官方文档 * **WordPress 插件手册** : * **WordPress 编码标准** : * **WordPress REST API** ： * **WordPress 数据库类 ($wpdb)** : * **WordPress 安全**： * **设置API**： * **自定义帖子类型** ： * **瞬态 API** ： * **Context7 库 ID**：/websites/developer_wordpress ** ** ## 故障排除 ### 问题：插件导致致命错误 **解决方案**： 1.在wp-config.php中启用WP_DEBUG 2. 在 wp-content/debug.log 检查错误日志 3. 验证所有类/函数名称都有前缀 4. 检查是否缺少依赖项 ### 问题：自定义帖子类型页面上出现 404 错误 **解决方案**：刷新重写规则 // 暂时添加到wp-admin 刷新_重写_规则（）； // 访问一次 wp-admin 后删除 ### 问题：Nonce 验证总是失败 **解决方案**： 1. 检查字段中的随机数名称匹配并进行验证 2. 验证使用正确的操作名称 3.确保nonce没有过期（默认24小时） ### 问题：AJAX 返回 0 或 -1 **解决方案**： 1. 验证操作名称是否匹配挂钩：`wp_ajax_{action}` 2. 检查随机数是否正在发送并验证 3. 确保处理程序函数存在并且正确挂钩 ### 问题：清理剥离 HTML **解决方案**：使用 `wp_kses_post()` 而不是 `sanitize_text_field()` 以允许安全的 HTML ### 问题：数据库查询不起作用 **解决方案**： 1. 始终使用 `$wpdb->prepare()` 进行带变量的查询 2. 检查表名是否包含`$wpdb->prefix` 3. 验证列名和语法 ** ** ## 完整设置清单使用此清单来验证您的插件： * 包含所有字段的插件标头 * 每个 PHP 文件顶部的 ABSPATH 检查 * 所有函数/类都使用唯一的前缀 * 所有表格都有随机数验证 * 所有用户输入均经过清理 * 所有输出都被转义 * 所有数据库查询都使用$wpdb->prepare() * 能力检查（不仅仅是 is_admin()） * 自定义帖子类型在激活时刷新重写规则 * 停用钩子仅清除临时数据 * uninstall.php 处理永久清理 * 文本域与插件 slug 匹配 * 脚本/样式仅在需要时加载 * 开发期间启用WP_DEBUG * 使用查询监视器测试性能 * 没有弃用功能警告 * 适用于最新的 WordPress 版本 ** ** **有问题吗？有问题吗？** 1. 检查 `references/common-errors.md` 以进行扩展故障排除 2. 验证安全基础中的所有步骤 3.查看官方文档： 4.启用WP_DEBUG并检查debug.log 5.使用Query Monitor插件调试钩子和查询

WordPress 插件核心

包含技能