PHP注册表单提交输出源码未执行 无法写入数据库问题排查

页面直接输出PHP代码片段，核心原因是PHP解释器未对代码做解析处理，和业务逻辑无关，按以下优先级排查：

• 访问方式错误：直接双击PHP文件通过file://本地协议打开，请求没有经过web服务器和PHP解析进程。必须通过web服务绑定的本地地址访问，例如http://localhost/sign-up.php
• 运行环境异常：本地web服务（Apache/Nginx）未启动、未安装/启用PHP解析模块，使用phpStudy、XAMPP等集成环境时，需确认Web服务和PHP服务均处于运行状态
• 解析配置错误：web服务器未配置.php后缀文件的解析规则，或PHP文件扩展名误写为.html等非可解析格式
• 标签语法错误：PHP代码块使用了短标签<?但php.ini配置中未开启short_open_tag = On，统一使用标准起始标签<?php可规避该问题

规范层面 #

• 统一文件命名风格：当前前端表单页为sign-up.php（横杠分隔）、后端处理页为sign_up.php（下划线分隔），命名规则不一致极易出现路径引用错误，建议统一使用同一种分隔规则
• 纯PHP代码文件末尾不要加?>闭合标签，避免标签后的多余空格、换行引发header跳转、session启动失败等问题
• 公共逻辑抽离复用：数据库连接配置、公共函数单独存为独立文件（如config.php），其他业务文件通过require引入即可，不要重复编写相同逻辑
• 表单必须明确指定提交方式：敏感信息提交必须设置method="post"，禁止使用默认GET方式传输账号、密码类数据，form标签的action属性需准确填写后端处理文件路径

安全与逻辑层面 #

• 前置参数校验：所有用户传入的表单数据必须先做非空判断、格式校验（如邮箱格式、密码长度规则），校验不通过直接返回错误提示，终止后续逻辑执行
• 数据库操作必须使用预处理语句：禁止直接拼接用户输入到SQL语句中，彻底避免SQL注入风险，PDO预处理示例：

// 连接数据库后初始化预处理对象
$stmt = $pdo->prepare("INSERT INTO users (username, email, password) VALUES (?, ?, ?)");
// 绑定参数执行，无需手动转义特殊字符
$stmt->execute([
    $_POST['username'],
    $_POST['email'],
    $passwordHash
]);

• 密码禁止明文存储：必须使用PHP内置password_hash()函数对用户密码做哈希处理后存入数据库，登录校验时使用password_verify()比对哈希值，不要自行实现加密逻辑
• 注册/登录逻辑处理完成后，使用header()做页面跳转，不要直接输出成功/失败提示，避免用户刷新页面重复提交表单
• 增加CSRF防护：表单中嵌入随机生成的CSRF令牌并存入Session，后端处理请求时先校验令牌合法性，拦截跨站伪造请求
• 生产环境关闭前端错误输出：php.ini中设置display_errors = Off，将运行错误写入服务端日志，避免泄露数据库结构、文件路径等敏感信息

调试技巧 #

• 环境验证：先创建测试文件test.php，写入<?php phpinfo();放到web服务根目录访问，若能正常输出PHP版本、配置信息页，说明运行环境配置正常，否则优先排查环境问题
• 开发环境开启全量错误提示：设置error_reporting = E_ALL、display_errors = On，语法错误、运行警告会直接输出具体位置，降低排查成本
• 接口调试优先验证数据接收：后端逻辑最开始加var_dump($_POST);输出，确认表单数据能正常传到后端后，再编写后续数据库操作逻辑

内容的提问来源于stack exchange，提问作者Petruz21