PHP: полный мануал с примерами, функциями и ООП

Как записать маленький расчёт так, чтобы его прочитали

Задача — посчитать две упаковки чая по 150 рублей. Хорошее оформление позволяет увидеть цену, количество и результат ещё до чтения пояснения. Имя выбирайте по смыслу: $unitPriceRubles лучше $a, когда важно, что это цена одной штуки именно в рублях. В этих вводных примерах суммы целые; расчёт дробных денег отдельно разобран ниже.

<?php
$unitPriceRubles = 150;
$quantity = 2;

// В учебном каталоге цены целые; доставка считается отдельно.
$totalRubles = $unitPriceRubles * $quantity;
echo 'Товары: ', $totalRubles, " руб.\n";

Товары: 300 руб.

Одна инструкция — одна строка; внутри фигурных скобок используйте четыре пробела отступа. { } ограничивают блок, а отступ помогает человеку увидеть его. PHP не определяет вложенность количеством пробелов. Короткий комментарий начинается с //, многострочный — с /* и заканчивается */. Не прячьте старую программу в комментариях: историю хранит система контроля версий.

Попробуйте сами. Добавьте $deliveryRubles = 50 и назовите итог с доставкой.

Дальше расчёт получает имя через собственную функцию. Затем вернитесь к разделам ниже: там форматирование, комментарии и PHPDoc применены к коду с ветвлениями и массивами.

Код читают чаще, чем пишут

Представьте дежурство в магазине: покупателю начислена неверная скидка, и другой разработчик открывает ваш файл ночью. Название calculateDiscountKopecks объясняет больше, чем process2. Переменная $deliveryTimeoutSeconds показывает единицу измерения, $isPaid — логическое состояние, $orderIds — набор идентификаторов. Удачное имя сокращает число вопросов к автору. Не нужно механически делать каждое имя длинным: $index понятен в коротком цикле, но $data недостаточно для аргумента, где ожидается проверенный заказ.

Разделяйте получение данных, проверку, расчет и вывод. Функция расчета не должна незаметно читать $_POST или печатать HTML: иначе ее нельзя без изменений использовать в CLI-импорте или тесте. Начинайте с небольших функций по одной ответственности. Десяток строк, называющих бизнес-правило, обычно легче поддерживать, чем одно вложенное выражение на три строки.

Единый стиль без ручной борьбы с пробелами

PSR-12 задает распространенную основу: четыре пробела вместо табуляции, последовательное оформление скобок, пробелы у операторов, один оператор на строку. Сохраните UTF-8 без BOM, переносы LF и завершающий перевод строки. Для существующего проекта важнее согласованность с его стандартом; массовое переформатирование не смешивают с исправлением логики. Настройте форматтер в редакторе и проверку в CI, чтобы спор о пробелах не занимал ревью.

<?php
declare(strict_types=1);

function deliveryPriceKopecks(int $subtotalKopecks, bool $isPickup): int
{
    if ($subtotalKopecks < 0) {
        throw new InvalidArgumentException('Сумма не может быть отрицательной');
    }
    if ($isPickup || $subtotalKopecks >= 500000) {
        return 0;
    }

    return 29900;
}
echo deliveryPriceKopecks(250000, false), "\n";
echo deliveryPriceKopecks(250000, true), "\n";

29900
0

Комментарий объясняет причину и ограничение

Комментарий «увеличиваем счетчик» рядом с ++$count повторяет синтаксис. Полезнее: «поставщик считает повторную отправку новым заказом, поэтому используем сохраненный ключ идемпотентности». Пишите, какое внешнее ограничение или бизнес-решение объясняет необычный код. Ссылку на задачу добавляйте вместе с краткой причиной: одна ссылка теряет смысл после смены трекера. TODO должен содержать конкретное условие завершения, иначе он становится постоянной частью архитектуры.

<?php
declare(strict_types=1);

/**
 * @param list<array{priceKopecks: int, quantity: int}> $items
 * Скидка применяется к заказу целиком, чтобы сумма строк не расходилась с чеком.
 */
function subtotalKopecks(array $items): int
{
    $subtotal = 0;
    foreach ($items as $item) {
        $subtotal += $item['priceKopecks'] * $item['quantity'];
    }

    return $subtotal;
}
echo subtotalKopecks([['priceKopecks' => 15000, 'quantity' => 3]]), "\n";

45000

Что проверять перед передачей кода

• Можно ли понять вход, результат и единицы измерения без просмотра всей программы?
• Отделены ли ошибки ввода от недоступности сервиса?
• Не скрывает ли короткое имя важное различие: сырой текст и безопасный HTML, ID и порядковый номер?
• Не остались ли закомментированные пароли, var_dump и отладочные выходы?
• Есть ли тест границы, а не только обычного числа?

Документируйте публичный контракт: исключения, допустимые диапазоны, изменение переданного объекта, побочные эффекты. Для стандартного int $count не требуется комментарий «целое число». Для массива строк поставщика полезна форма данных и объяснение, какие поля необязательны. Избыточные комментарии устаревают так же, как код; удаляйте неверное объяснение одновременно с изменением реализации.

Попробуйте сами. Переименуйте $t и $a в функции, которая ждет ответ API и ограничивает число повторов. Добавьте один полезный комментарий.