я тоже

есть еще такой

поставил эти два плагинчика, пока не понял чо они делают )) ошибку во вьювере так и не исправили

<? /** * @var $category Blahblahblah */ ?>

это куда нужно вставить,

я вообще удаляю эти комменты 😄

а какой в них толк?

у меня моник 17 дюймов

меня напрягают огромные комменты в коде

схлопывай

у друга вообще на каждый метод эти комменты расписывает

вот мужик

правильно

я никогда его не понимал и не понимаю нахрена ему эти комменты нужны

😫🔫

да что в них такого важного то ?

это навигация

именно так спасает: /** * @var $category Blahblahblah */

а вот так уже не спасает /* * @var $category Blahblahblah */

а я сперва думал не пашут такуие конструкции

надо погуглить

нафига они вообще нужны и что делаеют)

гугли phpdoc

нафига они вообще нужны и что делаеют)

как минимум для автокомплита в ИДЕ

еще в этих анотациях вишут конфиги и мапинги

нафига они вообще нужны и что делаеют)

Ты документируешь код Что, зачем и почему. Какой метод что возвращает. Это замечательная мастхэв практика

в yii правда я их не встречал

Потом можно и доку сгенерировать на оснвое таких комментов

Потом можно и доку сгенерировать на оснвое таких комментов

тяжелу "пэхапэшнику" объяснить зачем и как учитывать типы переменных и возвращаемых значений :D

))

Когда садишься копаться в чужом коде и нет подобных каментов - сразу приходит понимание

нафига гемороиться, если мой говнокод и так работает. Видимо человек еще не встречался с поддержкой легаси

Когда садишься копаться в чужом коде и нет подобных каментов - сразу приходит понимание

+

Когда садишься копаться в чужом коде и нет подобных каментов - сразу приходит понимание

да даже своего кода хватает, когда ему уже 2 и более лет, но надо что-то доделать

я коммента делаю рядом с функциями или ифами, я не делаю комменты описывающие - эта переменная хранит в себе Int эта переменная string я никогда это не делаю, я к логике делаю комменты и мой код легко понять благодаря им а вот общий когд перед методом я хз )) нет привычки делать

да даже своего кода хватает, когда ему уже 2 и более лет, но надо что-то доделать

Это классика. =)

я коммента делаю рядом с функциями или ифами, я не делаю комменты описывающие - эта переменная хранит в себе Int эта переменная string я никогда это не делаю, я к логике делаю комменты и мой код легко понять благодаря им а вот общий когд перед методом я хз )) нет привычки делать

Ну можно и так, но php дает много вольностей и сложно угадить что лежит в переменной

А так глянул и понятно что возвращается итд

я коммента делаю рядом с функциями или ифами, я не делаю комменты описывающие - эта переменная хранит в себе Int эта переменная string я никогда это не делаю, я к логике делаю комменты и мой код легко понять благодаря им а вот общий когд перед методом я хз )) нет привычки делать

Если делать нормальное описание метода, с хорошим неймингом, то код внутри метода не нуждается в коментариях как правило.

Если там не хаки/костыли.

а такое бывает?

мне в Джаве и Сишарпе было тяжело привыкнуть к указанию типа переменной или функции ))) пхп рай в этом плане

Рай ага. Если написал и забыл

А если надо поддерживать код через какое то время то ух какой рай

У строгой и нестрогой типизации есть свои плюсы и минусы. Но в целом строгая типизация мне больше нравится.

Мне тоже. Если сделал int то стринг без преобразования не запихаешь

С спишь спокойно))

я вот такие комменты делаю обычно http://shot.hsdn.org/gyUPQI7x

а целые блоки комментов я никогда не делаю, особенно типы данных не указываю никогда

😊 привычка

// возвращаем результат return $result ну зачем до такого... ))

но раз уж надо то надо, буду учить пхпдок

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

А так - у тебя по сути все это же размазано по всему методу

Вместо краткой и информативной аннотации

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

http://cs4.pikabu.ru/images/big_size_comm/2016-05_2/1462570887148441241.png

😄

вопрос есть как в Yii запретить AR тащить релейшены если они мне ненужны

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

PHPDoc

PostModel::find()->where([id=>123])->one() в итоге 3 запроса, вместо полезного одного

хз

указывать может табу еще ?

во вьювере пхп шторм указывает на ошибку, мол переменной такой нет

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

я мало знаю yii2 doc

да

вьюшка

представление

я не помню откуда такое слово -= вьювер

от кодигнайтера что ли

извиняюсь, нужно в магаз сгонять)

я никогда его не понимал и не понимаю нахрена ему эти комменты нужны

эти комменты самодокументируют код, что служит подспорьем для автоматической генерации документации и индексации кода IDE, о чем ты собственно и пишешь

а есть какой то инструмент для генерации документации по php doc?

а есть какой то инструмент для генерации документации по php doc?

ну в yii yiidoc например как раз генерирует

никто прям с такой проблемой несталкивался?

вопрос есть как в Yii запретить AR тащить релейшены если они мне ненужны

PostModel::find()->where([id=>123])->one() в итоге 3 запроса, вместо полезного одного