phone=8000;770358128188071 => phone=''(不带后缀,保持原格式) */ class WaybillCodes { /** 默认单次最多处理的运单号数量 */ const DEFAULT_MAX = 50; /** 手机号后缀位数 */ const PHONE_SUFFIX_LENGTH = 4; /** * 解析成 [{waybill_code, phone}, ...],按运单号去重保序 * * @param array $body 请求体 * @param int $max 最多返回条数 * @return array */ public static function parse(array $body, $max = self::DEFAULT_MAX) { $items = []; foreach (self::rawList($body) as $item) { if (is_array($item) || is_object($item)) { continue; } $parsed = self::split($item); $code = $parsed['waybill_code']; if ($code === '' || isset($items[$code])) { continue; } $items[$code] = $parsed; if (count($items) >= $max) { break; } } return array_values($items); } /** * 只取运单号列表(按运单号去重保序) * * @param array $body * @param int $max * @return array */ public static function extract(array $body, $max = self::DEFAULT_MAX) { return array_column(self::parse($body, $max), 'waybill_code'); } /** * 拆分「单号|手机号后四位」 * * @param string $text * @return array ['waybill_code' => string, 'phone' => string] */ public static function split($text) { $parts = explode('|', (string)$text); return [ 'waybill_code' => trim($parts[0]), 'phone' => isset($parts[1]) ? self::normalizePhone($parts[1]) : '', ]; } /** * 手机号后缀归一:只保留数字,超过 4 位时取后 4 位(兼容误传完整手机号) * * @param string $phone * @return string 4 位数字或空串 */ public static function normalizePhone($phone) { $digits = preg_replace('/[^0-9]/', '', trim((string)$phone)); if ($digits === '') { return ''; } if (strlen($digits) > self::PHONE_SUFFIX_LENGTH) { $digits = substr($digits, -self::PHONE_SUFFIX_LENGTH); } return $digits; } /** * 取出请求体里的原始运单号数组,兼容 request.waybill_codes / 平铺 waybill_codes 等写法 * * @param array $body * @return array */ protected static function rawList(array $body) { if (isset($body['request']['waybill_codes'])) { $raw = $body['request']['waybill_codes']; } elseif (isset($body['request']['waybillCodes'])) { $raw = $body['request']['waybillCodes']; } elseif (isset($body['waybill_codes'])) { $raw = $body['waybill_codes']; } elseif (isset($body['waybillCodes'])) { $raw = $body['waybillCodes']; } else { $raw = []; } return is_array($raw) ? $raw : [$raw]; } }