条件分析
- 目标：当满足以下任一条件时，视为支付流程已完成，并展示订单详情、隐藏支付入口、标记为已支付：
- $order->status === 'paid' 且 $order->refund_status !== 'processing'
- $order->amount == 0 且 $user->phone_verified === true
- 其他情况下：不视为已支付，隐藏订单详情，显示支付入口。
- 风险点与处理：
- 金额为浮点数可能出现精度问题，使用“== 0”语义的同时增加小阈值判断以更稳健。
- refund_status 可能未设置，按“非 processing”处理以符合业务语义。
- 严格比较布尔“phone_verified”确保仅在明确为 true 时生效。
代码实现
<?php
declare(strict_types=1);
/**
* 依据业务条件计算页面可见性与支付状态
* 变量约定：
* - $order: 对象，包含 status, refund_status, amount
* - $user: 对象，包含 phone_verified
*/
// 示例环境中假定 $order 与 $user 已被注入为对象
// 初始化视图状态
$visible = true; // 页面可见（根据业务通常订单页本身可见）
$isPaid = false; // 是否视为已支付
$showOrderDetails = false; // 是否展示订单详情
$showPaymentEntry = true; // 是否展示支付入口
// 预计算原子条件，降低嵌套复杂度
$isPaidAndNotRefunding = (
isset($order->status)
&& $order->status === 'paid'
) && (
// refund_status 未设置时，视为“非 processing”
!isset($order->refund_status) || $order->refund_status !== 'processing'
);
// 金额等于 0 的稳健判断（兼容字符串/浮点数）
$amountIsZero = isset($order->amount)
&& is_numeric($order->amount)
&& ( (float)$order->amount == 0.0 || abs((float)$order->amount) < 0.00001 );
$phoneVerified = isset($user->phone_verified) && $user->phone_verified === true;
// 复合条件：满足其一即完成支付流程
$completedPaymentFlow = $isPaidAndNotRefunding || ($amountIsZero && $phoneVerified);
// 主条件分支
if ($completedPaymentFlow) {
$isPaid = true;
$showOrderDetails = true;
$showPaymentEntry = false;
} else {
$isPaid = false;
$showOrderDetails = false;
$showPaymentEntry = true;
}
// 汇总返回（可用于模板渲染或接口返回）
$viewState = [
'visible' => $visible,
'isPaid' => $isPaid,
'showOrderDetails' => $showOrderDetails,
'showPaymentEntry' => $showPaymentEntry,
];
// 如需输出检查
// var_export($viewState);
逻辑说明
- isPaidAndNotRefunding：
- 严格要求订单状态为 paid，同时退款状态不是 processing（未设置时按非 processing 处理）。
- amountIsZero：
- 金额存在且为数值，并判等 0；为避免浮点误差，补充了一个极小阈值比较。
- phoneVerified：
- completedPaymentFlow：
- 任一条件成立，即认为支付流程完成：要么“已支付且未处于退款处理中”，要么“免单（金额为 0）且手机号已验证”。
- if-else：
- 完成支付流程时：标记为已支付、显示订单详情、隐藏支付入口。
- 其余情况：未支付、隐藏订单详情、显示支付入口。
- 返回 viewState 结构，便于前端模板或 API 使用。
使用示例
<?php
declare(strict_types=1);
// 示例1：已支付且不在退款处理中
$order = (object)[
'status' => 'paid',
'refund_status' => 'none',
'amount' => 99.00,
];
$user = (object)[
'phone_verified' => false,
];
include 'logic.php'; // 假设上述逻辑代码在此文件中
var_export($viewState);
// 预期输出：
// array (
// 'visible' => true,
// 'isPaid' => true,
// 'showOrderDetails' => true,
// 'showPaymentEntry' => false,
// )
// 示例2：免单且手机号已验证
$order = (object)[
'status' => 'pending',
'refund_status' => null,
'amount' => 0,
];
$user = (object)[
'phone_verified' => true,
];
include 'logic.php';
var_export($viewState);
// 预期输出：
// array (
// 'visible' => true,
// 'isPaid' => true,
// 'showOrderDetails' => true,
// 'showPaymentEntry' => false,
// )
// 示例3：未支付或退款处理中
$order = (object)[
'status' => 'paid',
'refund_status' => 'processing',
'amount' => 99.00,
];
$user = (object)[
'phone_verified' => true,
];
include 'logic.php';
var_export($viewState);
// 预期输出：
// array (
// 'visible' => true,
// 'isPaid' => false,
// 'showOrderDetails' => false,
// 'showPaymentEntry' => true,
// )
注意事项
- 请确保 $order 和 $user 为对象且包含所需字段；若来自外部输入，需先做类型与存在性校验。
- 若金额在系统内以“分”为最小单位（整数存储），建议改为严格整型比较：((int)$order->amount === 0) 更稳妥。
- refund_status 建议限定枚举值（如 none/processing/success/failed），避免字符串散乱导致判断失效。
- 如果存在并发状态更新（支付与退款同时发生），需在服务端以事务/乐观锁保证状态一致性，再由此条件做展示控制。
- 如需国际化或审计，请在完成支付流程时记录原因（例如通过追加 reason 字段或事件日志）。
