To może taki mały wstęp dotyczący tego, o czym wspomniał Piechnat.
- Nazywanie zmiennych, stałych oraz funkcji
Identyfikatory powinny składać się ze słów języka angielskiego i możliwie dokładnie opisywać swoje działanie/zawartość (abc, temp czy xxx nie mówią zbyt wiele). Nazwy jednoliterowe są zarezerwowane jako liczniki pętli.
Zmienne opisujemy małymi litereami, cyframi, oraz kreskami podkreślenia:
$post_id
Stałe opisujemy wielkimi literami, cyframi oraz kreskami podkreślenia:
$POSTS_PER_PAGE
Funkcje wielkimi i małymi literami, oraz cyframi:
HighlightDelphi()
- Puste linie
Puste linie powinny oddzielać od siebie fragmenty kodu tworzące logiczne bloki funkcyjne.
- Instrukcje złożone
Po i przed instrukcjami złożonymi zostawiamy puste linie. Nie dotyczy to instrukcji, które są jedyne w swoim bloku.
if:
if (warunek) instrukcja;
if (warunek)
instrukcja;
else
instrukcja;
if (warunek) {
instrukcje;
}
if (warunek) {
instrukcje;
} else {
instrukcje;
}
Dozwolona jest też forma
if (warunek)
instrukcja;
jeżeli występuje problem ze zmieszczeniem się w jednej linii.
Forma
if (warunek) {
instrukcje;
} else instrukcja;
jeste zabroniona. Pojedyńcza instrukcja przy else może wystąpić tylko wtedy, gdy przy 'then' jeste też pojedyńcza instrukcja.
for:
for (;;) instrukcja;
for (;;) {
instrukcje;
}
Z while analogicznie
switch () {
case: instrukcja;
break;
case:
case:
}
- Komentarze
Jak najwięcej. Na poczatku kodu info o tym, do czego służy plik oraz ChangeLog w standardowej postaci.
- Funkcje
Funkcje definiujemy tak:
function Nazwa(paramerty) {
}
Przy wywołaniu i definicji oddzielamy argumenty przecinkami oraz spacjami.
- Wyrażenia arytmetyczne
Spacje piszemy przed i po wszystkich operatorach wyłączając * oraz /.
- Zmienne globalne
NIE korzystamy z tablic $HTTP_POST_VARS ani z podobnych. Dostęp do zmiennych uzyskujemy TYLKO poprzez tablice $_GET, $_POST i podobnych. Przykład:
$id = $_GET["id"];
To tylko taki wstęp i mała propozycja...