Location: PHPKode > projects > ISPConfig Hosting Control Panel > ispconfig3_install/CODING_NOTES.php.txt
Some guidelines for web development with php.
* Unix Line Breaks Only, NO windows breaks please.
* Tabs set at 4 spaces either as tabs or spaces.
* no accidental _<?php space before, within or after a file
* every php file starts and end with <?php ?> no spaces before or after
* error_reporting(E_ALL|E_STRICT) , yep php5
* Magic quotes is gone in php6, get used to it now. config = magic_quotes_gpc() Everything must be quoted

please mark any section that need review or work on with
// TODO 
* Add documentation about access levels (public, private, protected).
* Make function / var names on the following way, first word lower, next word(s) first letter upper like. getFirstResult();

Pear coding guidelines

// Commenting style
phpdoc is used for creating and autogenerating the documentation, this means that
some of the comments can be formatted to be included in documentation.
ie the source files are scanned then processed and html docs are created. 

The comments break down into the following types
// is uses for removing lines and debug dev etc
//** and //* are used as "sub comments"
    is used to comment out blocks
/** is used to create documentaion
* thats over 
* lines

If you need to block out a section then use
function redundant_code(){
    something here

To block out single lines use // and all // are assumed to be redundant test code and NOT comments

// print_r($foo);

For inline comment use //** and //* eg

//** Decide what do do
    //* blow it up
    case 'baloon':
        // test_pressure(); << inline comment

    //* Do default action
        //* following grant greaceful exit


Do not use the phpdoc on every function, eg 

* Login a user
* @param string user  username
* @param string password of user
function login($user, $pass){
as this function explains its self, the following clean code will suffice
function login($user, $pass){

If you do need to explain a function then put un the summary syntax eg

/** Pass an array of values where third param is bar
* $foo['bar'] = 1; // allow a user
* $foo['bar'] = 2; // destroy user
* $foo['bar'] = -1; // recreate
public function do_something($x, $y, $foo){
... do something interesting    

Return current item: ISPConfig Hosting Control Panel