glede php ... odvisno, enovrstičnice delam, ko je kaka stvar, ki je več nebom spreminjal in je dokaj preprosta in se mi zdi brezveze tratiti za njo 10 vrstic, ker vem da je več nebom pogledal, pa še običajno gre kot sem že rekel za preproste zadeve ...
To je pa ena najvecjih cvetk, ki sem jo slisal od programerja in je skregana z vsemi pravili lepega programiranja, ki jo ucijo vsepovsod. Meni so tipili v glavo, da je bolje kaksna vrstica komentarja vec kot manj in se tega tudi drzim. Cetudi pisem samo code snippet ali testno kodo, vedno pisem tako, da bom za pet mesecev ko bom to cisto slucajno pogledal, tocno vedel za kaj se gre. Pa cetudi jo nikoli vec ne bom spreminjal.
Se pravi da vsaka zadeva, ki jo napisem zgleda priblizno takole ...
/**
* Authenticate user
*
* @param string $username
* @param string $password
* @return Zend_Auth_Result
*/
public function authenticate($username, $password)
{
// Username cannot be empty (db auth adapter throws exception)
if (!$username) {
$username = md5('Donec dictum, massa quis ultrices.');
} else if ($password === null) {
$password = '';
}
// Get Auth object
$auth = Zend_Auth::getInstance();
/** ... */
}
Ce imas namene ostati v tem biznisu, ti priporocam da pises kodo cimbolj pregledno in strukturirano, ter obvezno uporabljaj DocBlock, saj bo slej ko prej kaksen tvoj izdelek prisel v roke kakega znalca, ki bo enostavno zavrnil projekt, ker ga zaradi nepreglednosti kode, ne bo mogoce vzdrzevati.
Prijateljski nasvet, brez zamere :)