str_pad() 是 PHP 中的一個字符串處理函數，用于將字符串填充到指定長度。如果原始字符串小于指定的長度，它會在字符串的開頭、結尾或兩側添加填充字符，以達到所需的長度。這個函數有四個參數：

1. input (必需)：要填充的原始字符串。
2. pad_length (必需)：填充后的新字符串的總長度。如果該值小于或等于原始字符串的長度，則不會進行任何填充，并返回原始字符串。
3. pad_string (可選)：用作填充字符的字符串。默認情況下，這是一個空格字符。如果指定的填充字符串包含多個字符，只會使用第一個字符進行填充。
4. pad_type (可選)：填充類型。可以是以下三個值之一：
   • STR_PAD_LEFT：在字符串的開頭添加填充字符。
   • STR_PAD_RIGHT：在字符串的結尾添加填充字符。
   • STR_PAD_BOTH：在字符串的開頭和結尾添加填充字符。這是默認值。

以下是一些示例：

$input = "hello";
$pad_length = 10;
$pad_string = "-";
$pad_type = STR_PAD_LEFT;

$result = str_pad($input, $pad_length, $pad_string, $pad_type);
echo $result; // 輸出 "-----hello"

在這個示例中，我們將字符串 “hello” 填充到長度為 10 的新字符串。我們使用短劃線 “-” 作為填充字符，并在字符串的開頭添加填充字符。因此，結果是 “-----hello”。

如果你想在字符串的結尾添加填充字符，可以將 $pad_type 設置為 STR_PAD_RIGHT：

$pad_type = STR_PAD_RIGHT;
$result = str_pad($input, $pad_length, $pad_string, $pad_type);
echo $result; // 輸出 "hello-----"

如果你想在字符串的開頭和結尾添加填充字符，可以將 $pad_type 設置為 STR_PAD_BOTH：

$pad_type = STR_PAD_BOTH;
$result = str_pad($input, $pad_length, $pad_string, $pad_type);
echo $result; // 輸出 "--hello---"