В рейтинге участвует:

групп:

каналов:

Виртуальный сервер на SSD - недорого!

Аренда выделенных и виртуальных серверов (VDS/VPS), хостинг, аренда IP-адресов, администрирование, круглосуточная поддержка

qwarta.ru подробнее

Резервное копирование с проверкой на вирусы!!!

Удобный сервис создания резервных копий на любой сервер сети интернет. Отслеживайте изменения, проверяйте на вирусы. Надежно защитите свой бизнес!

go.backupland.com

Выбираете сервер? Любая конфигурация на заказ!

Аренда физических серверов любых конфигураций под любые запросы - 1С бухгалтерия, игровые сервера, нагруженные проекты, интернет-магазины!

qwarta.ru подробнее

Size: a a a

Yii Framework 3

611 membersпожаловаться на группу
2020 December 03

AM

Alexander Makarov in Yii Framework 3
mj4444
Вот ещё пример
   /**
    * @throws HeadersHaveBeenSentException
    * @return bool
    */
Если например я укажу только @throws, то PhpStorm ругается "Argument PHPDoc missing". Нужно указывать @return bool или нет?
Я как бы с PhpStorm согласен, либо нет коммента, либо в нём указывается всё.
Это настраивается.
источник
13:36пожаловаться#1

AM

Alexander Makarov in Yii Framework 3
https://github.com/yiisoft/docs/blob/master/010-code-style.md#comments
GitHub
yiisoft/docs
Various Yii 3.0 related documentation. Contribute to yiisoft/docs development by creating an account on GitHub.
источник
13:36пожаловаться#2

AM

Alexander Makarov in Yii Framework 3
> Method comment is necessary except it adds nothing to what method name and signature already has.
источник
13:36пожаловаться#3

AM

Alexander Makarov in Yii Framework 3
То есть если у нас там просто @return bool и при этом у метода и так прописано что bool, то нафиг такой коммент не нужен.
источник
13:37пожаловаться#4

AM

Alexander Makarov in Yii Framework 3
Если же там @return bool If bla-bla is alright, то уже норм.
источник
13:38пожаловаться#5

AM

Alexander Makarov in Yii Framework 3
Здесь есть новая информация, которой нет в сигнатуре.
источник
13:38пожаловаться#6

m

mj4444 in Yii Framework 3
Alexander Makarov
Это настраивается.
Понятно что настраивается. Я о том как нужно на самом деле в случаях когда у части элементов есть bla-bla, а у части нет.
источник
13:39пожаловаться#7

m

mj4444 in Yii Framework 3
Alexander Makarov
Здесь есть новая информация, которой нет в сигнатуре.
Например PhpStorm так же ругается если я в phpdoc не опишу все возможные Exception.
В коде yii3 нужно описывать все возможные Exсepton или нет?
источник
13:40пожаловаться#8

m

mj4444 in Yii Framework 3
Вот ещё пример
@param int $number1
@param int $number2 bla-bla-bla
$number1 не имеет комментария. Его нужно указывать?
источник
13:42пожаловаться#9

AM

Alexander Makarov in Yii Framework 3
mj4444
Например PhpStorm так же ругается если я в phpdoc не опишу все возможные Exception.
В коде yii3 нужно описывать все возможные Exсepton или нет?
Ну да. Нужно.
источник
13:50пожаловаться#10

AM

Alexander Makarov in Yii Framework 3
Но не все, рантайм описывать смысла особо нет.
источник
13:50пожаловаться#11

AM

Alexander Makarov in Yii Framework 3
Но можно.
источник
13:50пожаловаться#12

AM

Alexander Makarov in Yii Framework 3
mj4444
Вот ещё пример
@param int $number1
@param int $number2 bla-bla-bla
$number1 не имеет комментария. Его нужно указывать?
Если сигнатура метода такая: function bla(int $number1, int $number2), то не нужно. Он не добавляет никакой инфы вообще.
источник
13:51пожаловаться#13

AM

Alexander Makarov in Yii Framework 3
Но тут лучше добавить инфу, чем убирать.
источник
13:51пожаловаться#14

m

mj4444 in Yii Framework 3
Alexander Makarov
Но не все, рантайм описывать смысла особо нет.
В phpstorm есть правила, унаследованные от рантайм (и ещё 2 классов) он не добавляет в phpdoc.
источник
14:14пожаловаться#15

AM

Alexander Makarov in Yii Framework 3
mj4444
В phpstorm есть правила, унаследованные от рантайм (и ещё 2 классов) он не добавляет в phpdoc.
И правильно делает.
источник
14:15пожаловаться#16

m

mj4444 in Yii Framework 3
Alexander Makarov
Ну да. Нужно.
Если я добавляю в phpdoc Exception, phpstorm хочет что бы я так же добавил описание параметров и возвращаем ого типа. С этим как быть? добавлять или оставить только Exception?
источник
14:17пожаловаться#17

AM

Alexander Makarov in Yii Framework 3
mj4444
Если я добавляю в phpdoc Exception, phpstorm хочет что бы я так же добавил описание параметров и возвращаем ого типа. С этим как быть? добавлять или оставить только Exception?
Если добавлять, то с описанием.
источник
14:23пожаловаться#18

AM

Alexander Makarov in Yii Framework 3
Если без описания, то не добавлять.
источник
14:23пожаловаться#19

m

mj4444 in Yii Framework 3
Alexander Makarov
Если без описания, то не добавлять.
То есть оставлять только @throws строки?
источник
14:24пожаловаться#20