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

<?php
$recipient = 'Анна';
echo $recipient;

Анна

<?php открывает PHP-код. Присваивание ничего не выводит. Команда языка echo отправляет прочитанное значение в вывод. Сохраните весь пример в отдельный .php и запустите способом из главы установки; в консоли появится ровно Анна, без кавычек.

<?php
$recipient = 'Анна';
echo 'Получатель: ', $recipient, "\n";
echo $recipient, ', заказ готов к выдаче', "\n";

Получатель: Анна
Анна, заказ готов к выдаче

Первый echo получает три части: подпись, Анна, перевод строки. Второй читает то же значение снова. Чтение не опустошает переменную. Если заменить единственную Анна в присваивании на Мария, оба обращения будут к Марии.

<?php
$recipient = 'Анна';
echo 'Было: ', $recipient, "\n";
$recipient = 'Мария';
echo 'Стало: ', $recipient, "\n";

Было: Анна
Стало: Мария

Во время первого echo значение — Анна. Следующее присваивание заменило его на Мария. Во время второго echo читается новое значение. Программа не хранит историю автоматически: слово «Было» осталось только в уже сформированном выводе.

<?php
$recipient = 'Анна';
$originalRecipient = $recipient;
$recipient = 'Мария';
echo 'Получатель изменён: ', $originalRecipient, ' → ', $recipient, "\n";

Получатель изменён: Анна → Мария

originalRecipient хранит Анна и не следит за будущим recipient. Обе переменные содержат строки; дальнейшая замена одной не меняет другую. Получилось готовое понятное сообщение, а не только наблюдение внутреннего состояния.

<?php
$orderNumber = 42;
$recipient = 'Мария';
echo 'Заказ ', $orderNumber, ': получатель ', $recipient, "\n";

Заказ 42: получатель Мария

42 записано без кавычек как число; Мария — в кавычках как текст. echo умеет показывать оба. Использование значения в подписи ещё не объясняет все операции его типа — это следующий шаг.

<?php
$name = 'Анна';
$Name = 'Мария';
$order2 = 42;
$_draft = 'Черновик';
echo $name, ' / ', $Name, "\n";
echo $order2, ' / ', $_draft, "\n";

Анна / Мария
42 / Черновик

name и Name — разные имена. Цифра внутри order2 допустима. Подчёркивание в начале тоже допустимо, но само по себе не делает переменную закрытой или системной.

<?php
$quantity = 2;
$temperature = 18.5;
$productCode = '002';
$isPaid = false;
$comment = null;
echo $quantity, "\n";
echo $temperature, "\n";
echo $productCode, "\n";

2
18.5
002

2 — целое число, 18.5 — дробное, "002" — текстовый код с важными ведущими нулями. false — логическое «нет», null — явно выбранное отсутствие значения. Последние два значения пока не печатаем: сначала узнаём их запись и смысл.

<?php
$answer = 2;
echo $answer, "\n";
$answer = 'Два товара';
echo $answer, "\n";

2
Два товара

Обычной переменной можно присвоить значение другого типа. Возможность языка не означает хороший стиль для каждой задачи: quantity лучше оставлять количеством, а подпись хранить в quantityLabel.

<?php
$name = 'Анна';
echo '$name', "\n";
echo "Привет, $name", "\n";
echo 'Привет, ' . $name, "\n";
echo "{$name}: заказ готов", "\n";

$name
Привет, Анна
Привет, Анна
Анна: заказ готов

Одинарные кавычки сохраняют буквальный $name. Двойные позволяют подставить значение; фигурные скобки точно отделяют имя. Точка соединяет строки. Запятая после echo выводит следующий фрагмент и не входит в текст.

<?php
if (isset($recipient)) {
    echo 'Получатель: ', $recipient, "\n";
} else {
    echo "Получатель пока не записан\n";
}
$recipient = 'Анна';
if (isset($recipient)) {
    echo 'Получатель: ', $recipient, "\n";
}
$recipient = null;
if (!isset($recipient)) {
    echo "Имя ещё предстоит уточнить\n";
}
$recipient = 'Мария';
unset($recipient);
if (!isset($recipient)) {
    echo "Временное имя удалено\n";
}

Получатель пока не записан
Получатель: Анна
Имя ещё предстоит уточнить
Временное имя удалено

Вначале recipient не существует; isset даёт false без чтения неопределённого значения. После записи Анна даёт true, и имя попадает в вывод. Null делает isset ложным, но не удаляет само имя. Unset удаляет имя. Знак ! означает отрицание: !isset истинно, когда isset ложно. Последующие ветви не пытаются читать удалённое значение.

<?php
$stock = 0;
if (empty($stock)) {
    echo "Ошибочная подпись: остаток не заполнен\n";
}
if (isset($stock)) {
    echo 'Верная подпись: осталось ', $stock, ' шт.', "\n";
}
$formStock = '0';
if (empty($formStock)) {
    echo "Строка 0 тоже считается ложной для empty\n";
}
$space = ' ';
if (!empty($space)) {
    echo "Пробел проходит проверку !empty\n";
}
$word = 'false';
if (!empty($word)) {
    echo "Слово false проходит проверку !empty\n";
}

Ошибочная подпись: остаток не заполнен
Верная подпись: осталось 0 шт.
Строка 0 тоже считается ложной для empty
Пробел проходит проверку !empty
Слово false проходит проверку !empty

Первое сообщение намеренно неверно по смыслу магазина: empty объединяет число 0 с отсутствием. Вторая ветка использует заданный 0 в реальной подписи. Пустой ввод, выключенный флаг и нулевой остаток требуют разных правил. !empty проверяет логическую истинность, а не осмысленность текста: один пробел и слово false проходят эту проверку.

<?php
$caption = $missingCaption ?? 'Каталог';
echo $caption, "\n";
$caption = '';
echo '[', $caption ?? 'Каталог', "]\n";
$caption = null;
echo $caption ?? 'Каталог', "\n";

Каталог
[]
Каталог

?? берёт правый вариант, если слева нет переменной либо там null. Пустая строка остаётся пустой. Запасное значение не записывается в $missingCaption автоматически.

<?php
$basket = ['Чай', 'Кофе'];
echo 'Первый товар: ', $basket[0], "\n";
echo 'Второй товар: ', $basket[1], "\n";
$basket[] = 'Какао';
echo 'Добавленный товар: ', $basket[2], "\n";

Первый товар: Чай
Второй товар: Кофе
Добавленный товар: Какао

Квадратные скобки справа от = создают массив значений, запятая разделяет их. При таком списке PHP назначил ключи 0 и 1. Скобки [0] после basket читают одно значение по ключу. Пустые [] слева от = добавляют следующее значение; здесь его ключ 2. Basket — одно имя массива, а не три независимо созданные переменные.

<?php
$newBasket[] = 'Чай';
echo 'Автоматически созданный список: ', $newBasket[0], "\n";
$profile = ['name' => 'Анна', 'note' => null];
echo 'Покупатель: ', $profile['name'], "\n";
if (array_key_exists('note', $profile)) {
    echo "Поле комментария предусмотрено в карточке\n";
}
if (!isset($profile['note'])) {
    echo "Текст комментария пока отсутствует\n";
}

Автоматически созданный список: Чай
Покупатель: Анна
Поле комментария предусмотрено в карточке
Текст комментария пока отсутствует

Array_key_exists получает сначала ключ note, потом массив profile и возвращает true: ключ есть. Isset для того же элемента возвращает false, потому что значение null. Знак => связывает ключ с его значением. Автоматическое создание newBasket разрешено, но явное начальное [] помогает не смешать новый список с ранее существовавшим состоянием.

<?php
$name = 'Анна';
$alias =& $name;
$alias = 'Мария';
echo $name, "\n";
$name = 'Ольга';
echo $alias, "\n";
unset($alias);
$name = 'Ирина';
echo $name, "\n";

Мария
Ольга
Ирина

=& создаёт связь имён. Изменение через любое из них видно через другое. unset удаляет alias, сохраняя name. Ссылка PHP — не веб-ссылка и не адрес для арифметики.

<?php
$name = 'Анна';
function showLocalName() {
    $name = 'Мария';
    echo $name, "\n";
}
showLocalName();
echo $name, "\n";

Мария
Анна

function объявляет действие, фигурные скобки ограничивают его тело. showLocalName() вызывает действие. Местный name не изменил внешний. Сама пара фигурных скобок произвольного if не создаёт такую же отдельную область переменных.

<?php
$name = 'Анна';
function greet($personName) {
    echo 'Здравствуйте, ', $personName, "\n";
}
greet($name);

Здравствуйте, Анна

personName — местное имя входа функции, параметр. В greet($name) PHP читает внешнее значение и передаёт его внутрь. Функции не приходится искать данные по глобальному имени.

<?php
$processed = 0;
function markProcessed(): void
{
    global $processed;
    $processed = $processed + 1;
}
markProcessed();
markProcessed();
echo 'После первых двух документов: ', $processed, "\n";
function addOneMore(): void
{
    $GLOBALS['processed'] = $GLOBALS['processed'] + 1;
}
addOneMore();
echo 'Итог для журнала: обработано ', $processed, ' документа', "\n";

После первых двух документов: 2
Итог для журнала: обработано 3 документа

Функции ничего полезного не возвращают (: void); они намеренно меняют общее число. Global связывает местное имя processed с глобальным; $GLOBALS читает ту же переменную по строковому ключу без $. Вызывающий код использует изменённое состояние в отчёте. Самих документов пример не создаёт: он только отмечает уже выполненные действия.

<?php
function connectGlobalName(): void
{
    global $reportTitle;
}
connectGlobalName();
if (array_key_exists('reportTitle', $GLOBALS)) {
    echo "Имя reportTitle создано в глобальной области\n";
}
if (!isset($reportTitle)) {
    echo "Заголовок ещё не готов: используем общий вариант\n";
}
echo 'Заголовок отчёта: ', $reportTitle ?? 'Сводка заказов', "\n";

Имя reportTitle создано в глобальной области
Заголовок ещё не готов: используем общий вариант
Заголовок отчёта: Сводка заказов

Вызов создал имя со значением null. Ключ в GLOBALS есть, но isset ложен. Оператор ?? выбирает общую строку для вывода, не присваивая её reportTitle. Явная инициализация в одном месте понятнее случайного появления через global.

<?php
$caption = 'Общий каталог';
require __DIR__ . '/caption.php';
function showSaleCaption() {
    $caption = 'Распродажа';
    require __DIR__ . '/caption.php';
}
showSaleCaption();
echo 'Снаружи: ', $caption, "\n";

Общий каталог
Распродажа
Снаружи: Общий каталог

require выполняет второй PHP-файл; __DIR__ — папка текущего файла. caption.php включён в архив и только выводит $caption. При первом подключении он видит глобальный caption, при втором — местный caption функции.

<?php
function nextLineNumber(): int
{
    static $number = 0;
    $number = $number + 1;
    return $number;
}
$first = nextLineNumber();
echo $first, '. Чай — 2 упаковки', "\n";
$second = nextLineNumber();
echo $second, '. Кофе — 1 упаковка', "\n";
echo nextLineNumber(), '. Какао — 3 упаковки', "\n";

1. Чай — 2 упаковки
2. Кофе — 1 упаковка
3. Какао — 3 упаковки

Первый вызов устанавливает static number = 0, увеличивает до 1 и возвращает 1 во внешний first. Второй сохраняет прежнее местное состояние, увеличивает до 2 и возвращает его в second. Третий return 3 используется непосредственно как часть echo. Если заменить static обычным присваиванием 0, все строки получат номер 1. Это нумерация данного выполнения, не уникальный номер заказа во всех запросах.

<?php
function showDepth($remaining) {
    static $depth = 0;
    $depth = $depth + 1;
    echo $depth, "\n";
    if ($remaining > 1) {
        showDepth($remaining - 1);
    }
    $depth = $depth - 1;
}
showDepth(2);
showDepth(1);

1
2
1

if выполняет блок при истинном условии; > сравнивает числа. Первый вызов входит в себя ещё раз, затем каждый уровень уменьшает depth. Второй обход снова начинается с 1. При исключениях восстановление состояния надо гарантировать; часто проще передавать depth параметром.

<?php
function createCounter() {
    return function () {
        static $number = 0;
        $number = $number + 1;
        return $number;
    };
}
$firstCounter = createCounter();
$secondCounter = createCounter();
echo $firstCounter(), "\n";
echo $firstCounter(), "\n";
echo $secondCounter(), "\n";

1
2
1

Безымянная функция возвращается как значение и вызывается через переменную. У двух созданных Closure собственные счётчики. Создание нового замыкания перед каждым вызовом каждый раз начнёт отсчёт заново.

<?php
class BaseCounter {
    public static function next() {
        static $number = 0;
        $number = $number + 1;
        return $number;
    }
}
class ChildCounter extends BaseCounter {}
echo BaseCounter::next(), "\n";
echo ChildCounter::next(), "\n";

1
2

Продолжение после ООП: ChildCounter наследует метод, не переопределяя его. С PHP 8.1 такой метод разделяет static с родителем. static перед function означает статический метод, перед $number — его местную память.

<?php
$caption = 'Старый';
function rebindLocalAlias() {
    global $caption;
    $local = 'Новый';
    $caption =& $local;
}
rebindLocalAlias();
echo $caption, "\n";
function assignGlobalValue() {
    global $caption;
    $caption = 'Новый';
}
assignGlobalValue();
echo $caption, "\n";

Старый
Новый

global связал местное имя с глобальным. Новое =& перенаправило местный псевдоним на другую переменную; прежняя глобальная не изменилась. Обычное = во второй функции записало значение через сохранённую связь.

<?php
function rebindStatic() {
    static $saved = null;
    echo $saved ?? 'null', "\n";
    $local = 9;
    $saved =& $local;
}
rebindStatic();
rebindStatic();
function assignStatic() {
    static $saved = null;
    echo $saved ?? 'null', "\n";
    $saved = 9;
}
assignStatic();
assignStatic();

null
null
null
9

Новое связывание местного имени не записало 9 в сохраняемое static-хранилище. Обычное присваивание во второй функции сохранило его. Это правило чтения редкого кода, не рекомендуемое устройство кэша.

<?php
$caption = 'Каталог';
function removeLocalAlias() {
    global $caption;
    unset($caption);
}
removeLocalAlias();
echo $caption, "\n";
function removeGlobalName() {
    unset($GLOBALS['caption']);
}
removeGlobalName();
var_dump(isset($caption));

Каталог
bool(false)

Первый unset снял местное имя, созданное global. Второй явно удалил глобальную переменную. У параметра по ссылке удаление местного имени тоже не удаляет переменную вызывающего кода.

<?php
$field = 'city';
$$field = 'Казань';
echo $city, "\n";
echo ${$field}, "\n";
${'delivery-city'} = 'Пермь';
echo ${'delivery-city'}, "\n";

Казань
Казань
Пермь

$field даёт строку city; дополнительный $ использует её как имя переменной. Фигурные скобки точно отделяют выражение имени. Такая форма технически адресует и имя с дефисом, недоступное обычной записью. Для полей формы обычно понятнее массив.

<?php
$fields = ['city'];
$city = 'Казань';
echo ${$fields[0]}, "\n";
$name = 'cities';
$cities = ['Казань', 'Пермь'];
echo ${$name}[1], "\n";
$data = ['city' => 'Казань'];
$key = 'city';
echo $data[$key], "\n";

Казань
Пермь
Казань

Сначала fields[0] даёт имя city. Во втором случае name выбирает массив cities, затем [1] — его элемент. Последний вариант хранит данные в одном явном массиве и обычно проще.

<?php
$record = (object) [
    'city' => 'Казань',
    'delivery-city' => 'Пермь',
    'labels' => ['основной', 'запасной'],
];
$property = 'city';
echo $record->$property, "\n";
echo $record->{'delivery-' . $property}, "\n";
$property = 'labels';
echo $record->{$property}[1], "\n";

Казань
Пермь
запасной

(object) создаёт простую запись stdClass, -> читает свойство. Имя property берётся из текущей области кода. Скобки ограничивают составное имя; [1] применяется к массиву в свойстве. Такие имена могут прийти из JSON или XML.

<?php
parse_str('name=Anna&quantity=2&filters[color][]=green&filters[color][]=blue', $query);
echo $query['name'], "\n";
var_dump($query['quantity']);
echo $query['filters']['color'][0], "\n";
echo $query['filters']['color'][1], "\n";

Anna
string(1) "2"
green
blue

parse_str — готовая функция разбора строки параметров URL. Результат она записывает во второй аргумент $query. Это локальный опыт. quantity остаётся строкой; скобки в именах формируют вложенные массивы. Повторное urldecode без причины изменит уже декодированные данные ещё раз.

<form action="greeting.php" method="get">
  <label for="visitor-name">Ваше имя</label>
  <input id="visitor-name" name="name" type="text" maxlength="100">
  <button type="submit">Показать приветствие</button>
</form>

HTML-фрагмент размещают на странице веб-сервера. name задаёт ключ, id связывает поле с label. GET отправляет параметры в URL. maxlength помогает интерфейсу, но не заменяет серверную проверку.

<?php
header('Content-Type: text/html; charset=UTF-8');
$rawName = $_GET['name'] ?? '';
if (!is_string($rawName)) {
    http_response_code(400);
    echo 'Имя должно быть строкой';
    exit;
}
$name = trim($rawName);
if ($name === '' || strlen($name) > 200) {
    http_response_code(400);
    echo 'Укажите имя длиной от 1 до 200 байт';
    exit;
}
echo '<p>Здравствуйте, ',
    htmlspecialchars($name, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'),
    '</p>';

Контекстный HTTP-пример. is_string отклоняет name[]=...; trim убирает крайние пробелы; strlen задаёт предел в байтах; htmlspecialchars кодирует текст для HTML. Это просмотр приветствия без изменения состояния. Для сохраняющей формы дополнительно нужны метод, права, CSRF и остальные правила операции.

<?php
parse_str('first.name=Anna&delivery+city=Kazan&profile[name]tail=Maria&send.x=12&send.y=5', $query);
echo $query['first_name'], "\n";
echo $query['delivery_city'], "\n";
echo $query['profile']['name'], "\n";
echo $query['send_x'], ',', $query['send_y'], "\n";
parse_str('profile[first.name]=Anna&profile[last+name]=Maria', $nested);
echo $nested['profile']['first.name'], ' ', $nested['profile']['last name'], "\n";

Anna
Kazan
Maria
12,5
Anna Maria

У имени верхнего уровня точки и пробелы превращаются в подчёркивания; + обозначает пробел в этой кодировке. Вложенные ключи first.name и last name в опыте сохраняются. Хвост tail после profile[name] игнорируется. Координаты кнопки image становятся send_x/send_y. Выбирайте однозначные HTML name.

<?php
$incoming = ['stock' => '0'];
$rawStock = $incoming['stock'] ?? null;
if ($rawStock === '0') {
    $stock = 0;
    $label = 'Нет в наличии';
} else {
    $stock = null;
    $label = 'Нужно проверить остаток';
}
echo $label, "\n";
var_dump($stock);

Нет в наличии
int(0)

Узкий опыт для "0", не общий валидатор чисел. === проверяет тип и значение, if выбирает ветку, else — другой вариант. Внешний текст и проверенное число получили разные имена. Для прочих количеств нужна полная проверка.