Fejlesztőknek > Alapelvek
Kérlek vedd figyelembe, hogy az egyik legfontosabb alapelvünk a kód újrafelhasználhatósága. Ennek szellemében fejlesztünk.
Mivel a dokumentáláshoz gyakran PHPdocumentort használunk, nem szükséges részletes, struktúrált dokumentációt írni a kódhoz, de fontos, hogy a programsorok között legyen elég információ a documentornak, hogy le tudjon generálni egy megfelelő doksit (http://www.phpdoc.org). Ha nem ismered a documentort, nézd egy kicsit át a doksiját, hogy milyen commenteket szeret.
Fejlesztésnél nem feltétlenül kell objektumokat gyártani, de a többször használatos függvényeket érdemes kigyűjteni külső fileokba. Sokszor előfordul, hogy egy meglévő rendszert kell továbbfejleszteni, ilyenkor meg kell kisérelni az addig használt programozási stílust követni, de új modulok, vagy jelentős átalakítás esetén, amikor már érdemes modernebbre átírni a meglévő rendszert, akkor érdemes váltani.
Nagyon fontos szabály az, hogy ha bármi nem egyértelmű, vagy feleslegesnek tűnik, vagy túl bonyolultnak, KÉRDEZZ! Sokkal jobb ha naponta 100 levél mozog egy témában, mintha időt vesztünk információ hiány miatt!
Ha egy meglévő rendszert, kódot kell továbbfejleszteni, igyekezni kell ugyanabban a stílusban folytatni, mint ahogy az eredeti kód volt írva. Ilyenkor nem feltétlenül kell követni az itt leírt szabályokat, mivel a régi kódok írásakor még más szabályok voltak érvényben.
A legegyszerűbb eseteket kivéve nem szabad PHP kódot és HTML kódot egy fileba helyezni.
Van néhány kiválasztott modul, melyek használata erősen javasolt, tekintve hogy ezek fejlesztése nem a mi erőforrásunkat vonja el, és elég sokan használják őket. Az ilyen modulok nagyrészt a PEAR -hez kapcsolódnak (http://pear.php.net). Ezek a modulok a következőek.
- Gyakran használt modulok:
ADODB - adatbázis réteg (http://phplens.com/lens/adodb/docs-adodb.htm, vagy
http://www.adodb.com)
Smarty - univerzális template rendszer (http://smarty.php.net)
http://pear.php.net/package/Log - logolás modul
PHPMailer - email küldő alrendszer, csatolt file, html levél támogatással (http://phpmailer.sourceforge.net/)
ConvertCharset - karakterkonverzió, az ékezetes flash - php adatcserékhez (http://mikolajj.republika.pl/)
- Ritkábban használt modulok:
http://pear.php.net/package/Mail_Mime - HTML email kezelő objektumok
http://pear.php.net/package/Mail - levél küldő modul
http://pear.php.net/package/Config - összetettebb config fileok kezelése
http://pear.php.net/package/LiveUser - autentikáció, és felhasználói jogosultság követés
http://pear.php.net/package/File - file műveletek egységesítése
http://pear.php.net/package/File_Passwd - jelszófileok kezelése
http://pear.php.net/package/HTML_Template_Sigma - egy egyszerű
template rendszer
http://pear.php.net/package/HTML_QuickForm_Controller - űrlap
ellenőrző modul
http://pear.php.net/package/HTML_QuickForm - űrlap generáló modul
http://pear.php.net/package/HTML_Menu - menü generáló modul
http://pear.php.net/package/HTTP - header kezelő könyvtárak
http://pear.php.net/package/Mail_Queue - hírlevelek, és tömeges levélküldések megoldását segítő objektumok
http://pear.php.net/package/Image_Text - kép - szövegfelirat kezelő modul
http://pear.php.net/package/I18N - nemzetközi dátum, szám, pénz, ... kezelő modul
http://pear.php.net/package/Translation2 - többnyelvűséget támogató modul
http://pear.php.net/package/SOAP - SOAP PHP megoldás
http://pear.php.net/package/XML_RPC- XML RPC modul
A szabályok és a környezet megismerése után, bemutatjuk a NeGRAL fejlesztési keretrendszerét, az NFW -t!
