Форумы портала PHP.SU :: Версия для печати :: Стандарт оформления имён переменных и массивов

1. artoptix - 29 Мая, 2017 - 16:08:11 - перейти к сообщению

Здравствуйте!
Знатоки, подскажите - есть ли какой-нибудь стандарт или "правило хорошего тона" для оформления имён переменных и массивов?
Часто, разбирая чужой код или даже свой через пару месяцев его написания, не сразу бывает понятно переменная перед тобой или это массив...
Скажем $pin = samopisnya_funcsya();
Так вот пока не откроешь и не посмотришь, что возвращает эта самописная функция сказать что помещается в $pin невозможно.
Разбирая чужие коды встречал следующие обозначения:
$pin - простая переменная
$pin_arr - массив (приставка _arr говорит о том, что это массив)
и
$_pin - массив (по анологии с $_SERVER, $_POST.....)
Так как же всётаки правильно?

2. caballero - 29 Мая, 2017 - 17:09:06 - перейти к сообщению

как угодно лишь бы было понятно то за переменная

3. Строитель - 29 Мая, 2017 - 17:24:37 - перейти к сообщению

Цитата:

пока не откроешь и не посмотришь, что возвращает эта самописная функция

А вы код пишете в чём?

4. andrewkard - 29 Мая, 2017 - 17:53:42 - перейти к сообщению

PSR-1, PSR-2, http://www.php.su/lessons/?lesson_13, https://framework[dot]zend[dot]com/manua[dot][dot][dot]oding-style[dot]html
В общем, в интернете есть подборки.
(Добавление)
Имя переменной должно говорить о содержимом. Вот так точно не нужно:

artoptix пишет:

samopisnya_funcsya

(Добавление)
https://learn[dot]javascript[dot]ru/variable-names

5. artoptix - 29 Мая, 2017 - 20:13:31 - перейти к сообщению

Строитель пишет:

А вы код пишете в чём?

На рабочем компе стоит NetBeans, но иногда приходится править в Notepad++

6. Строитель - 29 Мая, 2017 - 20:20:24 - перейти к сообщению

artoptix пишет:

Строитель пишет:

А вы код пишете в чём?

На рабочем компе стоит NetBeans, но иногда приходится править в Notepad++

В NetBeans разве нет всплывающих уведомлений, которые отображают информацию о функции, при наведении курсора на её круглые скобки? (сперва попробуйте на встроенные php-функции навести курсор мыши)
(Добавление)
Может быть ещё понадобится нажать F1 при наведении.

7. artoptix - 29 Мая, 2017 - 20:22:24 - перейти к сообщению

andrewkard пишет:

https://framework[dot]zend[dot]com/manua[dot][dot][dot]oding-style[dot]html

Согласно этого документа правильно будет $pinArray
С этим разобрался. Спасибо.

А есть ли правило для указания "мерности" массива? Тот же $pinArray ничего не говорит о том скольки мерный этот массив.
(Добавление)

Строитель пишет:

artoptix пишет:

Строитель пишет:

А вы код пишете в чём?

На рабочем компе стоит NetBeans, но иногда приходится править в Notepad++

В NetBeans разве нет всплывающих уведомлений, которые отображают информацию о функции, при наведении курсора на её круглые скобки? (сперва попробуйте на встроенные php-функции навести курсор мыши)
(Добавление)
Может быть ещё понадобится нажать F1 при наведении.

(Добавление)

Строитель пишет:

artoptix пишет:

Строитель пишет:

А вы код пишете в чём?

На рабочем компе стоит NetBeans, но иногда приходится править в Notepad++

В NetBeans разве нет всплывающих уведомлений, которые отображают информацию о функции, при наведении курсора на её круглые скобки? (сперва попробуйте на встроенные php-функции навести курсор мыши)
(Добавление)
Может быть ещё понадобится нажать F1 при наведении.

Может я отключил какой-то плагин (по-ошибке посчитав его лишним), но у меня никакой информации о функции не выводится, даже с F1. Попробую покопаться в плагинах и установить такой.

8. Строитель - 29 Мая, 2017 - 20:38:20 - перейти к сообщению

artoptix пишет:

у меня никакой информации о функции не выводится, даже с F1

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

PHP:
скопировать код в буфер обмена

/**
* Выделяет текст жирным шрифтом
* 
* @param string $name Имя пользователя
* 
* @return string
*/
function foo($name) {
    return "<b>$name</b>";
}