added phpdoc
implemented resource locator api tests