how shall I document the use of GET or POST in a controller method?

Question

I am searching for a best-practice-way to document my controller methods in php. I was wondering how I should document my POST and GET requirements (I used REQUEST here to show I need it for both ways).

i.e. see this method:

public function login(){

    $username = $_REQUEST['username'];
    $password = $_REQUEST['password'];
    $stay_loggedin = $_REQUEST['stay-loggedin'];

    $user = new usermodel();
    if ($user->login($username, $password, $stay_loggedin) ) return <something>;
    else return page_not_allowed;
}

It would be great if someone can tell me a way which is php-doc compatible... I mean @param wouldn't be the right way, woudldn't it?

Shall I document the required usermodel class as well? And how?

thanks for your help

Did you see this: http://stackoverflow.com/questions/2121710/is-there-a-standard-for-documenting-get-post-parameters — Sudhir Bastakoti, Feb 22 '12 at 10:33
no haven't seen that, but I surfed through all proposals ... — helle, Feb 22 '12 at 10:34
Well then pls do check that and this one too: http://stackoverflow.com/questions/1269086/request-params-and-phpdoc — Sudhir Bastakoti, Feb 22 '12 at 10:35
I don't get it, what is ment in in the first link you've posted — helle, Feb 22 '12 at 10:40

score 1 · Accepted Answer · edited Nov 25 '13 at 09:38

1

For documenting GET/POST methods you can do like:


/**
 * Function to Login a user
 *
 * Requires $_POST['username'] and $_POST['password']
 * Optional $_REQUEST['stay-loggedin'] 
 * 
 * @return void
 */
public function login(){

    $username = $_REQUEST['username'];
    $password = $_REQUEST['password'];
    $stay_loggedin = $_REQUEST['stay-loggedin'];

    $user = new usermodel();
    if ($user->login($username, $password, $stay_loggedin) ) return ;
    else return page_not_allowed;
}

And you could document the usermodel class in usermodel class file itself. Hope it helps

edited Nov 25 '13 at 09:38

BenMorel

34,448
50
182
322

answered Feb 22 '12 at 10:48

Sudhir Bastakoti

99,167
15
158
162

is there a plugin, which creates something like this in netbeans automaticly? – helle Feb 22 '12 at 11:04

how shall I document the use of GET or POST in a controller method?

1 Answers1