Rivalry2

HTML Diff

1 added 1 removed

Original 2026-01-01

Modified 2026-02-26

1 В этом уроке мы поговорим об именовании. Изучать эту тему мы начнем с примера. Посмотрим на такую программу:

2 Она работает, но в ней странное имя переменной - $x. Компьютеру без разницы, как мы называем переменные, но вот программистам - нет. Мы гораздо реже пишем код, чем его читаем. Причем часто приходится читать не свой код, а написанный другими людьми. От качества и понятности имен переменных зависит половина успеха в анализе кода.

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

4 - Среди разработчиков есть шутка: "самое сложное в программировании - названия переменных и инвалидация кеша". Придумывать названия и правда сложно. Например, какое бы название вы бы выбрали для переменной, в которой хранится количество неоплаченных заказов от клиентов, имеющих задолженность в предыдущем квартале?

4 + Среди разработчиков есть шутка: "самое сложное в программировании - названия переменных и инвалидация кеша". Придумывать названия и правда сложно. Например, какое бы название вы бы выбрали для переменной, в которой хранится количество неоплаченных заказов от клиентов, имеющих задолженность в предыдущ��м квартале?

5 Чтобы глубже погрузиться в тему, попробуйте выполнить дополнительное задание - придумайте название для переменной, в которой хранится "количество братьев и сестер короля". Запишите его в блокноте или отправьте себе на почту. Не указывайте там ничего, кроме названия переменной. А через несколько уроков мы вернемся к этой теме.

6 <h2>Именование переменных</h2>

7 Некоторые имена довольно просты - например, $greeting. Но часто все не так очевидно. Довольно часто имена составные, то есть включают в себя несколько слов. Например, "имя пользователя". В разных языках применяются разные стили кодирования, и имя переменной будет отличаться.

8 В именовании переменных можно выделить четыре основных подхода, которые иногда комбинируют друг с другом. Все эти подходы проявляют себя, когда имя переменной состоит из нескольких слов:

9 <ul><li>kebab-case - составные части переменной разделяются дефисом (my-super-var)</li>

10 <li>snake_case - для разделения используется подчеркивание (my_super_var)</li>

11 <li>CamelCase - каждое слово в переменной пишется с заглавной буквы (MySuperVar)</li>

12 <li>lowerCamelCase - каждое слово в переменной пишется с заглавной буквы, кроме первого (mySuperVar)</li>

13 </ul>В PHP используется CamelCase и его вариация lowerCamelCase, при котором первая буква первого слова - строчная. Именно lowerCamelCase применяется для переменных. Это значит, что имена соединяются друг с другом, при этом все имена кроме первого становятся с заглавной буквы: $userName. С тремя словами это выглядит так: $mySuperVariable.

14 Другое общепринятое правило гласит - не используйте транслит для имен, только английский язык. Если вы испытываете сложности с английским, то пользуйтесь переводчиком. Со временем, копаясь в чужом коде, вы сформируете правильные представления об именовании.

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

16 В каждом языке свои правила. Относительно недавно в PHP появился общепринятый<a>стандарт кодирования</a>, к которому все так или иначе стремятся. Подобные стандарты описывают множество аспектов. Советуем с самого начала завести привычку заглядывать в стандарт и писать код в соответствии с ним.

17 К счастью, сегодня не нужно помнить все правила из стандарта, потому что существуют специальные программы, которые проверяют код автоматически и сообщают о нарушениях. Такие программы называютсялинтерами, и вы начнете их использовать немного позже, когда у вас появится чуть больше опыта.

18 <h2>Именование функций</h2>

19 Стиль именования функций в PHP такой же, как и стиль именования переменных:lowerCamelCase. Но при выборе самих слов есть важное отличие.

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

21 <ul><li>showDate ("показать дату")</li>

22 <li>sub (subtract - "вычесть")</li>

23 <li>print_r ("напечатать")</li>

24 <li>round ("округлить")</li>

25 <li>gettype ("получить тип")</li>

26 </ul>В отличие от функции, переменная - сущность. Поэтому мы используем существительные:

27 <ul><li>$child ("ребенок")</li>

28 <li>$result ("результат")</li>

29 <li>$euros ("евро")</li>

30 </ul>Берите на вооружение следующую структуру: функция - глагол, переменная - существительное.

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

32 <h2>Магические числа</h2>

33 Посмотрим еще раз на код:

34 С точки зрения профессиональной разработки, такой код не соответствуетлучшим практикам(best practices).

35 Уже сейчас, глядя на числа 60 и 1.25, вы скорее всего задаетесь вопросом: "Что это за числа?". Если человек видит код в первый раз, он не поймет, откуда числа взялись. В нашем примере контекст восстанавливается благодаря грамотному именованию, но в реальной жизни код значительно сложнее, и поэтому догадаться до смысла чисел зачастую невозможно.

36 Эту проблему вызываютмагические числа(magic numbers). Так называют числа, происхождение которых невозможно понять без глубокого знания этого кода.

37 Выход из ситуации прост - достаточно создать переменные с правильными именами, и так все встанет на свои места:

38 Обратите внимание на следующие детали в этом примере:

39 <ul><li>Мы использовали именование lowerCamelCase</li>

40 <li>Две новые переменные отделены от последующих вычислений пустой строчкой. Эти переменные имеют смысл и без вычислений, поэтому такое отделение уместно, оно повышает читаемость</li>

41 </ul>У нас получился хорошо именованный и структурированный код, но он длиннее прошлой версии. Так часто бывает, и это нормально, потому что код должен быть читабельным.