docs(phpdoc): compléments PHPDoc pour objet_modifier() et objet_inserer()

Surtout pour préciser les retours possibles en cas de succès ou d'échec.
Ajout aussi de quelques commentaires généraux et de @uses.

Fix #5642