Как добавить ведущие нули к числу в PHP: 4 рабочих способа

Онлайн-тренажер Python для начинающих

Изучайте Python легко и без перегрузки теорией. Решайте практические задачи с автоматической проверкой, получайте подсказки на русском языке и пишите код прямо в браузере — без необходимости что-либо устанавливать.

Начать курс

Ведущие нули в PHP: почему это важно и как не ошибиться

Представьте ситуацию: вы пишете интернет-магазин, и вам нужно отобразить номер заказа. Клиент видит «Заказ № 42», а рядом с ним — «Заказ № 7». Выглядит неряшливо, правда? Сразу хочется сделать «Заказ № 00042» и «Заказ № 00007». Или вы работаете с датами: месяц январь должен быть 01, а не просто 1. Вот тут и пригождаются ведущие нули в PHP.

Вопрос «Formatting a number with leading zeros in PHP» — один из самых популярных на Stack Overflow. Тысячи разработчиков ищут ответ, как превратить число 5 в 005 или 42 в 0042. Казалось бы, мелочь, но без правильного подхода можно получить баги, особенно при работе с базами данных или API.

В этой статье я покажу вам 4 рабочих способа добавить ведущие нули к числу в PHP. Вы узнаете, чем отличается sprintf от str_pad, когда использовать printf, и почему старый добрый substr тоже может выручить. Поехали!

Способ 1: sprintf — король форматирования

Функция sprintf — это, пожалуй, самый элегантный способ решить задачу. Она пришла в PHP из языка C и умеет форматировать строки по шаблону. Для ведущих нулей используется спецификатор %0Nd, где N — общая длина числа вместе с нулями.

Базовый пример

<?php
$number = 7;
$formatted = sprintf("%05d", $number);
echo $formatted; // Выведет: 00007
?>

Разберём шаблон "%05d":

% — начало спецификатора
0 — заполнять нулями, а не пробелами
5 — общая длина строки (5 символов)
d — целое число (decimal)

Работа с отрицательными числами

Обратите внимание: если число отрицательное, ведущие нули появятся после знака минус:

<?php
$number = -42;
echo sprintf("%05d", $number); // Выведет: -0042
?>

Динамическая длина

Если нужная длина заранее не известна, можно использовать * в шаблоне:

<?php
$number = 123;
$length = 8;
echo sprintf("%0{$length}d", $number); // Выведет: 00000123
// Или через *
echo sprintf("%0*d", $length, $number); // Выведет: 00000123
?>

Плюсы: гибкость, читаемость, поддержка разных типов данных.
Минусы: нужно помнить синтаксис спецификаторов.

Способ 2: str_pad — простота и наглядность

Функция str_pad работает на уровне строк. Вы берёте число, преобразуете его в строку и «дополняете» нулями слева до нужной длины. Это интуитивно понятно даже новичку.

Синтаксис

<?php
$number = 7;
$formatted = str_pad($number, 5, "0", STR_PAD_LEFT);
echo $formatted; // Выведет: 00007
?>

Параметры:

$number — входная строка (число автоматически конвертируется)
5 — желаемая длина результата
"0" — символ для заполнения
STR_PAD_LEFT — заполнять слева (есть ещё STR_PAD_RIGHT и STR_PAD_BOTH)

Важный нюанс: если число длиннее

Если исходное число уже длиннее заданной длины, str_pad просто вернёт его как есть:

<?php
echo str_pad(123456, 3, "0", STR_PAD_LEFT); // Выведет: 123456 (не обрезает!)
?>

Сравнение с sprintf

<?php
$number = 42;
echo sprintf("%05d", $number);   // 00042
echo str_pad($number, 5, "0", STR_PAD_LEFT); // 00042
// Результат одинаковый, но код читается по-разному
?>

Плюсы: очевидный синтаксис, не нужно запоминать спецификаторы.
Минусы: работает только со строками, нет встроенного контроля типа.

Способ 3: printf — для прямого вывода

Если вам не нужно сохранять результат в переменную, а достаточно сразу вывести на экран, используйте printf. Это «брат» sprintf, но без возврата строки.

<?php
$number = 7;
printf("%05d", $number); // Сразу выведет: 00007
?>

Отлично подходит для шаблонов вёрстки:

<?php
$orderId = 42;
echo "Ваш номер заказа: ";
printf("%06d", $orderId); // Выведет: 000042
?>

Плюсы: лаконично для вывода, нет лишней переменной.
Минусы: нельзя использовать результат повторно (только вывод).

Способ 4: substr — хак для старых версий

Этот метод — скорее «дедовский» способ, но он работает и иногда встречается в легаси-коде. Идея: берём строку из единицы и нужное количество нулей, добавляем число, а потом обрезаем справа на нужную длину.

<?php
function leadingZeros($number, $length) {
    return substr("0000000000" . $number, -$length);
}
echo leadingZeros(7, 5); // Выведет: 00007
echo leadingZeros(42, 5); // Выведет: 00042
?>

Как это работает: