Engleski definitivno. Cak je dobro to koristiti kao praksu za svaku aplikaciju koju pises jer ces se uvek lako snaci kad imas jedan isti pristup pisanju koda.
A sto se tice pisanja imena promenljivih, funkcija, class itd...
Dobro je da opet imas univerzalnost i u tome, ako neko nasledi tvoj kod moze lakse da se snadje kad primeti da je lepota koda i uredjenost prisutna.
npr:
promenljive pisem uvek u madjarskoj notaciji ( camel case ). Osim kad su promenljive clanovi klase. U tom slucaju dodajem prefiks pre promenljive i donju crtu pa onda ime.
Classu uvek pocinjem velikim slovom.
imena funkcija takodje pisem ( camel case ).
imena fajlova pisem sa donjom crticom.
takodje pisem jako mnogo komentara. Prilicno je vazno da se i ja sam setim sta odredjena funkcija treba da radi, u tom slucaju manji opis funkcije pomaze.
Takodje kad pisem komentare ne koristim tab vec samo space, to je dobro posto nije svakom podesen tabulator kao vama. A kod ce uvek isto da se cita kod svih ako koristite space.
Pre pocetka svakog fajla napravim pecat, makar fajl bio i mali.
U koliko ima neka izmena na fajlu, da je neko drugi radio na njemu, ili kad ja radim na necijem kodu obicno ako nesto dodajem ili menjam stavljim svoj pecat ispred toga.
Mali primer.
Code:
/*
* Name: class.display.inc
* Version: 1.0.0.
* Creator: Your Name
* Email:
[email protected]
* Date: 10/1/2007 mm/dd/yyyy
* ---------------------------------------------------------
* Smaller description of what this file is going to do, fro example.
* This file is used for displaying info to screen.
*/
class Display {
/*
* Used to catch outside data.
* @access private
* @var string
*/
var dis_displayStr;
/*
* Some detailed description what constructor takes and what it sets.
* @displayStr string
*/
function Display($displayStr)
{
$this->dis_displayStr = $displayStr;
}
/*
* Some explanation on what and how...
* @return string
*/
function printOutData()
{
return $this->dis_displayStr;
}
}
Now something that uses this particular class.
Code:
/*
* Name: screen_tester.php
* Version: 1.0.0.
* Creator: Your Name
* Email:
[email protected]
* Date: 10/1/2007 mm/dd/yyyy
* ---------------------------------------------------------
* Smaller description of what this file is going to do, fro example.
* This file is used for displaying info to screen.
*/
/*
* Including Display class. This class need....
*/
include_once "class.display.inc";
/*
* Some useful info.
* @display Display
*/
$display = new Display("Test");
/*
* printing out data....
*/
$display->printOutData();
Ovo je samo mali primer. Takodje lepo je pisati
Code:
$print = $if == $something?"true":"flase";
ali nije funkcionalno kad neko drugi cita vas kod.
Daleko je bolje napisati
Code:
if($if == $something)
{
$print = "true";
}
else if
{
$print = "false";
}
Ni meni ovo ne odgovara, ali sam shvatio da je tako mnogo bolje i preglednije cak i za mene samoga.
Eto to su neka moja misljenja kako pisati kod :)
Ocekujem brdo komentara pogotovo od onih koji nemisle kao ja.