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

Первый код: что PHP выполняет, а что получает читатель

Нужно вывести сообщение магазина. Начнём с одного файла: без переменных, функций, циклов и настроек базы данных. Сохраните пример как example.php в кодировке UTF-8 без BOM и запустите через PHP, как показано в первых шагах. Открытие исходного файла как обычного текста не запускает программу.

PHP читает исходник и выполняет команды в PHP-области. Команда echo добавляет текст в выходной поток. В консоли вы увидите этот текст; при правильно настроенном веб-сервере он станет частью тела HTTP-ответа. Браузер получает результат, а не выполняет этот PHP-код.

<?php
echo 'Магазин открыт';

Магазин открыт

Разбираем каждый знак: тег, echo, кавычки и ;

Текстовые редакторы иногда заменяют прямые кавычки на типографские «ёлочки». В коде строку ограничивают ' или ". Одиночная и двойная кавычки не образуют пару. Двойные кавычки умеют специальные записи: "\n" означает перевод строки, а в одинарных '\n' остаются два символа — обратная косая черта и n.

echo не вставляет пробелы и переводы строк сам. Запятая разделяет выводимые значения: можно передать сначала подпись, затем число. Это список для echo, а не новая инструкция.

<?php
echo 'Заказ: ', 17, "\n";
echo 'Статус: новый', "\n";

Заказ: 17
Статус: новый

Попробуйте сами. Уберите пробел после двоеточия внутри первой строки. Добавит ли echo его обратно?

Полный тег, короткий вывод и старые формы

Для файлов приложения используйте <?php. В HTML-шаблоне удобно <?= значение ?>: знак = здесь является частью тега и означает сокращённый echo. Это не присваивание переменной. Начиная с PHP 5.4, короткий вывод доступен независимо от short_open_tag; во всей базе примеров PHP 8.2+ это правило уже действует.

Форма <? без php зависит от настройки short_open_tag и сборки PHP. На другом сервере такой участок может превратиться в обычный вывод. Для переносимого кода она не нужна; не путайте её с <?=. XML-декларация тоже начинается с <?, поэтому короткие теги могут создавать конфликт.

<?php ?>
<p>Товаров: <?= 3 ?></p>

<p>Товаров: 3</p>

Наличие расширения .php само по себе не настраивает сервер. Если исходник выдаётся целиком, проверяйте обработчик PHP в окружении. Исторические версии здесь нужны для чтения старого кода; выполнять примеры следует на поддерживаемой ветке.

Смешанный файл: исходник → выполнение → HTML

За пределами PHP-тегов обычный текст передаётся в результат. Слова «PHP его игнорирует» означают: не разбирает как PHP-команды. Они не означают «выбрасывает из ответа». Несколько PHP-областей одного файла продолжают одну программу.

<?php ?>
<h1>Самовывоз</h1>
<p>Свободных мест: <?php echo 4 + 2; ?></p>
<p>Выдача до 20:00</p>

<h1>Самовывоз</h1>
<p>Свободных мест: 6</p>
<p>Выдача до 20:00</p>

PHP не проверяет правильность HTML. Можно получить корректную PHP-программу, которая создаёт незакрытый HTML-тег. Проверка php -l проверяет синтаксис PHP, а вёрстку результата нужно отдельно открыть в браузере. Для длинного неизменного HTML выход из PHP-режима обычно понятнее десятков echo; это также позволяет не разбирать весь статический текст как PHP-строки. Из этого не следует обещание заметного ускорения всего сайта.

Инструкции, переносы и пробелы

Инструкция — законченная команда программы. Две инструкции можно поставить в одной физической строке, разделив ;, но по одной на строку читать легче. Одну инструкцию можно перенести на несколько строк: её завершит ;, а не Enter.

Пробелы между частями кода обычно разделяют слова и улучшают чтение. Нельзя разорвать ключевое слово echo или многосимвольный оператор. Пробелы внутри строки и вне PHP-области уже являются данными и могут попасть в результат.

<?php
echo 'A'; echo 'B';
echo
    'C',
    "\n";
echo 'A B', "\n";

ABC
A B

Используйте четыре пробела для отступа и не смешивайте табуляции с пробелами в одном проекте. Это договорённость оформления, а не требование парсера. Имена, комментарии и форматирование подробно разобраны в правилах читаемого кода.

Что закрывает ;, что закрывает } и что делает ?>

Внутри PHP пишите ; после echo, присваивания и других простых инструкций. Закрывающий PHP-тег ?> может завершить последнюю инструкцию без отдельной точки с запятой. Но конец файла без такого тега не заменяет ;.

Фигурные скобки { ... } группируют команды в блок. Например, if (true) означает «если условие истинно»; true — логическое «да». Внутри блока echo всё равно требует ;. Сам завершённый блок if не требует добавлять точку с запятой после }. Это не универсальное правило для всех конструкций со скобками: например, присваивание функции-замыкания заканчивается ;.

<?php
if (true) {
    echo 'Пункт выдачи открыт', "\n";
}
echo 'Продолжаем работу', "\n";

Пункт выдачи открыт
Продолжаем работу

<?php echo 'A' ?>
B
<?php echo 'C'; ?>D

AB
CD

<?php echo "A\n"; ?>
B

A
B

Комментарии: //, # и /* ... */

Комментарий нужен читателю исходника; PHP не выполняет его содержимое как код. // и # действуют до конца текущей строки или до закрывающего PHP-тега. /* ... */ охватывает несколько строк и заканчивается на первом */.

Пишите причину неочевидного решения: «время приведено к часовому поясу склада», а не «выводим текст». /** ... */ — тоже блочный комментарий; дополнительную структуру PHPDoc могут читать редактор и инструменты документации.

<?php
// Объявление показываем до открытия приёма заказов.
echo 'Заказы с 09:00', "\n";
# Внутренняя подсказка разработчику.
/* Текст хранится здесь временно:
   позже его заменит настройка магазина. */
echo 'https://shop.example/help', "\n";

Заказы с 09:00
https://shop.example/help

Не вкладывайте один блочный комментарий в другой: первый */ завершает весь текущий комментарий. В PHP 8.0+ последовательность #[ открывает атрибут, поэтому она не годится как начало обычного комментария. Сам атрибут — метаданные объявления, о нём есть отдельный раздел. Для обычной заметки используйте // или # с пробелом.

Граница комментария может стать границей ответа

<?php
// echo 'Эта команда закомментирована'; ?>Но этот текст выведется.

Но этот текст выведется.

<?php
/* Пример разделителя: ?>. Комментарий продолжается до звёздочки со слешем. */
echo 'Выведено только это', "\n";

Выведено только это

<?php ?>
<!-- Служебная метка: <?php echo 'demo-17'; ?> -->
<p>Витрина</p>

<!-- Служебная метка: demo-17 -->
<p>Витрина</p>

Условный HTML: почему часть текста не отправляется

Условие управляет не только echo. Оно может окружать целый HTML-участок. if (false): начинает ветку для логического «нет», else: — альтернативу, endif; завершает условие. Двоеточие здесь заменяет открывающую фигурную скобку, а endif — закрывающую. В одном блоке формы не смешивают.

<?php if (false): ?>
<p>Принимаем заказ</p>
<?php else: ?>
<p>Приём временно закрыт</p>
<?php endif; ?>

<p>Приём временно закрыт</p>

В настоящем шаблоне условие приходит из данных. $stock — переменная, то есть имя текущего значения; = сохраняет в неё число; > 0 проверяет, больше ли оно нуля. Это весь новый синтаксис следующего примера. Подробнее — переменная по шагам.

<?php
$stock = 2;
?>
<?php if ($stock > 0): ?>
<button type="button">Добавить в корзину</button>
<?php else: ?>
<p>Сообщим о поступлении</p>
<?php endif; ?>

<button type="button">Добавить в корзину</button>

Альтернативная запись также существует у while, for, foreach, switch и declare. У switch между его началом и первым case нельзя случайно вывести HTML или пробелы. Для этих конструкций есть разбор альтернативных шаблонов.

Первое значение из данных: вставляем текст безопасно

Название товара меняется, шаблон остаётся тем же. Сохраним название в $title. Сырые символы < и & имеют смысл для HTML; при вставке обычного текста их нужно закодировать. PHP-теги и <?= сами такую защиту не добавляют.

htmlspecialchars(...) — вызов готовой функции: значения в круглых скобках передаются ей, результат подставляется на место вызова. Первое значение — текст; ENT_QUOTES включает обработку обоих видов кавычек, ENT_SUBSTITUTE задаёт замену недопустимых последовательностей, символ | объединяет эти флаги, 'UTF-8' задаёт кодировку. Здесь функцию применяем к тексту внутри HTML-элемента, не к JavaScript или URL.

<?php
$title = 'Чай <Особый> & мёд';
?>
<h1><?= htmlspecialchars($title, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8') ?></h1>

<h1>Чай &lt;Особый&gt; &amp; мёд</h1>

В функцию можно передать и другую строку; изменение товара не требует переписывать h1. Следующие ступени: как вызов получает данные и возвращает результат, кодирование для разных контекстов.

Файл только с PHP: почему лучше закончить без ?>

В файле с функциями или настройками вывод часто вообще не нужен. Оставьте его в PHP-режиме до конца: открывающий тег есть, закрывающего нет. Пробел после закрывающего тега, пустая строка или BOM до открывающего могут стать неожиданными байтами ответа. BOM — служебная метка кодировки в начале файла; для этих UTF-8-исходников выбирайте сохранение без неё.

Это особенно заметно, когда другой файл подключается через require: команда читает указанный файл и выполняет его в текущей программе. Путь __DIR__ . '/settings.php' соединяет каталог текущего файла и постоянное имя. __DIR__ — встроенная константа пути, точка — соединение строк. Имя файла в примере не приходит от посетителя.

<?php
echo '[';
require __DIR__ . '/settings.php';
echo ']', "\n";

[]

<?php
echo '[';
require __DIR__ . '/settings.php';
echo ']', "\n";

[ ]

В HTTP ранний вывод может помешать отправить заголовки и cookie, если они ещё не буферизованы. Буферизация меняет момент отправки, но не отменяет существование лишних байтов. Объяснение — тело и заголовки ответа и буфер вывода. Обычный перенос строки в конце файла без закрывающего PHP-тега остаётся PHP-пробелом и не выводится.

Синтаксическая ошибка: ищем причину, а не только отмеченную строку

До выполнения PHP разбирает синтаксис файла. Если парсер не может понять инструкцию, её код не является рабочим примером. Команда php -l example.php проверяет синтаксис без выполнения тела. Она не доказывает, что функция существует, данные допустимы или результат верен.

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

<?php
echo 'Сборка'
echo 'Готово';

<?php
/* временно отключено
   /* внутренняя заметка */
*/
echo 'Готово';

Отдельная точка с запятой — допустимая пустая инструкция. Именно поэтому нельзя автоматически ставить её сразу после if (...): условие тогда управляет пустотой, а следующий блок становится самостоятельным. Это ошибка смысла, которую lint не найдёт.

<?php
if (false);
{
    echo 'Этот блок всё равно выполняется', "\n";
}

Этот блок всё равно выполняется

Соберите небольшое сообщение и проверьте границы

Попробуйте сами. Сделайте HTML-заголовок «Доставка». Под ним выведите абзац «Стоимость: 250 ₽», вычислив 200 + 50 в PHP. В результате не должно быть видимых PHP-тегов.

<?php ?>
<h1>Доставка</h1>
<p>Стоимость: <?= 200 + 50 ?> ₽</p>

<h1>Доставка</h1>
<p>Стоимость: 250 ₽</p>

Попробуйте сами. Добавьте комментарий с причиной временной цены. Он должен быть виден в исходном PHP, но не в HTML-ответе.

Дальше: сохранять меняющиеся значения, понимать вычисление выражений, выбирать ветки и повторять действия.