PHP函数头生成器

/**
 * 验证下单接口参数：检查必填项、数值范围、SKU合法性与库存、地址格式，
 * 返回清洗后的参数结构与错误信息列表（不对业务校验抛出异常）。
 *
 * @param array         $payload        原始下单参数（如 buyer、items、shippingAddress 等）
 * @param array         $requiredFields 必填字段路径列表（支持点号与通配符，如 "items.*.sku"）
 * @param callable      $skuFetcher     SKU 元数据获取器；用于校验 SKU 合法性
 *                                      签名：function (string $sku): ?array
 * @param callable      $stockFetcher   库存查询器；用于校验可售库存
 *                                      签名：function (string $sku, ?string $warehouseId = null): int
 * @param array|null    $constraints    数值与业务约束（如最小/最大数量、金额范围、币种白名单、允许国家等）
 * @param array|null    $addressRules   地址校验与规范化规则（必填字段、格式正则、国家/省份映射等）
 *
 * @return array 返回数组包含：
 *               - data: array 已清洗与规范化的参数
 *               - errors: string[] 校验错误信息列表（若无错误则为空数组）
 *
 * @throws InvalidArgumentException 当传入的回调签名不符合预期或必要配置缺失时抛出
 */
protected function validateOrderPayload(
    array $payload,
    array $requiredFields,
    callable $skuFetcher,
    callable $stockFetcher,
    ?array $constraints = null,
    ?array $addressRules = null
): array

/**
 * 将给定标题转换为URL安全的slug：去除HTML、转为小写、用分隔符替换空白、
 * 清理特殊符号，并可选地进行多语言音译。
 *
 * 处理规则概述：
 * - 移除HTML标签与实体；
 * - 转为小写并修剪首尾分隔符；
 * - 将空白与连续分隔符标准化为单个分隔符（默认“-”）；
 * - 可选对非ASCII字符进行音译（多语言支持）；
 * - 清理仅保留URL安全字符。
 *
 * @param string      $title         原始标题字符串。
 * @param string|null $locale        音译使用的语言/区域标识（如 "zh_CN"、"en_US"），null为默认。
 * @param string      $separator     用于替换空白字符的分隔符，默认为“-”。
 * @param int|null    $maxLength     结果最大长度，null表示不限制，超出时应安全截断。
 * @param bool        $transliterate 是否对非ASCII字符进行音译，默认 true。
 * @param bool        $strict        是否严格清理仅保留URL安全字符，默认 true。
 *
 * @return string URL安全的slug字符串。
 *
 * @throws InvalidArgumentException 当参数无效（如空的分隔符、负长度等）时抛出。
 */
public static function slugifyTitle(
    string $title,
    ?string $locale = null,
    string $separator = '-',
    ?int $maxLength = null,
    bool $transliterate = true,
    bool $strict = true
): string