Одной из частей Zend Framework Certification является Zend Coding Standards. Рассмотрим, что нужно знать для успешной сдачи сертификации (материал из официального руководства по подготовке к сертификации).

Хорошие стандарты кодирования являются очень важным аспектом в разработке любого проекта.
Особенно, если над одним проектом трудятся несколько разработчиков.
Наличие стандартов кодирования помогает удостовериться, что код имеет высокое качество,
мало багов и его легко поддерживать.

Форматирование PHP файлов

• Никогда не используйте закрывающий тег “?>” для файлов, которые содержат только PHP код -
  это предотвращает от лишних пробелов и спецсимволов при выводе
• Отступ должен - 4 пробела, не используйте символ табуляции
• Максимальная длина строки - 120 символов, но старайтесь не превышать количества
  в 80 символов для понятности
• Строки должны заканчиваться символом перехода на новую строку (Unix), но не символом возврата каретки или комбинацей последнего с первым

Правила именования

Имена классов

• Имя класса должно быть привязано к его расположению в директориях (фактически имя класса - путь к файлу класса)
• Содержат только буквенно-цифровые символы. Цифры не одобряются. Знак нижнего подчеркивания используется только в качестве разделителя пути к файлу класса (например: Zend/Db/Table.php привязан к Zend_Db_Table)
• Имена, содержащие несколько слов: в общем случае, каждое слово содержит большую первую букву, остальные - в нижнем регистре (например: Zend_Pdf). Но есть исключения, когда слово представляет собой сокращение или какое-либо нестандартное слово (например: Zend_XmlRpc)
• Классы, созданные разработчиками ZF или его партнерами, должны начинаться на “Zend_” и обязаны быть расположены в иерархии папки Zend/ и с другой стороны класс, написанный не разработчиками ZF никогда не может начинаться на “Zend_”

Интерфейсы

Интерфейсы должны следовать таким же правилам, как и классы, и заканчиваться словом “Interface”
(например: Zend_Log_Adapter_Interface)

Имена файлов

• Для всех файлов разрешаются буквенно-цифровые символы, символ подчеркивания и дефис. Пробелы запрещены
• Любой файл, который содержит любой PHP код, должен иметь расширение “.php”, за исключением View скриптов

Имена функций

• Могут содержать только буквенно-цифровые символы. Символ подчеркивания не разрешается.
  Цифры не желательны
• Имена, состоящие из нескольких слов: camelCase стиль
• Функция должна иметь осмысленное имя для улучшения понимания кода (ну это и так понятно :)
• Аксессоры для объектов должны начинаться с “get” или “set” (ООП)
• (Примечание: не рекомендуется использование функций в глобальной области видимости. В таком случае сделайте эти функции методами статического класса)

Имена методов

• Всегда начинаются с буквы в нижнем регистре
• Должны содержать имя паттерна, если он применяется
• private и protected методы должны начинаться с символа нижнего подчеркивания
  (единственный случай, когда символ подчеркивания разрешен в имени метода) - хотя, сами Zendовцы не всегда придерживаются данного пункта :)

Имена переменных

• Также как и функции могут содержать только буквенно-цифровые символы. Символ подчеркивания не разрешается. Цифры не желательны
• Всегда начинаются с буквы в нижнем регистре, camelCase
• private и protected переменные начинаются с подчеркивания

Именование констант

• Могут содержать буквенно-цифровые символы и знаки подчеркивания
• Используются буквы в верхнем регистре
• Имена, состоящие из нескольких слов: каждое слово отделяется символом подчеркивания
• Должны быть определены как члены класса при помощи конструкции “const”

Стиль кодирования

Установка границ PHP кода

• PHP код должен быть разграничен тегами <?php и ?>
• Короткая запись тегов не разрешена (<? и ?>)

Строки - литералы

• Если строка является литералом (не содержит никаких подстановок переменных), то она определяется в одиночных кавычках (например: $str = ‘Пример строки-литерала’)
• В случае, если строка содержит апостроф, она может быть заключена в двойные кавычки. Это особенно одобряется для написания SQL запросов

Строки - конкатенация

• Строки могут быть сконкатенированы при помощи оператора “.”, при этом должен присутствовать пробел перед и после оператора
• Для более удобного восприятия длинные строки можно разбивать на несколько, при этом оператор конкатенации ставится в начале строки, на уровне знака присваивания:

$sql = “SELECT `id`, `name` FROM `people` “
     . “WHERE `name` = ‘Inga’ “
     . “ORDER BY `name` ASC”;

Массивы с цифровыми индексами

• Отрицательные значения не разрешены для использования в качестве индексов
• Могут начинаться с положительного индекса (больше нуля), но такое не одобряется. Лучше использовать 0 для начала индекса массива
• Для массивов, которые определяются при помощи функции array в несколько строк каждая следующая строка должна начинаться на уровне первого заданного значения в массиве

Ассоциативные массивы

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

$sampleArray = array(‘firstKey’  => ‘firstValue’,
                     ’secondKey’ => ’secondValue’);

Обявление класса

• Открывающая фигурная скобка ставится на следующей строке после имени класса (”one true brace” форма)
• Код класса должен иметь отступ в 4 пробела, без табуляций (зачем это снова напоминать? :)
• В одном файле - только один класс, не больше
• Добавление дополнительного кода в файл класса не рекомендуется. Если же данная ситуация имеет место, то класс и дополнительный код разделяются двумя пустыми строками

Свойства класса

• Именование свойств класса аналогично именованию обычных переменных (см. выше)
• Свойства класса определяются в самом верху тела класса (до методов)
• Объявление свойств класса осуществляется при помощи спецификаторов доступа private, protected или public (старая конструкция var запрещена)
• Доступ к свойствам класса на прямую, указав для них спецификатор public не одобряется. Пользуйтесь методами аксессорами (get/set)

Методы класса

• Именование методов аналогично правилам для функций
• Методы объявляются при помощи спецификаторов доступа private, protected или public
• Открывающая фигурная скобка пишется с новой строки, после имени метода. Между именем функции и открывающей круглой скобкой никаких пробелов
• Функции в глобальной области видимости сильно не одобряются
• Передача по ссылке разрешена только в объявлении функции
• Аргументы, которые передаются в функцию разделяются запятыми с пробелом

Операторы управления - if/else

• Управляющие операторы if/else должны иметь пробел перед открывающей круглой скобкой (условие), а также пробел после закрывающей круглой скобки
• Для условия внутри скобок операторы отделяются пробелами. Использование круглых скобок для группировки множественных условий одобряется
• Открывающая фигурная скобка пишется на строке, где написано условие. Закрывающая фигурная скобка пишется на отдельной строке. Код внутри фигурных скобок имеет отступ в 4 пробела (а они опять о том же :)

if ($someValue > 0) {
    $checked = true;
} else {
    $newValue = 7;
}

Switch

• Также как и для if - пробелы вокруг круглых скобок
• Все операторы switch должны иметь default case

switch ($key) {
    case KEY_UP:
        $obj->moveUp();
        break;
    case KEY_DOWN:
        $obj->moveDown();
        break;
    default:
}

Внутритекстовая документация - формат документации

• Все блоки документации (”docblocks”) должны быть совместимы с форматом phpDocumentor
• Все файлы с исходным кодом, написанные для Zend Framework, или которые взаимодействуют с фреймворком, должны содержать блок документации уровня файла (”file-level” docblock) в верхней части каждого файла. А также блок документации уровня класса(”class-level” docblock)

Внутритекстовая документация - файлы

• Каждый файл, содержащий PHP код должен иметь блок документации в формате phpDocumentor. Минимальный блок должен содержать следующее:

/**
 * Краткое описание для файла
 *
 * Длинное описание для файла (если есть)...
 *
 * LICENSE: информация о лицензии
 *
 * @copyright 2009 Zend Technologies
 * @license    http://www.zend.com/license/3_0.txt    PHP License 3.0
 * @version    $Id:$
 * @link         http://dev.zend.com/package/PackageName
 * @since      File available since Release 1.2.0
 *
 */

Внутритекстовая документация - классы

• Правила как и для файлов. Минимальный набор phpDocumentor тегов: Descriptions, @copyright, @license, @version, @link, @since, @deprecated

Внутритекстовая документация - функции

• Каждая функция и методы объектов должны иметь блок документации. Он должен содержать описание функции, все аргументы и все возможные возвращаемые значения
• Не обязательно использовать “@access” тег
• Для функций и методов, которые могут выбрасывать исключения лучше использовать @throws тег

Написав свой пост jQuery примеры, я задумался о том,
что некоторые начинающие разработчики сразу берутся за изучение какого-либо javascript framework’a
без нормальных знаний чистого javascript. Это не есть хорошо, поэтому я буду приводить примеры не только на jQuery, но и на чистом джаваскрипте.

И так, приступим.

Работа с выпадающим списком на чистом javascript

Перечислим список основного, что нужно знать при работе с выпадающим списком:

Элемент select:

• select имеет коллекцию элементов option (свойство select.options). Данное свойство представляет собой массив,
  к элементам которого можно обратиться по индексу
• количество options в select хранит свойство select.length или select.options.length
• свойство select.selectedIndex содержит индекс текущего выбранного элемента option
• свойство select.value содержит значение выбранного элемента option
• выпадающий список с множественным выбором можно сделать используя атрибут multiple=”multiple”

Элемент option:

• option.value - значение элемента
• option.index - индекс элемента в коллекции HTMLOptionsCollection
• option.selected - атрибут, который показывает состояние элемента выбран/не выбран
• option.disabled - атрибут, который отвечает состояние элемента доступен/не доступен

У нас есть все тот же HTML элемент <select>:

<select id=“sel“ name=“sel“>
  <option value=“0“>zero</option>
  <option value=“1“>one</option>
  <option value=“2“>two</option>
  <option value=“3“>three</option>
</select>

1. Получить значение выбранного элемента

var value = document.getElementById(’sel’).value

2. Получить текст выбранного элемента

var sel = document.getElementById(’sel’);
var text = sel.options[sel.selectedIndex].text;

3. Добавить элемент в конец списка

var sel = document.getElementById(’sel’);
// создаем элемент option
var opt = document.createElement(‘option’);
// определяем значение и текст нового элемента
opt.value = 4;
opt.innerHTML = ‘four’;
// добавляем option в конец select
sel.appendChild(opt);

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

var sel = document.getElementById(’sel’);
var opt = document.createElement(‘option’);
opt.value = -1;
opt.innerHTML = ‘minus’;
sel.insertBefore(opt, sel.options[0]);

5. Вставить элемент после заданного элемента (после второго)

var sel = document.getElementById(’sel’);
var opt = document.createElement(‘option’);
opt.value = 7;
opt.innerHTML = ‘inserted’;
sel.insertBefore(opt, sel.options[2]);

6. Удалить выбранный элемент

var sel = document.getElementById(’sel’);
sel.removeChild(sel.options[sel.selectedIndex]);

7. Очистить select

var sel = document.getElementById(’sel’);
var nodes = sel.childNodes;
var len = nodes.length;
for (var i=len-1; i>=0; i–)
{
    sel.removeChild(nodes[i]);
}

8. Сделать элемент выбранным (последний)

var sel = document.getElementById(’sel’);
// вариант №1: через установку атрибута для option
sel.options[sel.length - 1].setAttribute(’selected’, ’selected’);
// вариант №2: используя свойство selectedIndex для select
sel.selectedIndex = sel.length - 1;

9. Сделать элемент недоступным (первый)

var sel = document.getElementById(’sel’);
sel.options[0].setAttribute(‘disabled’, ‘disabled’);

10. Изменить цвет текста всех элементов, кроме выбранного

var sel = document.getElementById(’sel’);
for(var i=0; i<sel.length; i++)
{
    if (i != sel.selectedIndex) {
        sel.options[i].style.color = ‘red’;
    }
}

Хороши фреймворки, да основы надо знать :)

В приложениях которые используют jQuery framework, обработчики событий практически всегда задаются так:

$(document).ready(function(){
  // do something…
});

Т.е. все действия будут выполнятся после полной загрузки документа. Но если у нас на странице единственный компонент javascript, использование которого не требует полной загрузки страницы? В данной ситуации можно задавать обработчик как только будет загружен javascript компонент (а не весь документ). Рассмотрим на примере: у нас есть компонент “часы” - для работы которого нужен элемент div. В данном случае javascript действия можно выполнять уже после загрузки элемента div с id=”clock”, например:

$(‘#clock’).ready(function(){
  // init clock
});

Все предельно просто, но а если у нас много javascript компонентов?
С данной проблемой я столкнулся на работе: вся страница грузится с нормальной скоростью, а баннеры загружаются в последнюю очередь. При чем этот процесс занимает слишком много времени. Получается, что используя обработчик вида $(document).ready(function(){…}); javascript ожидает загрузки всех баннеров. И в это время страница, состоящая из ajax элементов, находится в неработоспособном состоянии. Но, к счастью, jQuery позволяет вызвать ready вручную (jQuery ready manual call):

Данный метод сообщает о том, что документ был загружен. Таким образом можно использовать стандартный обработчик $(document).ready(function(){…});
Проблема была решена следующим образом: в главный layout шаблон, делается javascript вставка перед закрывающимся тегом body:

<script type=“text/javascript”>
 jQuery.ready();
</script>

Так и не удалось до отъезда запостить это:

Ну что ж, вот и подходит к концу 2008-й год. Как-то грустно немного… Сегодня последний рабочий день в этом году.
Принято подводить итоги уходящего года. Что ж, постараюсь вкратце описать прошедший 2008-й год.

Во-первых: наконец-то я могу полностью себя обеспечить (и не только себя :).
Я закончил институт. Хм… даже 2 заведения! (Украинская государственная академия железнодорожного транспорта и Компьютерная академия ШАГ). Особое спасибо именно второму заведению, т.к. если бы не ШАГ, то не было бы меня в IT сфере…

Сменил работу. Очень хорошо сменил - если чесно, я мечтал работать на этой фирме. И вот я здесь :) (можно сюда еще добавить приобретение неплохих skills по настольному теннису).

Все остальное - в принципе, мелочи: занялся посеръезнее своими проектами, готовлюсь к Zend PHP сертификации (как оказалось и к Zend Framework Certification), более глубже заинтересовался SEO (с точки зрения программирования) и многое другое, чего жизнь меня заставила понять…

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

Всем Вам желаю удачного Нового Года! Успехов в достижении целей!

Главное - верить!

P.S.: празднование Нового Года было просто обалденным!