Slight update of API and PHPDoc

signed-off-by: Grégory PLANCHAT<g.planchat@gmail.com>