Почему одни проекты на PHP легко поддерживать, а другие превращаются в путаницу? Во многом это зависит от соблюдения единых стандартов кодирования. PSR-1 — базовый стандарт, который помогает создавать понятный и структурированный код. Рассмотрим основные принципы и способы их применения.
Правила PSR-1
1. Файлы и пространства имён
🔸Использовать только теги «<?php» и «<?=».
🔸Код должен быть записан в UTF-8 без BOM.
🔸Файлы должны либо объявлять символы (классы, функции, константы), либо вызывать побочные эффекты (например, вывод на экран, изменение настроек). Делать и то, и другое в одном файле не рекомендуется.
2. Имена пространств и классов
Названия классов должны быть в стиле StudlyCaps (каждое слово с заглавной буквы, без разделителей).
Константы классов записываются прописными буквами с подчёркиваниями, например
MAX_SIZE.3. Методы классов
Имена методов записываются в стиле camelCase (первое слово с маленькой буквы, последующие — с заглавной).
Пример реализации
На картинке представлен корректный пример кода, соответствующий PSR-1:
Что здесь показано:
🔹Пространство имён оформлено в стиле StudlyCaps.
🔹Имя класса соответствует стандарту StudlyCaps.
🔹Константы записаны заглавными буквами с подчёркиваниями.
🔹Имя метода оформлено в стиле camelCase.
Интеграция PSR-1 с современными инструментами
Для проверки и автоматизации соблюдения стандартов используются такие инструменты:
PHP_CodeSniffer: проверяет код на соответствие PSR-1. Запуск проверки через
composer check-style.Автоматическое исправление стиля: возможно с помощью
composer fix-style.PHPUnit: тестирование кода для обеспечения качества реализации.
Автозагрузка по PSR-4: упрощает управление файлами и пространствами имён.