По результатам работы над первым проектом по PHP составил этот небольшой список пунктов "перепроверь себя". Это должно помочь не совершать "необязательные" ошибки. Ну а последние три пункта - не про ошибки, а скорее рекомендации.
- Функция-предикат
- Именование файлов
- Неймспейсы
- Имена функций
- Имена количественных переменных
- If else
- Обновление autoload
- Версионирование
- Cli.php
Функция-предикат
Должна возвращать true либо false. Интерпретироваться результат должен за пределами функции. https://ru.hexlet.io/blog/posts/naming-in-programming
Именование файлов
Хотя в уроке https://ru.hexlet.io/courses/php-setup-environment/lessons/composer-autoload/theory_unit утверждается нечто иное, именование файлов делается следующим образом:
- Файлы без классов именуются со строчной буквы (маленькой, обыкновенной).
- С прописной (заглавной, большой) буквы именуются файлы с классами.
Неймспейсы
Как правильно отображать пространства имен на файловую структуру.
- https://ru.hexlet.io/courses/php-basics/lessons/nested-namespaces/theory_unit
- https://ru.hexlet.io/courses/php-basics/lessons/namespaces/theory_unit
Имена функций
Имена функций - глаголы. https://ru.hexlet.io/blog/posts/naming-in-programming
Имена количественных переменных
Применяйте count https://ru.hexlet.io/blog/posts/naming-in-programming
If else
Рефакторить конструкции if else. Где это только возможно: упрощать, отказываваться от избыточных ветвей.
Обновление autoload
После обновления файлов, содержащихся в секции autoload файла composer.json, выполняйте команду
composer dump-autoload
Версионирование
Чтобы установить пакет последнюю версию пакета, применяйте версионирование. Например, это можно делать использую теги гита. Ниже - пример последовательности команд:
git tag 0.0.01
git push --tags
git push
Cli.php
Создаваемый на третьем шаге cli.php перед отправкой задания на проверку можно удалить.
