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

Местные значения функции: подготовить подпись, сохранив исходную цену

В каталоге цена товара 150 рублей. Для оформления доставки нужно получить 200, сохранив исходную цену 150 для карточки. Функция получает значение через аргумент и работает со своим местным параметром. Одинаковое написание переменной внутри и снаружи не связывает их автоматически. Сначала изучены вызов, параметр и return.

<?php
function addDelivery($priceRubles, $deliveryRubles)
{
    $priceRubles = $priceRubles + $deliveryRubles;
    return $priceRubles;
}
$priceRubles = 150;
$payable = addDelivery($priceRubles, 50);
echo 'Цена в каталоге: ', $priceRubles, ' руб.', "\n";
echo 'К оплате с доставкой: ', $payable, ' руб.', "\n";

Цена в каталоге: 150 руб.
К оплате с доставкой: 200 руб.

Функция не видит обычную внешнюю переменную лишь потому, что её объявление написано ниже присваивания. Условие if и цикл foreach, напротив, сами по себе не создают такой отдельной области. Следующий пример проверяет место создания подписи, пока не вводя global.

<?php
$stock = 2;
$caption = 'Нет в наличии';
if ($stock > 0) {
    $caption = 'В наличии: ' . $stock . ' уп.';
}
echo $caption, "\n";

В наличии: 2 уп.

global: явная связь с состоянием одного выполнения

В старом обработчике несколько действий отмечают подготовленные документы общим счётчиком. Конструкция global $preparedCount; связывает местное имя с одноимённой переменной глобальной области. После неё изменение действительно видно снаружи. Эта функция выполняет побочное действие и не возвращает готовую подпись.

<?php
$preparedCount = 0;
function markPreparedDocument(): void
{
    global $preparedCount;
    $preparedCount = $preparedCount + 1;
}
markPreparedDocument();
markPreparedDocument();
echo 'Подготовлено документов: ', $preparedCount, "\n";

Подготовлено документов: 2

У этого решения скрытая зависимость от имени preparedCount и общего состояния. Для двух независимых наборов удобнее явный параметр и возвращённое значение либо отдельный объект состояния после изучения ООП. global не разделяет память между всеми посетителями сайта и не сохраняет число в базе. Ниже подробно разобраны $GLOBALS, include, static и ссылочные крайние случаи.

Граница функции — граница имен

Сегодня скрипт считает цену для одного магазина, завтра — для двух магазинов с разными настройками. Если функция незаметно берёт ставку из общей переменной, результат зависит от того, кто изменил её последним. Если ставка передана аргументом, два расчёта можно выполнить рядом и проверить отдельно. Область видимости объясняет, откуда конкретная функция вообще получает данные, а не просто задаёт ещё одно правило синтаксиса.

Вне функций переменная относится к глобальной области текущего выполнения. Внутри функции есть собственная локальная область: одноименное $price в функции не обязано быть ценой из вызывающего кода. Блоки if и foreach сами по себе не создают отдельной области переменных. После цикла переменная элемента остается определенной, а после foreach по ссылке может оставаться привязанной к массиву. Файл include наследует область того места, где его подключили; отдельный файл не равен изоляции.

<?php
function grossPrice(int $netKopecks, int $taxPercent): int {
    $extraKopecks = intdiv($netKopecks * $taxPercent, 100);
    return $netKopecks + $extraKopecks;
}
$firstShop = grossPrice(10000, 20);
$secondShop = grossPrice(10000, 0);
echo 'Магазин A, итог: ', $firstShop, ' коп.', "\n";
echo 'Магазин B, итог: ', $secondShop, ' коп.', "\n";
echo 'Разница: ', $firstShop - $secondShop, ' коп.', "\n";

Магазин A, итог: 12000 коп.
Магазин B, итог: 10000 коп.
Разница: 2000 коп.

Где global действительно встречается

Разберите вложенный вызов в конце примера справа налево по зависимостям: сначала legacyCurrency читает настройки и возвращает строку RUB; затем priceLabel получает 15000 и эту строку в своих параметрах; intdiv(15000,100) даёт 150, конкатенация формирует «150 RUB», return передаёт её внешнему echo. Такой формат допускает только целые рубли: остаток копеек эта учебная функция не показывает.

В процедурном приложении или WordPress-плагине global бывает частью уже существующего API: например, $wpdb предоставляет объект доступа к базе. Адаптер к такому окружению может прочитать глобальную зависимость и передать ее дальше обычным аргументом или в конструктор. Это осознанная граница совместимости. Делать глобальными корзину, текущего покупателя и промежуточные суммы ради экономии параметров неудобно: порядок вызовов начинает менять результат, а тесты вынуждены восстанавливать скрытое состояние.

<?php
declare(strict_types=1);

$legacyShopSettings = ['currency' => 'RUB'];
function legacyCurrency(): string
{
    global $legacyShopSettings;
    $currency = $legacyShopSettings['currency'] ?? null;
    if (!is_string($currency)) {
        throw new RuntimeException('Не настроена валюта');
    }

    return $currency;
}
function priceLabel(int $kopecks, string $currency): string
{
    return intdiv($kopecks, 100) . ' ' . $currency;
}
echo priceLabel(15000, legacyCurrency()), "\n";

150 RUB

$GLOBALS дает доступ к глобальной таблице по имени, а global связывает локальное имя с глобальной переменной. Это не механизм постоянного хранения между запросами и не способ сделать переменную видимой во всех функциях разом. Суперглобальные $_GET, $_POST, $_SERVER доступны без global, но их содержимое все равно следует принять и проверить на границе приложения. Не передавайте весь $_REQUEST глубоко в расчет заказа.

Локальная static: память между вызовами

<?php
function nextLocalNumber(): int {
    static $number = 0;
    $number += 1;
    return $number;
}
$firstLine = nextLocalNumber();
echo $firstLine, '. Проверен адрес', "\n";
$secondLine = nextLocalNumber();
echo $secondLine, '. Подготовлена упаковка', "\n";

1. Проверен адрес
2. Подготовлена упаковка

Кеширование через static допустимо, когда ключ учитывает все входы и понятно время жизни. Если в длинном воркере хранить там «текущего клиента», следующая задача может получить старые данные. Лучше хранить состояние в объекте с явным жизненным циклом или передавать контекст задачи. Константа подходит для неизменного правила, конфигурационный объект — для настроек среды; ни тот ни другой не должен прятать изменяемую корзину.

Выбор и проверка

Попробуйте сами. Две функции печатают цены, используя global $currency. Как проверить RUB и EUR без влияния одного теста на другой?