PHP字符串填充技巧，str_pad函数使用教程

PHP的str_pad函数是字符串长度标准化的利器，支持灵活的左、右或两端填充，能轻松实现编号对齐、金额补零、标题居中等常见格式化需求；但需特别注意它基于字节而非字符计数，处理中文等多字节字符时易出现预期外的长度偏差，掌握其参数逻辑与边界行为，才能在实际开发中精准控制输出效果。

如果您需要将PHP字符串调整为指定长度，可通过内置函数str_pad实现。该函数支持在字符串左侧、右侧或两端添加填充字符以达到目标长度。以下是具体用法说明：

一、基本语法与参数说明

str_pad函数接收四个参数：原始字符串、目标总长度、填充字符（可选，默认为空格）、填充方向（可选，默认为STR_PAD_RIGHT）。其作用是确保输出字符串的字节长度严格等于设定值，超出部分不会被截断，仅当原字符串短于目标长度时执行填充。

1、第一个参数为待处理的字符串，可以是任意编码的字符串，但函数按字节计算长度，多字节字符需注意实际占用字节数。

2、第二个参数为目标总长度，必须为整数，若为负数或非数字则返回原始字符串且不报错。

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，确认未发生截断或异常填充。

到这里，我们也就讲完了《PHP字符串填充技巧，str_pad函数使用教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！