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

Вы слышали о блок-схемах или псевдо-коде? Это простые неязыковые специфиче-
ские методы проработки логики скриптов. Вашей ручкой вы записываете/рисуете логику
вашего кода на бумаге и "на пальцах" исполняете его, проверяя его теоретическую рабо-
тоспособность. Вот, на что вы должны потратить основное ваше время. Вы можете рас-
писать вашу логику от пошагового уровня переходов по if / else до уровня вызова кон-
кретных функций или классов. Не пожалейте на это вашего времени. Чем больше
проблем вы обнаружите на этой стадии, тем меньше ошибок и непредвиденных ситуаций
придется разрешать позже. Скомкать, выкинуть бумажку да перерисовать заново значи-
тельно проще, чем переписывать тысячу строк кода.

Разбивайте

Теперь, когда основная логика Вашего кода обозначена, начинайте искать элемен-
ты, которые выполняются многократно или просто по логике своей кажутся объединяе-
мыми. Возможно такие участки кода стоит выделять в небольшие самостоятельные
функции или классы. Разбивание вашего кода на многократно применимые части сохра-
няет время на печати кода и поиске ошибок. Печати, ибо не придется набивать одно и то
же многократно, поиске ошибок, ибо функция будучи безошибочной при первом вызове
останется таковой и при следущем (Разумеется, если она будет безошибочна на всем
диапазоне значений аргументов - примечание переводчика)

Комментируйте

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

Блочные комментарии

Блочные комментарии (Использующие комментарии в стиле языка C /* */) исполь-
зуются в основном с функциями, классами или более сложной логикой. Таким образом,
вы можете снабдить комментарий значительным количеством информации, или, если вы
будуте соблюдать формат комментариев PHPDoc, вы так же сможете сгенерировать
HTML документацию для ваших классов или функций. Вот пример:
<?php
/**
* Заводит временный файл или директорию
*
* При исполнении деструктора все
* заведенные временные файлы или директории уничтожаются
*
* @param string $file имя файла или директории
*
* @return void
*
* @access public
*/
?>

Строчные комментарии

Строчные комментарии ( // ) позволяют вам прояснять ход вашей логики более "то-
чечно". Эти комментарии "спасут вам жизнь", когда пол-года спустя, вы решите добавить
новую функциональность, или отследить баг, который упорно продолжает проявлять се-
бя. Я предпочитаю помечать такие вещи, как валидация, обработка ошибок, взаимодей-
ствия с СУБД, или эпизодические логические исключения.
<?php
class mySession
{
public function __construct()
{
// Ку-ку! Я конструктор, который слишком ленив, чтобы что-то делать!
}
}
?>