str_pad函数可按字节长度填充字符串,支持左、右、两端填充;参数为原字符串、目标长度、填充字符(单字节)、方向;目标长度≤原长时返回原串,多字节字符需注意字节计算。

如果您需要将PHP字符串调整为指定长度,可通过内置函数str_pad实现。该函数支持在字符串左侧、右侧或两端添加填充字符以达到目标长度。以下是具体用法说明:
一、基本语法与参数说明
str_pad函数接收四个参数:原始字符串、目标总长度、填充字符(可选,默认为空格)、填充方向(可选,默认为STR_PAD_RIGHT)。其作用是确保输出字符串的字节长度严格等于设定值,超出部分不会被截断,仅当原字符串短于目标长度时执行填充。
1、第一个参数为待处理的字符串,可以是任意编码的字符串,但函数按字节计算长度,多字节字符需注意实际占用字节数。
2、第二个参数为目标总长度,必须为整数,若为负数或非数字则返回原始字符串且不报错。
立即学习“PHP免费学习笔记(深入)”;
3、第三个参数为填充字符,仅支持单字节字符,若传入多字节字符(如中文),仅取首字节参与填充。
4、第四个参数决定填充位置,可选STR_PAD_LEFT、STR_PAD_RIGHT或STR_PAD_BOTH,分别对应左对齐、右对齐和两端对称填充。
二、右侧填充示例
右侧填充是最常用方式,适用于生成固定宽度的编号、日志字段或表格对齐文本。当原始字符串长度小于目标长度时,在其末尾追加指定字符直至满足长度要求。
1、定义原始字符串:$str = "abc";
2、调用str_pad进行右侧填充:$result = str_pad($str, 8, "0");
3、输出结果为:"abc00000",总长度为8个字节,原始3字节+5个"0"。
三、左侧填充示例
左侧填充常用于金额补零、ID序列对齐等场景,通过在字符串起始位置插入填充字符,使内容靠右排列,便于视觉比对或数据库索引优化。
1、定义原始字符串:$str = "42";
2、调用str_pad并指定STR_PAD_LEFT:$result = str_pad($str, 6, "x", STR_PAD_LEFT);
3、输出结果为:"xxxx42",总长度为6,前4位由"x"填充。
四、两端填充示例
两端填充适用于需要居中显示的标题、分隔线或格式化输出,函数会优先向右侧添加一个填充字符,再向左侧添加,循环直至总长度达标,最终左右两侧填充数量差值不超过1。
1、定义原始字符串:$str = "PHP";
2、调用str_pad并指定STR_PAD_BOTH:$result = str_pad($str, 9, "*", STR_PAD_BOTH);
3、输出结果为:"***PHP***",总长度为9,左右各3个"*",中间为原始字符串。
五、注意事项与边界情况
使用str_pad时需警惕多字节字符带来的长度偏差,因函数始终以字节为单位计算,UTF-8编码下中文字符占3字节,可能导致实际显示宽度与预期不符。此外,当目标长度小于等于原字符串字节长度时,函数直接返回原字符串,不作任何修改。
1、测试UTF-8中文字符串:$str = "你好"; // 实际占6字节
2、尝试填充至长度5:$result = str_pad($str, 5, "a"); // 返回"你好",不填充
3、验证返回值长度:strlen($result) === 6,确认未发生截断或异常填充。











