Что означают эти комментарии

@izcian · Регистрация: 28.08.2012

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

Иногда в комментариях например к классам встречаю вот такое:

PHP
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
var $basicPrice = 0;
    /**
     * Label for basic entry - if not free
     *
     * @var string
     */
    var $basicPriceLabel = '';
    /**
     * enable/disable cache
     *
     * @var boolean
     */
    var $cacheEnabled = false;
    /**
     * caceh lifetime
     *
     * @var integer
     */
    var $cacheLifetime = 0;
    /**
     * enable/disable cache
     *
     * @var boolean
     */

Я понимаю что означают они, просто любопытно. Зачем пишется собака? И зачем пишется что это стринг или булево значение если по коду и так ясно?

@AndreyDyakonov · 03.06.2013, 21:46

поскольку стандарты php никто не желает соблюдать, даже PSR.. то заморачиваться не стоит. Это какой-то формат оформления кода, вы можете придумать свой.. А пока не будет введено соблюдение стандартов на уровне интерпретатора... делайте что хотите и наплюйте на других

Изучайте лучше общие паттерны, да корпоративные стандарты конторы где вы работаете

@izcian · 04.06.2013, 08:54 **[ТС]**

))) Я просто думал, а вдруг это то же где-то описано, типа негласного правила (Вроде называть классы -отдельное слово с большой буквы), как то так...

@malframe · 04.06.2013, 09:52

Это формат оформления комментариев phpDocumentor. Представлено, кстати, очень сжато, там куча директив ещё есть. Предназначено это для создания оффлайн-документации по веб-проекту, т.е. документация создаётся прямо из кода, базируясь на указанных комментариях. Более подробно можете почитать здесь.

Новые блоги и статьи Все статьи Все блоги /
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 Сколько Государство потратило денег на меня, обеспечивая инсулином. Вот решила сделать интересный приблизительный подсчет, сколько государство потратило на меня денег на покупку инсулинов. . . .	Ломающие изменения в C#.NStar Alpha Etyuhibosecyu 20.11.2025 Уже можно не только тестировать, но и пользоваться C#. NStar - писать оконные приложения, содержащие надписи, кнопки, текстовые поля и даже изображения, например, моя игра "Три в ряд" написана на этом. . .	Мысли в слух kumehtar 18.11.2025 Кстати, совсем недавно имел разговор на тему медитаций с людьми. И обнаружил, что они вообще не понимают что такое медитация и зачем она нужна. Самые базовые вещи. Для них это - когда просто люди. . .	Создание Single Page Application на фреймах krapotkin 16.11.2025 Статья исключительно для начинающих. Подходы оригинальностью не блещут. В век Веб все очень привыкли к дизайну Single-Page-Application . Быстренько разберем подход "на фреймах". Мы делаем одну. . .	Фото: Daniel Greenwood kumehtar 13.11.2025

@AndreyDyakonov 122 / 120 / 7 Регистрация: 21.04.2013 Сообщений: 615
	03.06.2013, 21:46
	поскольку стандарты php никто не желает соблюдать, даже PSR.. то заморачиваться не стоит. Это какой-то формат оформления кода, вы можете придумать свой.. А пока не будет введено соблюдение стандартов на уровне интерпретатора... делайте что хотите и наплюйте на других Изучайте лучше общие паттерны, да корпоративные стандарты конторы где вы работаете 1

@izcian 2 / 2 / 0 Регистрация: 28.08.2012 Сообщений: 115
	04.06.2013, 08:54 [ТС]
	))) Я просто думал, а вдруг это то же где-то описано, типа негласного правила (Вроде называть классы -отдельное слово с большой буквы), как то так... 0

@malframe 9 / 9 / 4 Регистрация: 11.05.2013 Сообщений: 110
	04.06.2013, 09:52
	Это формат оформления комментариев phpDocumentor. Представлено, кстати, очень сжато, там куча директив ещё есть. Предназначено это для создания оффлайн-документации по веб-проекту, т.е. документация создаётся прямо из кода, базируясь на указанных комментариях. Более подробно можете почитать здесь. 0