Комментарии — это записки, которые программисты оставляют прямо в коде. Компьютер их полностью игнорирует, они нужны только для людей. С помощью комментариев можно объяснить, как работает сложная часть программы, оставить напоминание себе на будущее или временно "выключить" какой-то участок кода, не удаляя его.
В PHP есть несколько способов оставить комментарий, и в этом тренажере мы их все разберем. Ты научишься добавлять однострочные и многострочные комментарии, исправлять ошибки, связанные с ними, и понимать, как они влияют на выполнение скрипта. Эти навыки помогут тебе писать более чистый и понятный код, который будет легко поддерживать и дорабатывать. В некоторых заданиях мы также затронем PHPDoc, чтобы ты имел представление и о таких вещах.
- Модуль 1: Основы синтаксиса PHP
- Модуль 2: Переменные и типы данных
- Модуль 3: Операторы
- Модуль 4: Условные конструкции
- Модуль 5: Циклы
- Модуль 6: Массивы
- Индексированные массивы.
- Ассоциативные массивы.
- Многомерные массивы.
- Добавление элементов в массив.
- Удаление элементов из массива.
- Функция count().
- Функция array_push() и array_pop().
- Функция array_shift() и array_unshift().
- Функция array_merge().
- Функция array_slice().
- Функция array_splice().
- Функция in_array().
- Функция array_search().
- Функция array_keys() и array_values().
- Функция array_unique().
- Функция array_reverse().
- Сортировка: sort(), rsort().
- Сортировка: asort(), arsort().
- Сортировка: ksort(), krsort().
- Функция array_map().
- Функция array_filter().
- Функция array_reduce().
- Функция array_walk().
- Функция array_column().
- Деструктуризация массивов.
- Модуль 7: Функции
- Объявление функций.
- Вызов функций.
- Параметры функций.
- Возврат значений return.
- Значения параметров по умолчанию.
- Передача по значению.
- Передача по ссылке.
- Переменное количество аргументов.
- Оператор распаковки ....
- Типизация параметров.
- Типизация возвращаемых значений.
- Nullable типы.
- Union типы (PHP 8).
- Именованные аргументы (PHP 8).
- Анонимные функции.
- Стрелочные функции.
- Замыкания и use.
- Рекурсивные функции.
- Глобальные переменные в функциях.
- Статические переменные в функциях.
- Модуль 8: Работа со строками
- Одинарные и двойные кавычки.
- Экранирование символов.
- Heredoc и Nowdoc синтаксис.
- Функция strlen().
- Функция substr().
- Функция str_replace().
- Функция strpos() и strrpos().
- Функция explode() и implode().
- Функция trim(), ltrim(), rtrim().
- Функция strtolower() и strtoupper().
- Функция ucfirst() и ucwords().
- Функция str_repeat().
- Модуль 9: Суперглобальные переменные
- Модуль 10: Работа с формами
- Модуль 11: Работа с файлами
- Модуль 12: Дата и время
- Модуль 13: Регулярные выражения
- Модуль 14: Сессии и Cookie
- Модуль 15: Include и Require
- Модуль 16: Объектно-ориентированное программирование
- Модуль 17: Пространства имен
- Модуль 18: Обработка ошибок и исключений
- Модуль 19: Работа с JSON и XML
- Модуль 20: Работа с базами данных MySQLi
- Модуль 21: PDO - PHP Data Objects
- Модуль 22: Composer и зависимости
- Модуль 23: cURL и HTTP запросы
- Модуль 24: REST API
- Модуль 25: Безопасность
- Модуль 26: Генераторы и итераторы
- Модуль 27: Reflection API
- Модуль 28: Работа с изображениями
- Модуль 29: Отправка email
- Модуль 30: Паттерны проектирования
- Модуль 31: Тестирование
- Модуль 32: Продвинутые возможности PHP 8+
Добавление однострочного комментария
В PHP самый распространенный способ добавить однострочный комментарий — использовать символы в стиле C++. Добавьте необходимые символы, чтобы первая строка стала комментарием.
<?php
input1S Это пояснение к коду
$message = "Задача выполнена!";
echo $message;
?>Альтернативный однострочный комментарий
Существует еще один способ создания однострочных комментариев, пришедший из синтаксиса командных оболочек Unix. Используйте его, чтобы закомментировать строку с объявлением переменной.
<?php
$a = 10;
input1S $b = 20; // Эта переменная не будет создана
$c = 30;
echo $a + $c;
?>Исправьте ошибку в многострочном комментарии
Многострочные комментарии начинаются с `/*` и заканчиваются `*/`. В этом коде допущена ошибка в закрывающем теге комментария, из-за чего весь код после него не работает. Найдите и исправьте строку с ошибкой.
<?php/* Это многострочный комментарий, который объясняет назначение переменной ниже.*$user_count = 150;echo "Пользователей онлайн: " . $user_count;?>Временное отключение кода
Иногда нужно временно отключить несколько строк кода для отладки. Используйте токены из банка, чтобы закомментировать блок с переменными `$old_price` и `$discount`, оставив остальной код рабочим.
<?php
$product_name = "Смартфон";
input1S
$old_price = 500;
$discount = 50;
input2S
$final_price = 450;
echo $product_name . ": " . $final_price . " USD";
?>Предскажите результат выполнения кода
Проанализируйте код. Одна из строк, изменяющая значение переменной, закомментирована. Определите, какое значение будет выведено в результате, и впишите его в поле для ответа.
<?php
$status = "pending";
$status = "approved";
// $status = "rejected";
echo $status;
?>Сопоставьте типы комментариев и их синтаксис
В PHP существуют разные стили комментариев. Сопоставьте названия стилей в левой колонке с соответствующим им синтаксисом в правой, перетаскивая элементы.
/* ... */# .../** ... */// ...Разделите код и комментарии
Перед вами набор строк кода и комментариев. Распределите их по двум категориям: "Выполняемый код" и "Комментарии". Это упражнение поможет вам натренироваться быстро отличать одно от другого.
$x = 5 + 10;// Проверяем условиеif ($x > 10) {# Вывести результатecho "Success";/* Блок кода завершен */Незакрытый многострочный комментарий
Программист хотел закомментировать только одну строку, но забыл закрыть многострочный комментарий. В результате важная часть кода оказалась "выключенной". Исправьте код так, чтобы закомментированной осталась только строка `// echo "Debug info";`, а остальной код выполнялся.
<?php$result = 100;/* echo "Debug info";echo "Final result: " . $result;?>Что выведет этот код?
В этом фрагменте кода используются разные типы комментариев для управления значениями переменной. Внимательно проследите за изменениями переменной `$value` и выберите, что в итоге выведет команда `echo`.
<?php
$value = 1;
/*
$value = 2;
*/
$value = 3;
// $value = 4;
# $value = 5;
echo $value;
?>