4. Fejezet. Kódolási szabályok

Tartalom
Bekezdés és sorhossz
Vezérlőszerkezetek
Függvényhívások
Függvénydefiníciók
Megjegyzések (kommentek)
Kód include-olása
PHP tag-ek
Fejléc komment blokkok
A CVS használata
Példa URL-ek
Elnevezési szabályok
Fájlformátumok
Sample File (including Docblock Comment standards)

Megjegyzés: A PEAR Kódolási Szabványok arra a kódra érvényesek, melyek részei a hivatalos PEAR disztribúciónak (vagyis, a PHP-vel kerültek terjesztésre, vagy a PHP PEAR raktárból kerültek letöltésre).

Bekezdés és sorhossz

Négy szóközből álló bekezdéseket használjunk, tab-ok nélkül. Ha Emacs-et használunk a kód szerkesztésére, akkor az indent-tabs-mode -ot állítsuk nil-re. Példa az Emacs konfigurálására a fentieknek megfelelően (győződjünk meg róla, hogy ez van érvényben PHP fájlok szerkesztésekor):
(defun php-mode-hook ()
  (setq tab-width 4
        c-basic-offset 4
        c-hanging-comment-ender-p nil
  	indent-tabs-mode
	(not
	 (and (string-match "/\\(PEAR\\|pear\\)/" (buffer-file-name))
	      (string-match "\.php$" (buffer-file-name))))))

A vim megfelelő beállításai:
set expandtab
  set shiftwidth=4
  set softtabstop=4
  set tabstop=4

Ajánlott a sorokat kb. 75-85 karakter szélességben megtörni. Nincs szabály a sorok megfelelő törésére, használjuk saját ítélőképességünket. Ha kérdéseink vannak, érdeklődjünk a PEAR QA levelezőlistán.