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

Что вы сможете сделать с PHP

Представьте небольшую мастерскую. Сначала на сайте достаточно адреса и расписания. Затем посетитель хочет оставить заявку, увидеть свои заказы и получить сообщение о готовности. Одного текста страницы уже мало: нужно принять данные, проверить их, сохранить и построить персональный ответ. PHP позволяет описать эти действия программой. Здесь начнём с одного видимого сообщения, затем разберём, как посетитель передаёт программе данные.

PHP — открытый язык программирования общего назначения, особенно распространённый в веб-разработке. Название раскрывается как PHP: Hypertext Preprocessor. Исполняющую программу тоже часто называют PHP; её вы запускаете, чтобы выполнить файл с кодом. Исходный файл — записанная инструкция, а результат выполнения — то, что получилось после её обработки. Эти две вещи важно различать с первого примера.

Для работы с конкретной базой, архивом, изображениями или сетевым протоколом могут потребоваться расширение PHP либо сторонняя библиотека. Поэтому «PHP умеет» не означает «это доступно в любой установке». Вы сможете сочетать обычные функции и объекты; выбор разбираем на задачах по мере роста программы.

Файл, PHP, веб-сервер и браузер: четыре разные роли

Все участники могут работать на одном вашем компьютере. «Сервер» здесь обозначает роль программы, а не обязательно отдельный дорогой компьютер. В интернете браузер обычно находится у посетителя, а веб-сервер и PHP — у владельца сайта. Веб-сервер принимает запрос, PHP выполняет программу, браузер читает полученный ответ.

При запуске из терминала середина пути короче: вы → PHP → файл → вывод в терминал. Веб-сервер и браузер вообще не требуются. Напротив, открытие файла в браузере через file:///... само по себе PHP не запускает. Браузер не превращается в PHP-интерпретатор от расширения файла.

Это схема участников, а не буквальное описание внутренней памяти PHP или устройства всех серверов. В реальном приложении обработчик может выбирать файл по маршруту; адрес /orders не обязан совпадать с именем orders.php. Для первого опыта оставим прямое соответствие имени и URL.

Первая инструкция: вывести одно сообщение

Создайте в редакторе обычного текста файл hello.php. Сохраните его в UTF-8 без BOM. Не используйте документ Word и проверьте настоящее имя: при скрытых расширениях легко получить hello.php.txt. В этом файле пока только начало PHP и одна инструкция.

<?php
echo 'Мастерская открыта';

Мастерская открыта

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

Попробуйте сами. Поменяйте сообщение на «Приём заказов до 19:00». Что нужно изменить?

Запустить файл в терминале и увидеть результат

Сначала PHP должен быть установлен. Команда php -v проверяет, доступен ли он в текущем терминале, и показывает версию. Если команда не найдена, это вопрос установки или пути к исполняемому файлу, а не ошибка нашего echo. Откройте терминал в папке, где лежит hello.php; только затем выполняйте следующую команду.

php hello.php

<?php
echo "Мастерская открыта\n";

Мастерская открыта

Не каждый пример ниже можно одинаково проверить через CLI: HTTP-заголовки, данные формы и сессия связаны с веб-запросом. У примеров отмечено окружение. Если серверная программа ожидает форму, запуск php handler.php не создаёт эту форму за вас.

Тот же файл через локальный веб-сервер

В той же учебной папке запустите команду ниже. Она занимает текущий терминал, пока сервер работает. Откройте браузер отдельно и введите http://127.0.0.1:8000/hello.php. На экране должно появиться наше сообщение. Здесь 127.0.0.1 — ваш компьютер, 8000 — выбранный порт, /hello.php — запрашиваемый файл внутри папки сервера.

php -S 127.0.0.1:8000

Встроенный сервер предназначен для разработки и проверки, а не для публичного сайта. Не меняйте адрес на 0.0.0.0, чтобы «просто заработало»: это меняет доступность сервера из сети. Для рабочего сайта используется настроенное серверное окружение. Установка и настройка рассматриваются отдельно, когда первый файл уже понятен.

HTML задаёт страницу, PHP подставляет её часть

HTML описывает содержание страницы. <h1>...</h1> выделяет главный заголовок, <p>...</p> — абзац. У большинства таких элементов есть начало и конец. PHP может стоять внутри HTML-документа и создавать только меняющуюся часть. Сначала попробуем заранее известный текст — так легче увидеть границу двух языков.

<!doctype html>
<html lang="ru">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Мастерская</title>
</head>
<body>
    <h1>Мастерская</h1>
    <p><?php echo 'Приём заказов до 19:00'; ?></p>
</body>
</html>

<!doctype html>
<html lang="ru">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Мастерская</title>
</head>
<body>
    <h1>Мастерская</h1>
    <p>Приём заказов до 19:00</p>
</body>
</html>

<!doctype html> выбирает современный HTML; lang="ru" сообщает язык; charset — кодировку; viewport задаёт удобную основу масштаба на телефоне; title — название вкладки. Между <?php и ?> выполняется PHP, остальной текст передаётся в вывод. Само имя .php — соглашение настройки обработчика, а не команда для браузера.

Для неизменного расписания PHP избыточен: можно сразу написать его в HTML. Польза появится, когда расписание зависит от данных или решения. Сейчас пример нужен, чтобы увидеть, кто что выполняет.

Почему посетитель не видит echo и где проверять результат

Откройте просмотр исходного кода страницы в браузере: там находится полученный HTML. Исходный PHP-файл остаётся у сервера при корректной настройке. Панель Elements показывает уже разобранный браузером документ; браузер и JavaScript могли изменить его. Поэтому для сравнения с ожидаемым HTML смотрите также исходный ответ в Network.

Скрытость исходника не делает приложение безопасным сама по себе. Посетитель управляет отправляемыми значениями и может обращаться к обработчику без вашей формы. Проверки нужно выполнять на сервере; к этому вернёмся в следующем учебном опыте.

Почему перенос строки в PHP и перенос на странице выглядят по-разному

<?php
echo "Первый заказ\n";
echo "Второй заказ\n";

Первый заказ
Второй заказ

<p><?php echo 'Первый заказ'; ?></p>
<p><?php echo 'Второй заказ'; ?></p>

<p>Первый заказ</p>
<p>Второй заказ</p>

Фрагмент с двумя абзацами можно поставить внутрь body предыдущей полной страницы. Полный разбор кавычек, символов и соединения текста находится в главе о строках.

Если первый пример не работает: отделяем синтаксис от окружения

Ошибка синтаксиса означает, что PHP не смог прочитать запись программы: например, не закрыта кавычка. Ошибка окружения означает, что нужный файл или PHP ещё не был запущен. Проверяйте эти причины отдельно. Для локального файла есть проверка синтаксиса без выполнения его инструкций:

php -l hello.php

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

<?php
phpinfo();

Веб-окружение и терминал способны использовать разные настройки. Поэтому результат php -v не доказывает версию PHP у опубликованного сайта. Подробности диагностики будут в главе об ошибках.

Первый файл: из текста программы получается ответ

Начнём с результата: программа должна написать, какой магазин открыт. Для этого пока не нужны ни сайт, ни база, ни классы. Сохраните пример в example.php в UTF-8 и выполните в терминале php example.php из его каталога. Если команда php не найдена, перейдите к настройке окружения ниже и затем вернитесь сюда. Каждый пример запускается отдельным файлом; несколько полных программ не склеивают вместе.

<?php
$shop = 'Чайная';
echo 'Открыт магазин: ', $shop, "\n";

Открыт магазин: Чайная

Попробуйте сами. Переименуйте магазин в «Книжная». Где меняется программа и что выведется?

Первое изменение: сообщение зависит от данных

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

<?php
$closingTime = '18:30';
echo 'Приём заказов до ', $closingTime, "\n";

Приём заказов до 18:30

Обращение к данным с квадратными скобками — следующий уровень. $_SERVER представляет набор сведений, подготовленный PHP для текущего запуска. Набор называется массивом; запись $_SERVER['HTTP_USER_AGENT'] выбирает значение под ключом HTTP_USER_AGENT. Этот ключ связан с заголовком User-Agent, который может отправить клиент.

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

Как использовать готовую функцию и выполнить нужную ветку

Задача: показать подсказку, если в диагностической строке клиента есть слово Firefox. str_contains — готовая функция поиска фрагмента. В скобках передаются два значения: где искать и что искать. Функция возвращает true, когда фрагмент найден, и false, когда не найден. Это логические значения «да» и «нет», а не строки с такими словами.

<?php
$agent = 'Учебный Firefox';
if (str_contains($agent, 'Firefox')) {
    echo "В строке есть Firefox\n";
} else {
    echo "В строке нет Firefox\n";
}
echo "Проверка закончена\n";

В строке есть Firefox
Проверка закончена

Найденная подстрока — лишь свойство текста. Она не доказывает настоящий браузер или личность человека: User-Agent можно изменить. Не разрешайте оплату или вход по такому признаку. Для поддерживаемых возможностей браузера предпочтительна проверка самой возможности на стороне клиента. Здесь мы учимся читать данные, вызывать функцию и выбирать ветку.

Дальше можно подробно разобрать параметры, аргументы и возврат, условия и циклы и поиск в строке.

Как взять строку из настоящего запроса и безопасно показать её

Сохраним следующий файл как agent.php в папке локального сервера. Ключ может отсутствовать: например, запрос отправляет другая программа без User-Agent. Запись ?? '' выбирает пустую строку, если значения нет или оно равно null. Запрос клиента — внешние данные, поэтому при вставке в HTML его текст отдельно преобразуем для этого контекста.

<?php
$agent = $_SERVER['HTTP_USER_AGENT'] ?? '';
header('Content-Type: text/html; charset=utf-8');
echo '<p>Строка клиента: ';
echo htmlspecialchars($agent, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
echo '</p>';

<?php
$message = '<b>Заказ</b> & "Клиент"';
echo htmlspecialchars($message, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'), "\n";

<b>Заказ</b> & "Клиент"

Не выводите весь $_SERVER посетителям. Набор содержит и служебные сведения. Остальные источники входа разобраны по отдельным суперглобальным массивам.

Выбирать целый HTML-фрагмент, сохраняя понятную разметку

Когда сообщение состоит из заголовка и абзаца, не обязательно превращать каждую строку HTML в длинный echo. Можно выйти из PHP внутри ветки. PHP продолжает следить за условием: в ответ попадёт только HTML выбранной ветки. Ниже значение true задаём сами; позже его можно получить из проверенного расписания.

<?php
$isOpen = true;
if ($isOpen) {
?>
<h2>Принимаем заказы</h2>
<p>Можно оставить заявку.</p>
<?php
} else {
?>
<h2>Мастерская закрыта</h2>
<p>Откроемся завтра.</p>
<?php
}

<h2>Принимаем заказы</h2>
<p>Можно оставить заявку.</p>

Альтернативная запись if (...): ... endif; полезна для больших шаблонов; она изучается вместе с управляющими конструкциями. PHP не поддерживает смешение записи с фигурными скобками и альтернативной записи внутри одной управляющей конструкции: выберите для неё один стиль.

Форма: как поле в браузере становится значением в PHP

Следующая полезная задача — дать посетителю ввести имя и увидеть предпросмотр подписи обращения. Это ещё не отправка заявки: пример ничего не сохраняет и никуда не пересылает. Нам нужен полный видимый путь от поля до ответа. HTML формы и PHP-обработчик лежат в одной папке; в скачиваемом примере это form.html и example.php.

<!doctype html>
<html lang="ru">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Предпросмотр подписи</title>
</head>
<body>
    <h1>Как подписать ваше обращение</h1>
    <form action="example.php" method="post">
        <label for="customer-name">Ваше имя</label>
        <input id="customer-name" name="customer_name"
               type="text" maxlength="80" required>
        <button type="submit">Посмотреть подпись</button>
    </form>
</body>
</html>

Первый обработчик: проверить вход прежде, чем выводить

Теперь каждую часть проверки можно связать с задачей. Сначала допускаем POST. Затем читаем нужное поле с запасным значением. Посетитель может отправить массив вместо строки, поэтому проверяем is_string до обработки текста. trim убирает крайние пробельные символы, strlen считает байты. exit завершает текущую программу после ошибки; иначе выполнение пошло бы дальше.

<?php
if (($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST') {
    http_response_code(405);
    header('Allow: POST');
    echo 'Откройте форму form.html и отправьте её.';
    exit;
}
$rawName = $_POST['customer_name'] ?? '';
if (!is_string($rawName)) {
    http_response_code(400);
    echo 'Передайте одно имя текстом.';
    exit;
}
$name = trim($rawName);
if ($name === '' || strlen($name) > 320) {
    http_response_code(400);
    echo 'Имя нужно заполнить; максимум 320 байт UTF-8.';
    exit;
}
header('Content-Type: text/html; charset=utf-8');
echo '<h1>Предпросмотр подписи</h1><p>';
echo htmlspecialchars($name, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
echo '</p><p>Данные не сохранены и не отправлены оператору.</p>';

Лимит 320 здесь задан в байтах, а HTML maxlength — ограничение браузерного поля, не эквивалент PHP strlen. Для пользовательского лимита в символах изучите многобайтовые строки. Обработчик не утверждает, что это настоящее имя человека: он проверяет только согласованную форму входа.

POST не шифрует данные и не делает запрос доверенным; для передачи по сети нужен HTTPS. Здесь нет изменения учётной записи, заказа или данных сессии, поэтому пример ограничен безопасным предпросмотром. Как только действие что-либо меняет, добавляются CSRF-проверка, полномочия и правила операции. Они подробно разобраны вместе с полной формой в главе обработки форм.

Чем отличается GET и почему данные не появляются сами собой

Для поиска по каталогу обычно удобно поместить условия в URL: результат можно сохранить в закладки и передать ссылкой. При method="get" поле той же формы попадёт в строку запроса, и читать его нужно из $_GET. Обычная POST-форма отправляет поля в теле; её значения читаются из $_POST. Если поменять только method, но оставить чтение из другого массива, обработчик не получит ожидаемые данные.

Поля не становятся свободными переменными $customer_name автоматически. Мы сами выбираем ключ, проверяем его значение и присваиваем понятному локальному имени. $_REQUEST смешивает источники в зависимости от настройки и мешает увидеть договор обработчика; для учебного и рабочего кода здесь явно выбирается нужный источник.

Неотмеченный checkbox, выключенное disabled-поле или поле без name могут отсутствовать в отправленных данных. Файлы имеют свой путь через $_FILES. Эти варианты, вложенные имена и JSON-тело разобраны в суперглобальных массивах, формах и загрузке файлов.

Куда двигаться после первого ответа

После этих опытов у вас есть три наблюдаемых результата: текст из PHP-файла, HTML-страница с вычисляемой частью и значение формы, прошедшее проверку. Не требуется сразу запомнить весь справочник. Продолжайте последовательно по механике, возвращаясь к тому же сайту мастерской и добавляя по одной возможности.

Попробуйте сами. В форме отправили имя « <b>Анна</b> ». Что должен показать ответ и почему?

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

Когда программа выросла: подключить свой файл

Один и тот же заголовок можно хранить отдельно. require подключает и выполняет PHP-файл в текущем процессе; это не запуск второй программы. Суффикс _once означает «не подключать тот же файл повторно». В ZIP примера лежат example.php и heading.php; держите их рядом.

<?php
require_once __DIR__ . '/heading.php';
require_once __DIR__ . '/heading.php';
echo "Каталог товаров\n";

Чайная
Каталог товаров

include при невозможности загрузки файла выдаёт предупреждение и позволяет продолжить; require в PHP 8 бросает Error и без обработчика останавливает выполнение. Обязательный файл приложения обычно подключают через require. Имена здесь зафиксированы разработчиком: путь из запроса пользователя нельзя напрямую подставлять в include/require. Данные читают как данные, а не как исполняемый PHP.

Строка declare(strict_types=1);, которую вы увидите дальше, задаёт строгий режим скалярных объявлений типов для этого файла; она должна быть первой инструкцией после открывающего тега. Она не объявляет тип каждой переменной, не проверяет все поля массива и не заменяет проверку формы. Разберём её смысл на типах аргументов функции.

Дальше: переменная и первое присваивание → типы значений → действия со значениями → выбор и повторение. Ниже — устройство CLI/HTTP и диагностика окружения.

Теги PHP, точка с запятой и комментарии: читаем исходный файл

В смешанном файле тег <?php начинает участок PHP, а ?> возвращает обработку обычного текста. Внутри PHP имена переменных начинаются с $, строки берут в кавычки, большинство инструкций завершается ;. Фигурные скобки объединяют инструкции в блок. Перенос строки помогает человеку читать код, но обычно не завершает инструкцию сам по себе.

<?php
// Эта строка выводит название учебного магазина.
echo "Мастерская\n";
/* Несколько строк комментария допустимы,
   но такие комментарии нельзя вкладывать друг в друга. */
?>
<p><?= 'Работаем с 10 до 19' ?></p>

Мастерская
<p>Работаем с 10 до 19</p>

Тег <?= эквивалентен выводу выражения и доступен независимо от настройки коротких тегов. Здесь выводится заранее заданный автором текст. Значения от посетителей требуют отдельного безопасного вывода, который будем изучать в главах о формах. Короткий открывающий <? зависит от настройки, поэтому в переносимом коде используйте <?php. В чистом PHP-файле закрывающий тег обычно опускают: случайный пробел после него стал бы выводом и мог помешать отправке заголовков. Комментарии обосновывайте смыслом решения, а не пересказом каждой строки.

Где живет программа

PHP выполняется на сервере или в командной строке. Браузер получает результат: HTML, JSON, файл или ответ об ошибке. Когда покупатель открывает корзину, веб-сервер передает запрос PHP, программа читает входные данные, проверяет права, рассчитывает сумму и формирует ответ. Исходный PHP-код при правильной настройке сервера в браузер не отправляется. JavaScript в браузере и PHP на сервере не делят обычные переменные; они обмениваются HTTP-запросами.

В обычном PHP-FPM приложении состояние локальных переменных относится к текущему запросу. Следующий запрос не продолжает выполнение предыдущей функции. Для корзины между запросами нужны сессия, база или другое хранилище. В CLI-воркере и некоторых серверных средах процесс может жить долго: там забытые массивы, статические счетчики и открытые ресурсы сохраняются дольше, чем ожидает автор обычного сайта. Это различие пригодится в разделах об области видимости и очередях.

Проверяем именно то окружение, в котором работает задача

Сначала установите поддерживаемую ветку PHP с официального сайта или из доверенного репозитория вашей системы. Не подменяйте системную версию вслепую: сайт и терминал могут использовать разные бинарные файлы и разные php.ini. Команда php -v сообщает версию CLI, php --ini — конфигурацию, php -m — расширения. Для веб-сервера проверяйте его конфигурацию отдельно. Полный phpinfo() удобен локально, но публично раскрывает пути и параметры окружения.

php -v
php --ini
php -m

<?php
declare(strict_types=1);

$unitPriceKopecks = 129900;
$quantity = 2;
$totalKopecks = $unitPriceKopecks * $quantity;
echo "Итого: {$totalKopecks} коп.\n";

Итого: 259800 коп.

Тот же язык в браузере

Для учебного сайта заведите каталог public и запускайте встроенный сервер только на локальном интерфейсе: php -S 127.0.0.1:8000 -t public. Он предназначен для разработки. Не публикуйте его в интернет и не храните в public секреты, резервные копии или исходные CSV клиентов. В реальном развертывании точку входа и обработку .php настраивают в Nginx/Apache и PHP-FPM либо в другой выбранной серверной среде.

<?php
declare(strict_types=1);

header('Content-Type: application/json; charset=utf-8');
echo json_encode(['status' => 'ok'], JSON_THROW_ON_ERROR);

В PHP-файле, содержащем только код, закрывающий тег обычно опускают: случайные пробелы после него могут отправить тело раньше заголовков. Ошибки в разработке показывают разработчику, в рабочем окружении записывают в журнал. Клиенту возвращают понятное сообщение и идентификатор запроса; пароль, стек и SQL-запрос не должны попадать в страницу ошибки.

Как учиться на примерах и искать неисправность

Читайте подпись режима каждого примера. «Самостоятельный» имеет фиксированные данные и ожидаемый вывод. Контекстный пример требует HTTP, базы или заданной зависимости. Команда терминала не вставляется внутрь PHP-файла. При ошибке сначала проверьте имя файла и бинарный PHP, затем строку сообщения, тип входного значения и установленные расширения. Меняйте одно условие за раз: пустая корзина, нулевой остаток, неверный JSON. Так вы исследуете контракт, а не просто убеждаетесь, что счастливый случай работает.

Попробуйте сами. Измените корзину так, чтобы количество было 0. Затем передайте строку "две". Какая проверка должна стоять перед расчетом?