Друзья, скидываю вам такой вот PHP-класс для простой работы с картинками - изменению их размера, подгонки по ширине, пропорциональному уменьшению и ещё пара полезностей:
/**
* Функция получает путь к файлу для печати на стрице-
* вызывается без параметров
*
* @param string $str - строка, необходима для того-то...
* @return string
*/
public function getWebPath($str) {
То есть:
начинаем комментарий с /**
каждая строка начинается со звёздочки *
@param - начало строки для описания типа и назначения переменной (входящей)