PHPのstr_padで文字列を埋める方法｜0埋め・左右両側・多バイトの注意

str_pad(string $input, int $length, string $pad = " ", int $type = STR_PAD_RIGHT): string

<?php
echo str_pad("Hello", 10);                    // "Hello     "（右、既定）
echo str_pad("World", 10, "*", STR_PAD_LEFT);  // "*****World"（左）
echo str_pad("PHP", 10, "#", STR_PAD_BOTH);    // "###PHP####"（両側）

<?php
echo str_pad("7", 3, "0", STR_PAD_LEFT);   // "007"
echo str_pad("42", 5, "0", STR_PAD_LEFT);  // "00042"

// ファイル連番などに
$no = 8;
echo "file" . str_pad($no, 3, "0", STR_PAD_LEFT) . ".txt"; // file008.txt

<?php
// "あ" は3バイト。5バイトに埋めるので、追加されるスペースは2個だけ
echo "[" . str_pad("あ", 5) . "]"; // [あ  ] （見た目は3文字幅。5文字幅にならない）
echo strlen(str_pad("あ", 5));     // 5（バイト数）

<?php
function mb_str_pad(string $str, int $length, string $pad = " ", int $type = STR_PAD_RIGHT): string {
    $diff = $length - mb_strlen($str);
    if ($diff <= 0) return $str;

    if ($type === STR_PAD_LEFT) {
        return str_repeat($pad, $diff) . $str;
    } elseif ($type === STR_PAD_BOTH) {
        $left = intdiv($diff, 2);
        return str_repeat($pad, $left) . $str . str_repeat($pad, $diff - $left);
    }
    return $str . str_repeat($pad, $diff); // RIGHT
}

echo "[" . mb_str_pad("あ", 5) . "]"; // [あ    ]（文字数で5に揃う）

<?php
$rows = [
    ["Name", "Age", "Job"],
    ["Alice", "30", "Engineer"],
    ["Bob", "22", "Designer"],
];

foreach ($rows as $i => $row) {
    echo str_pad($row[0], 10) . str_pad($row[1], 5) . $row[2] . "\n";
    if ($i === 0) echo str_repeat("-", 25) . "\n";
}