Стиль кода, рекомендации кроме PSR

@4ik · Регистрация: 05.02.2013

Студворк — интернет-сервис помощи студентам

Всем привет.
Появилось несколько вопросов по написанию кода выходящие за ранки PSR'ов. Буду очень благодарен если Вы мне на них ответите. Есть какие-либо еще рекомендации по написанию кода помимо PSR, которые широко используются?

Что лучше использовать and\or или &&\|| ? (хочу использовать and\or, мне кажется это безопаснее)
вопрос по 7 версии: лучше пытаться всюду описывать типы аргументов и возвращаемых значений в строгом стиле или вовсе не описывать (если это ситуативно, пожалуйста, расскажите подробнее)?
Наличие функций вне классов (глобальных относительно их namespace'а) это норм или этого следует избегать?

как лучше разбивать на строки условия например в if?

PHP
1
2
3
4
if (expr || expr || expr || expr || expr || 
    expr1 || expr1 || expr1 || expr1 || expr1) {
 
}

или

PHP
1
2
3
4
5
6
7
if (
    expr || 
    expr || 
    expr || 
   ) {
 
}

@Jewbacabra · 18.02.2018, 08:38

Сообщение от 4ik

Есть какие-либо еще рекомендации по написанию кода помимо PSR, которые широко используются?

Symfony coding standards, хотя мне не все пункты в них нравятся
Тут стоит упомянуть php-cs-fixer который может автоматически форматировать код согласно большому количеству правил. Есть возможность добавлять и свои правила

Сообщение от 4ik

Что лучше использовать and\or или &&\|| ?

Это два разных оператора, они не взаимозаменяемы

PHP
1
2
3
$a = false || true;
$b = false or true;
var_dump($a, $b);

Сообщение от 4ik

хочу использовать and\or, мне кажется это безопаснее

Безопасность тут не при чем. При этом поведение and/or может быть неожиданным, особенно для пришедших из других ЯП. &&/|| ведет себя так же, как и во многих других ЯП.

Сообщение от 4ik

вопрос по 7 версии: лучше пытаться всюду описывать типы аргументов и возвращаемых значений в строгом стиле или вовсе не описывать (если это ситуативно, пожалуйста, расскажите подробнее)?

В новом коде лучше везде описывать.

Сообщение от 4ik

Наличие функций вне классов (глобальных относительно их namespace'а) это норм или этого следует избегать?

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

Сообщение от 4ik

как лучше разбивать на строки условия например в if?

PHP
1
2
3
4
5
6
7
if (
    $expr1 ||
    $expr2 ||
    // ...
) {
    //..
}

Еще лучше такого не допускать, используя промежуточные условия

PHP
1
2
3
4
5
$a = $expr1 || $expr2 /* || ...*/;
$b = $expr3 || $expr4;
if ($a && $b) {
    // ...
}

@Para bellum · 18.02.2018, 08:47

Сообщение от 4ik

хочу использовать and\or, мне кажется это безопаснее

Почему кажется?

Сообщение от 4ik

лучше пытаться всюду описывать типы аргументов и возвращаемых значений в строгом стиле или вовсе не описывать

Ситуативно. Если пишите interface/abstract, допустим, можно указать тип, чтобы заставить реализации возвращать строго определённый тип.

Сообщение от 4ik

Наличие функций вне классов (глобальных относительно их namespace'а) это норм или этого следует избегать?

Нормально. Без helper'ов ни один проект не обойдётся. А они как правило в глобальном пространстве.

Сообщение от 4ik

как лучше разбивать на строки условия например в if?

Вариант 2, считаю.

@otto-fukin · 18.02.2018, 09:20

Сообщение от Jewbacabra

В новом коде лучше везде описывать.

Я бы смотрел по месту. Из функции с жестко заданным типом возвращаемого значения (напр. объект класса) не получится вернуть null в случае неудачи. А такая возможность удобна. придется кидаться исключениями, а потом их ловить. Чтобы ненужной писанины не добавлять проще не указывать тип

@Jewbacabra · 18.02.2018, 09:27

Сообщение от otto-fukin

Из функции с жестко заданным типом возвращаемого значения (напр. объект класса) не получится вернуть null в случае неудачи

Да ну

PHP
1
2
3
4
5
6
7
8
function int_or_null(): ?int {
    if (mt_rand() === 42) {
        return 42;
    }
 
    return null;
}
var_dump(int_or_null());

Сообщение от otto-fukin

вернуть null в случае неудачи

Если неудача подразумевает ошибку, то следует именно кидать исключение

@otto-fukin · 18.02.2018, 09:32

Сообщение от Jewbacabra

Да ну

PHP
1
2
3
4
5
6
7
class c{
    
}
function cc():c{
    return null;
}
cc();

Fatal error: Uncaught TypeError: Return value of cc() must be an instance of c, null returned in

Сообщение от Jewbacabra

Если неудача подразумевает ошибку, то следует именно кидать исключение

разработчики других яп несколько иначе на это смотрят

@Jewbacabra · 18.02.2018, 09:36

otto-fukin, да ну

PHP
1
2
3
4
5
6
7
8
class c{
    
}
 
function cc(): ?c {
    return null;
}
cc();

https://ideone.com/iSKhKK
https://secure.php.net/manual/... atures.php

Сообщение от otto-fukin

разработчики других яп несколько иначе на это смотрят

При чем тут разработчики языков? Есть языки в которых есть исключения, есть в которых нет, и в них используются другие механизмы обработки ошибок. В php исключения есть, и следует их использовать для обработки ошибок.

Новые блоги и статьи Все статьи Все блоги /
Советы по крайней бережливости. Внимание, это ОЧЕНЬ длинный пост. Programma_Boinc 28.12.2025 Советы по крайней бережливости. Внимание, это ОЧЕНЬ длинный пост. Налог на собак: https:/ / ********/ gallery/ V06K53e Финансовый отчет в Excel: https:/ / ********/ gallery/ bKBkQFf Пост отсюда. . .	Кто-нибудь знает, где можно бесплатно получить настольный компьютер или ноутбук? США. Programma_Boinc 26.12.2025 Нашел на реддите интересную статью под названием Anyone know where to get a free Desktop or Laptop? Ниже её машинный перевод. После долгих разбирательств я наконец-то вернула себе. . .	Thinkpad X220 Tablet — это лучший бюджетный ноутбук для учёбы, точка. Programma_Boinc 23.12.2025 Рецензия / Мнение/ Перевод Нашел на реддите интересную статью под названием The Thinkpad X220 Tablet is the best budget school laptop period . Ниже её машинный перевод. Thinkpad X220 Tablet —. . .	PhpStorm 2025.3: WSL Terminal всегда стартует в ~ and_y87 14.12.2025 PhpStorm 2025. 3: WSL Terminal всегда стартует в ~ (home), игнорируя директорию проекта Симптом: После обновления до PhpStorm 2025. 3 встроенный терминал WSL открывается в домашней директории. . .	Как объединить две одинаковые БД Access с разными данными VikBal 11.12.2025 Помогите пожалуйста !! Как объединить 2 одинаковые БД Access с разными данными.
Новый ноутбук volvo 07.12.2025 Всем привет. По скидке в "черную пятницу" взял себе новый ноутбук Lenovo ThinkBook 16 G7 на Амазоне: Ryzen 5 7533HS 64 Gb DDR5 1Tb NVMe 16" Full HD Display Win11 Pro	Музыка, написанная Искусственным Интеллектом volvo 04.12.2025 Всем привет. Некоторое время назад меня заинтересовало, что уже умеет ИИ в плане написания музыки для песен, и, собственно, исполнения этих самых песен. Стихов у нас много, уже вышли 4 книги, еще 3. . .	От async/await к виртуальным потокам в Python IndentationError 23.11.2025 Армин Ронахер поставил под сомнение async/ await. Создатель Flask заявляет: цветные функции - провал, виртуальные потоки - решение. Не threading-динозавры, а новое поколение лёгких потоков. Откат?. . .	Поиск "дружественных имён" СОМ портов Argus19 22.11.2025 Поиск "дружественных имён" СОМ портов На странице: https:/ / norseev. ru/ 2018/ 01/ 04/ comportlist_windows/ нашёл схожую тему. Там приведён код на С++, который показывает только имена СОМ портов, типа,. . .	Сколько Государство потратило денег на меня, обеспечивая инсулином. Programma_Boinc 20.11.2025 Сколько Государство потратило денег на меня, обеспечивая инсулином. Вот решила сделать интересный приблизительный подсчет, сколько государство потратило на меня денег на покупку инсулинов. . . .