Cтандарты php кодирования Zend Framework (ну, вы поняли) в Гомеле =)

Популярные рубрики

Гомель восстановление html Classic Shell обслуживание компьютеров ремонт мобильных разработка рекомендация doctrine Стив Джобс яндекс создание сайта предложение продвижение стандарт защита разработчикам сайтов win сайт simonscat.com компьютерная помощь беларусь перепрошивка разработка сайта создание сайтов ремонт принтеров мобильные телефоны Ветка разлочка разработка сайтов CMS ремонт компьютеров установка Windows 7 repair заказать сайт разработчик Windows 10 аякс серия ноутбук ОС stash установка Windows гит компютеры ajax ошибка виджет orm Гомеле конкуренция yandex лицензия iOS software installation windows networks объявления gomel абонентское обслуживание кошки установка Виндовс ipad в смех сквозь слезы лазерных разработчики php framework артефакты гомель принтер Беларусь Разработка сайтов установка программ консультация seo iphone поисковые системы git лоты код сайтов массивы gandal.by Восстановление информации zf Добруш мобильное Apple курсы приложение ремонт мониторов конкатенация интернет iTunes zend репозиторий тест настройка google ssl гандаль Техническое обслуживание мультфильмы simonscat кризис проблемы домен перегрев iPad обслуживание организации приватность восстановление информации сломался ветви прошивка Компьютерная помощь реламная площадка заправка картриджей просто кошмар в Гомеле юмор Android выбор iMac скидки nVidia антивирусы сайты как делать нельзя IT rebase формы оборудование Metro индексация nForce iPod ремонт винчестеров заправка принтеров recovery классы sql hp лечение вирусов переменные iPhone сервис джеилбрейк компьютеры восстановление данных переустановка

Результаты поиска по запросу тега: zend

Июня
2010 года
25
Cтандарты php кодирования Zend Framework (ну, вы поняли) в Гомеле =)

Как обычно, продолжаем заливать полезную копипасту.На этот раз, обратимся к стандартам кодирования ZF.

Обрамление PHP-кода

PHP-код должен всегда обрамлятся полными PHP-тегами:


?>

Короткие теги не допустимы.

Строки

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

Когда строка является литеральной (не содержит подстановок переменных), для ее обрамления должны использоваться апострофы или "одинарные кавычки":

$a = 'Example String';

Строковые литералы, содержащие апострофы

Когда строка литералов сама содержит апострофы, разрешается для обрамления строки использовать "двойные кавычки". Это особенно актуально для SQL-запросов:

$sql = "SELECT `id`, `name` from `people` WHERE `name`='Fred' OR `name`='Susan'";
Синтаксис выше является более предпочтительным, чем экранирование апострофов.

Подстановка переменных

Подстановка переменных разрешается с использованием двух нижеприведенных форм:

$greeting = "Hello $name, welcome back!";

$greeting = "Hello {$name}, welcome back!";

Для надежности, эта форма не допустима:

$greeting = "Hello ${name}, welcome back!";

Конкатенация строк

Строки должны объединятся с помощью оператора ".". Пробел должен всегда добавлятся до и после оператора "." для улучшения читабельности:

$company = 'Zend' . 'Technologies';

Когда производится конкатенация строк с помощью оператора ".", разрешается разрывать выражение на несколько строк для улучшения читабельности. В этом случае, каждая следующая строка должна быть дополнена пробелами так, чтобы оператор "." был выровнен под оператором "=":

$sql = "SELECT `id`, `name` FROM `people` "
. "WHERE `name` = 'Susan' "
. "ORDER BY `name` ASC ";

Массивы

Массивы с числовыми индексами

Отрицательные числа в качестве индексов запрещены.

Хотя индекс массива может начинаться с отрицательного числа, но это не приветствуется и рекомендуется, чтобы все массивы начинали индексирование с 0.

Когда определяется индексированный массив с помощью конструкции array, завершающий пробел должен быть добавлен после каждой запятой для улучшения читабельности:

$sampleArray = array(1, 2, 3, 'Zend', 'Studio');

Также разрешается определять многострочные индексированные массивы, используя конструкцию "array". В этом случае, каждая следующая строка должна быть дополнена пробелами так, чтобы начало каждой строки было выравнено как показано ниже:

$sampleArray = array(1, 2, 3, 'Zend', 'Studio',
$a, $b, $c,
56.44, $d, 500);

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

Когда определяется ассоциативный массив с помощью конструкции "array", приветствуется разделение выражения на несколько строк. В этом случае, каждая следующая строка должна быть дополнена с помощью пробелов так, чтобы и ключи и значения были выровнены:

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

Классы

Определение класса

Классы должны определяться по следующей схеме.

Фигурная скобка всегда пишется на следующей строке под именем класса.

Каждый класс должен иметь блок документации (doc-блок) в соответствии со стандартом PHPDocumentor.

Код внутри класса должен иметь отступ в четыре пробела.

Только один класс разрешен внутри одного PHP-файла.

Размещение дополнительно кода в файле с классом разрешено, но не приветствуется. В таких файлах, две пустые строки должны разделять класс и дополнительный PHP-код.

Это пример допустимого определения класса:

/**
* Doc-блок здесь
*/
class SampleClass
{
// содержимое класса должно быть
// с отступом в четыре пробела
}

Переменные-члены классов

Переменные-члены классов должны определяться по следующей схеме.

Любые переменные, определенные в классе, должны быть определены в начале класса, до определения любого метода.

Ключевое слово var не разрешено. Члены класса должны всегда определять их область видимости, используя ключевое слово private, protected или public. Доступ к переменным-членам класса напрямую используя префикс public разрешено, но не приветствуется в пользу методов доступа (set/get).

Функции и методы

Определение функций и методов

Функции должны определяться по следующей схеме.

Функции внутри классов должны всегда определять свою область видимости с помощью одного из префиксов private, protected или public.

Как и у классов, фигурная скобка всегда пишется на следующей строке под именем функции. Пробелы между именем функции и круглой скобкой для аргументов отсутствуют.

Функции в глобальной области видимости крайне не приветствуются.

Это пример допустимого определения функции:

/**
* Doc-блок здесь
*/
class Foo
{
/**
* Doc-блок здесь
*/
public function bar()
{
// содержимое класса должно быть
// с отступом в четыре пробела
}
}

ЗАМЕЧАНИЕ: Передача по ссылке допустима только в определениях функций:

/**
* Doc-блок здесь
*/
class Foo
{
/**
* Doc-блок здесь
*/
public function bar(&$baz)
{}
}

Передача по ссылке во время вызова запрещена.

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

/**
* Doc-блок здесь
*/
class Foo
{
/**
* ПЛОХО
*/
public function bar()
{
return($this->bar);
}

/**
* ХОРОШО
*/
public function bar()
{
return $this->bar;
}
}

Использование функций и методов

Аргументы функции разделяются одним завершающим пробелом после каждой запятой. Это пример допустимого вызова функции для функции, которая принимает три аргумента:

threeArguments(1, 2, 3);

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

Для функций, чьи аргументы допускают массив, вызов функции может включать конструкцию "array" и может быть разделено на несколько строк для улучшения читабельности. В этом случае, применим стандарт описания массивов:

threeArguments(array(1, 2, 3), 2, 3);

threeArguments(array(1, 2, 3, 'Zend', 'Studio',
$a, $b, $c,
56.44, $d, 500), 2, 3);

Управляющие структуры

If / Else / Elseif

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

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

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

if ($a != 2) {
$a = 2;
}

Для выражения "if", включая "elseif" или "else", форматирование должно быть таким, как в следующем примере:

if ($a != 2) {
$a = 2;
} else {
$a = 7;
}


if ($a != 2) {
$a = 2;
} elseif ($a == 3) {
$a = 4;
} else {
$a = 7;
}
PHP допускает написание таких выражений без фигурных скобок при некоторых условиях. Стандарт кодирования не делает различий - для всех "if", "elseif" или "else" выражений необходимо использовать фигурные скобки.

Использование "elseif" конструкции допускается, но крайне не приветствуется в пользу "else if" комбинации.

Switch

Управляющие структуры написанные с использованием "switch" конструкции должны иметь один пробел до открывающей круглой скобки условного выражения, и также один пробел после закрывающей круглой скобки.

Все содержимое между фигурными скобками пишется с отступом в четыре пробела. Содержимое каждого "case" выражения должно писаться с отступом в дополнительные четыре пробела.

switch ($numPeople) {
case 1:
break;

case 2:
break;

default:
break;
}

Ключевое слово default никогда не должно опускаться в выражении switch.

ЗАМЕЧАНИЕ: Иногда полезно писать case выражения, которые передают управление следующему case выражению, опуская break или return. Для того, чтобы отличать такие случаи от ошибок, каждое case выражение, где опущен break или return, должно содержать комментарий "// break intentionally omitted".

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

Формат документации

Все блоки документации ("doc-блоки") должны быть совместимы с форматом phpDocumentor. Описание формата phpDocumentor вне рамок данного докумета. Для дополнительно информации смотрите: » http://phpdoc.org/

Все файлы с исходными кодами, написанные для Zend Framework'а, или которые оперируют с фреймворком, должны содержать "файловые" doc-блоки в начале каждого файла и "классовый" doc-блок непосредственно перед каждым классом. Ниже даны примеры таких doc-блоков.

Файлы

Каждый файл, содержащий PHP-код должен иметь заголовочный блок в начале файла, содержащий как минимум следующие phpDocumentor-теги:

/**
* Краткое описание файла
*
* Длинное описание файла (если есть)...
*
* LICENSE: Some license information
*
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @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
*/

Классы

Каждый класс должен иметь doc-блок, содержащий как минимум следующие phpDocumentor-теги:

/**
* Краткое описание класса
*
* Длинное описание класса (если есть)...
*
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://www.zend.com/license/3_0.txt PHP License 3.0
* @version Release: @package_version@
* @link http://dev.zend.com/package/PackageName
* @since Class available since Release 1.2.0
* @deprecated Class deprecated in Release 2.0.0
*/

Функции

Каждая функция, включая методы объектов, должна иметь doc-блок, содержащий как минимум:

  • Описание функции

  • Все аргументы

  • Все возможные возвращаемые значения

Нет надобности использовать тег "@access", потому что область видимости уже известна из ключевых слов "public", "private" или "protected". используемых при определении функции.

Если функция/метод может выбрасывать исключение, используйте тег @throws:

@throws exceptionclass [описание]

Июня
2010 года
01
Zend / ORM Doctrine

Для тех, кто заинтересовался ORM Doctrine, можем порекомендовать две неплохие статьи на данную тему - "Интеграция Zend Framework и Doctrine" и "Пример использования ORM Doctrine". Обе статьи написаны понятным языком и не обделены внятными примерами.

По нашему скромному мнению Zend и Doctrine это связка способная возвысить php на невиданную доселе высоту. :)

Страница: 0