PHPのstr_pad()関数とは？文字列のパディング方法をわかりやすく解説

PHPのstr_pad()関数は、文字列を指定した長さまで特定の文字で埋め（パディング）、新しい長さの文字列を返す関数です。文字列の左側・右側・両側に任意の文字を追加したい場合に便利です。

基本構文

str_pad(str, len, pad_str, pad_type)

パラメータの詳細

• str − パディング対象となる元の文字列を指定します。

• len − パディング後の新しい文字列の長さを指定します。

• pad_str − 埋め合わせに使用する文字列（パディング文字）を指定します。省略した場合は半角スペースが使用されます。

• pad_type − 文字列のどちら側にパディングするかを指定します。省略可能です。

• pad_typeに指定できる定数は以下の3種類です。

  • STR_PAD_BOTH − 文字列の両側にパディングします。埋める長さが偶数でない場合、余った分は右側に追加されます。

  • STR_PAD_LEFT − 文字列の左側にパディングします。

  • STR_PAD_RIGHT − 文字列の右側にパディングします（デフォルト値）。

戻り値

str_pad()関数は、指定した長さまでパディングされた文字列を返します。元の文字列がすでに指定した長さ以上の場合は、そのまま元の文字列が返されます。

使用例1：STR_PAD_LEFT（左側にパディング）

以下の例では、文字列「Welcome」の左側を「$」で埋めて10文字にしています。

<?php
$s = "Welcome";
echo str_pad($s,10,"$",STR_PAD_LEFT);
?>

出力結果

$$$Welcome

使用例2：STR_PAD_RIGHT（右側にパディング）

次の例では、同じ文字列の右側を「$」で埋めています。

<?php
$s = "Welcome";
echo str_pad($s,10,"$",STR_PAD_RIGHT);
?>

出力結果

Welcome$$$

使用例3：STR_PAD_BOTH（両側にパディング）

最後に、両側にパディングする例です。「Welcome」は7文字なので、3文字分を埋める必要があります。奇数の場合、右側に多くのパディングが適用されます。

<?php
$s = "Welcome";
echo str_pad($s,10,"$",STR_PAD_BOTH);
?>

出力結果

$Welcome$$

まとめ

str_pad()関数を使うことで、固定桁数での表示揃えやIDのゼロ埋めなど、文字列の整形を簡単に行うことができます。第4引数のpad_typeを活用すれば、左寄せ・右寄せ・中央寄せのパディングを柔軟に制御できるので、ぜひ覚えておきましょう。