Форматирование числа с ведущими нулями в PHP

Решение: функция sprintf() и её друзья

Ваша задача — классический случай форматирования чисел с фиксированной шириной поля. В PHP есть несколько способов, но самый правильный и гибкий — использовать функцию sprintf() (или её брата printf() для прямого вывода).

1. Основной способ через sprintf()

<?php
$number = 7;
echo sprintf("%04d", $number); // выведет "0007"

$number = 123;
echo sprintf("%04d", $number); // выведет "0123"

$number = 12345;
echo sprintf("%04d", $number); // выведет "12345" (число длиннее 4 символов — без изменений)
?>

Разбираем форматную строку "%04d":

• % — начало спецификатора формата
• 0 — символ-заполнитель (ноль вместо пробела по умолчанию)
• 4 — минимальная ширина поля (если число короче — дополняется нулями слева)
• d — тип аргумента: целое число (decimal)

Если число длиннее указанной ширины, оно выводится полностью, без обрезания. Это логично: вы же не хотите потерять данные.

2. Альтернатива: str_pad()

Ваш вариант с str_pad() тоже рабочий, но менее удобный для чисел:

<?php
$number = 7;
echo str_pad($number, 4, "0", STR_PAD_LEFT); // "0007"
?>

Важно! str_pad() работает со строками. Если передать число, PHP автоматически преобразует его в строку. Это нормально, но:

• Нельзя управлять десятичными знаками
• Нет встроенной обработки отрицательных чисел (они будут выглядеть странно)

3. Для дробных чисел

Если нужно форматировать числа с плавающей точкой, используйте %f:

<?php
$price = 5.5;
echo sprintf("%08.2f", $price); // "00005.50"
// 8 символов всего, 2 знака после запятой, остальное — нули слева
?>

4. Сохранение результата в переменную

Если вам нужно не вывести, а сохранить форматированное число:

<?php
$orderNumber = 42;
$formatted = sprintf("%04d", $orderNumber);
echo "Заказ №{$formatted}"; // "Заказ №0042"
?>

5. Обработка отрицательных чисел

sprintf() корректно обрабатывает отрицательные числа:

<?php
echo sprintf("%04d", -7); // выведет "-007" (минус считается за символ)
?>

Итог: что выбрать?

• sprintf() — универсальное решение для любых чисел. Рекомендую его.
• str_pad() — проще для понимания новичками, но менее гибкий.
• number_format() — не подходит, она для разделителей тысяч и десятичных знаков, а не для ведущих нулей.

Совет: запомните формат "%04d" — он часто встречается в реальных проектах: номера заказов, ID, артикулы, коды товаров.

<?php
function formatOrderNumber($number, $length = 4) {
    $numberStr = (string)$number;
    if (strlen($numberStr) >= $length) {
        return $numberStr; // не дополняем, если число уже длиннее
    }
    return str_pad($numberStr, $length, "0", STR_PAD_LEFT);
}

echo formatOrderNumber(5);    // "0005"
echo formatOrderNumber(123);  // "0123"
echo formatOrderNumber(12345); // "12345" (без изменений)
?>