PHP str_pad怎么用-php教程-PHP中文网

str_pad按字节填充，不支持多字节字符安全对齐；处理中文等需用mb_strlen+mb_substr手动实现，否则会导致截断或错位。

php str_pad怎么用

str_pad 会把字符串补成固定长度，但默认只支持 ASCII 字符

str_pad 的核心作用是让字符串达到指定长度，不足部分用指定字符填充。它不改变原字符串，而是返回新字符串。关键限制在于：如果原字符串含多字节字符（比如中文、emoji），str_pad 按字节计数，不是按字符计数 —— 这会导致中文被截断或填充错位。

常见错误现象：
- 对 "你好" 调用 str_pad("你好", 10, "0")，结果不是你预期的 10 个“字符”宽，而是按 UTF-8 字节算（"你好" 占 6 字节），最终可能补出 4 个 "0"，总长 10 字节，但视觉上远不到 10 个汉字宽度。
- 在终端或等宽字体下对齐失败，尤其用于日志、表格输出时明显错位。

使用场景：生成固定宽度的日志前缀、数据库字段补零、ASCII 表格对齐、文件名编号对齐
三个必需参数：str_pad(<code>$input, $length, $pad_string, $pad_type)
$pad_type 只能是 STR_PAD_LEFT、STR_PAD_RIGHT（默认）、STR_PAD_BOTH
$pad_string 长度至少为 1 字节；若超过 1 字节（如 "--"），会被循环截断使用

中文/UTF-8 字符串必须先转字节数为字符数，再手动 pad

PHP 原生 str_pad 不支持多字节安全模式。要真正按“字符数”补全，得用 mb_strlen + mb_substr 手动实现逻辑。

示例：按 10 个汉字宽度右对齐补空格（视觉对齐）：

function mb_str_pad($str, $length, $pad_str = ' ', $pad_type = STR_PAD_RIGHT) {
    $str_len = mb_strlen($str, 'UTF-8');
    if ($str_len >= $length) return $str;
    $pad_len = $length - $str_len;
    $pad_str = str_repeat($pad_str, ceil($pad_len / mb_strlen($pad_str, 'UTF-8')));
    $pad_str = mb_substr($pad_str, 0, $pad_len, 'UTF-8');
    return $pad_type === STR_PAD_LEFT
        ? $pad_str . $str
        : ($pad_type === STR_PAD_BOTH
            ? str_repeat(' ', (int)(($pad_len - mb_strlen($pad_str, 'UTF-8')) / 2)) . $str . str_repeat(' ', (int)(($pad_len + 1) / 2))
            : $str . $pad_str);
}

注意：STR_PAD_BOTH 在多字节下没有标准对齐语义，上面示例只是近似；实际项目中建议避免用 STR_PAD_BOTH 处理中文，改用明确的左/右对齐 + 手动空格控制。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

性能差异：str_pad 比 mb_* 系列快 3–5 倍，但仅限纯 ASCII 场景

在处理大量日志行号、数字 ID、英文字段时，原生 str_pad 是最优选择。一旦混入中文、日文或 emoji，强制用它会导致不可控的字节偏移 —— 此时性能优势毫无意义，反而引入数据错位 bug。

纯数字补零（如订单号 "ORD000123"）：直接用 str_pad($id, 9, "0", STR_PAD_LEFT)
用户昵称对齐（含中文）：必须用 mb_* 手写逻辑，或改用 sprintf + 宽度占位（仅限固定字体环境）
CLI 输出表格：推荐用 printf("%-10s %-20s", $name, $email)，比反复调用 str_pad 更轻量且可控

容易被忽略的边界：$pad_string 为空或 null 会触发警告

str_pad 要求第三个参数 $pad_string 不能为空字符串或 null，否则抛出 Warning: str_pad(): Padding string cannot be empty。这个检查发生在运行时，IDE 和静态分析通常无法提前捕获。

别写 str_pad($x, 10, "") —— 即使你本意是“不填充”，也得显式判断：strlen($x)
从配置读取 $pad_char 时，务必用 trim() 并校验：if (!$pad_char = trim($config['pad_char'])) $pad_char = " "
$length 小于等于原字符串长度时，str_pad 直接返回原字符串，不会截断 —— 截断得靠 substr 或 mb_substr