wordpress php开发需遵循其规则：functions.php中禁用直接echo，须挂载到wp_head等钩子；user_register是注册后唯一可靠钩子；主题需style.css符合格式；模板按层级规则匹配而非字母顺序。
直接上手 WordPress 学 PHP，不是学“纯 PHP”，而是学「WordPress 怎么用 PHP」——它有自己的一套规则和边界。写错位置、时机不对、绕过钩子直接输出，90% 的报错都源于此。
functions.php 里不能直接 echo
常见错误现象：Headers already sent、页面顶部冒出一串文字、后台白屏。这是因为 functions.php 在 WordPress 初始化早期就加载，此时 HTTP 响应头还没发完，echo 会强行中断流程。
正确做法是把输出挂到 WordPress 提供的钩子上：
-
wp_head或wp_footer：适合插入 JS/CSS 或追踪代码 -
the_content：过滤文章正文（必须用add_filter，且函数要return修改后的字符串） -
admin_notices：在后台顶部显示提示信息
别写 echo "test"; 在 functions.php 顶层——哪怕只是临时调试，也先包进 add_action('wp_footer', function(){ echo 'test'; });。
user_register 是注册后唯一可靠的钩子
想在用户注册成功后发短信、写日志、初始化元数据？只认 user_register。它在数据库写入完成、$user_id 稳定可用之后触发，且兼容所有注册方式（前台表单、后台添加、REST API）。
容易踩的坑：
- 用
wp_insert_user或register_new_user：前者可能在事务未提交时触发，get_userdata($user_id)返回 false；后者是内部函数，版本更新后行为不稳定 - 在钩子函数里直接调用第三方 SDK 却没做异常捕获：一旦短信接口超时或失败，整个注册流程可能卡住（实际不会，但日志会丢）
- 忘了加
error_log()调试：开发阶段先打日志，确认钩子真被触发了，再加业务逻辑
示例最小可用结构：
function my_on_user_register( $user_id ) {
$user = get_userdata( $user_id );
if ( ! $user ) return;
error_log( '[REG] New user: ' . $user->user_login );
// 此处放你的业务逻辑
}
add_action( 'user_register', 'my_on_user_register', 10, 1 );
主题识别靠 style.css 文件头，不是文件夹名
后台“外观→主题”不显示你的主题？大概率是 style.css 没过 WordPress 的扫描校验。
必须满足：
- 文件放在主题根目录，不能藏在子文件夹里
- 编码为 UTF-8 无 BOM（用 VS Code 或 Notepad++ 检查并转换）
- 注释块严格以
/*开头、*/结尾，每行以*起始 - 必需字段只有
Theme Name:，其他如Text Domain:、Template:（子主题用）是可选但强烈建议填
错误示范：Theme Name：我的主题（用了中文冒号）、/* Theme Name: My Theme */（没换行、没 * 对齐）——都会导致主题不被识别。
模板文件不按字母顺序加载，按层级规则回退
以为改了 page.php 就能控制所有页面？错。WordPress 有一套硬编码的模板匹配顺序，比如访问首页时，它依次查找：
-
front-page.php（有就用，不管是不是静态首页） -
home.php（博客首页） -
index.php（兜底）
所以如果你做了个自定义首页，却把模板文件命名为 homepage.php，WordPress 根本不会理它——名字错了，再漂亮也没用。
调试建议：
- 开启
WP_DEBUG，并在模板开头加<!-- Loaded: page.php -->这类注释，浏览器源码里一眼看到加载了哪个文件 - 别依赖
is_page()判断当前模板，它返回的是查询结果，不是文件名；要看get_page_template_slug()或直接查$template全局变量
最易忽略的一点：子主题的 functions.php 会比父主题先加载，但父主题的钩子注册（比如 add_action('after_setup_theme', ...)）仍会生效——顺序和执行时机不是一回事，别凭直觉猜。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
