ZF-5206: Missing method getCurrentRouteName in API Doc

Description

Nowhere in the docs is described, how to get the current route name used forthe controller-action request. It is not in the "Reference Guide" nor in the API Doc, but in the API Doc should every method listet. Please add the method getCurrentRouteName() to Zend_Controller_Router_Route_Interface and to all classes which extends this class.

Comments

getCurrentRouteName() is a method of Zend_Controller_Router_Rewrite -- which is the appropriate class for it to be in. Zend_Controller_Router_Route_Interface defines routes that are attached to the rewrite router, and getCurrentRouteName() is used to retrieve the name of the current route that the rewrite router matched.

The method is not part of the router interface as we do not envision that every router would necessarily allow attaching multiple route objects.

Hmm... The Framework uses internally Zend_Controller_Router_Rewrite ? Shouldn't this method not be mentioned then somewhere in the Reference Guide? I have searched such a function for about an hour to find out that the instance of Zend_Controller_Front => getRouter() has this information and I think a lot of other developer would also need this quite often.

Re-opening; should document the getCurrentRoute() and getCurrentRouteName() methods.

Updated in trunk with r13154; will release with 1.7.2.

Thank you for updating the docs.