Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

67 lines (46 sloc) 2.677 kb


Note as FOSRestBundle is not yet declared stable, this document will be updated to list important BC breaks.

upgrading from 0.7.0 to master

  • renamed "query" fetcher to "param" fetcher, this affects the configuration as well as the name of interfaces and request attributes
  • ViewHandler now only calls "createView()" in a single form instance set as "form" in the data array
  • removed "serializer_version" config option on favor of "serializer: ['version': ..]"

upgrading from 0.6.0 to master

  • renamed [get|set]Objects() to [get|set]Serializer()
  • renamed the "objects_version: XXX" configuration option to "serializer: [version: XXX]"
  • moved serializer configuration code from ViewHandler::createResponse() to ViewHandler::getSerializer()
  • made ViewHandler::getSerializer() protected again

19 April 2012

  • Change route fallback action to PATCH instead of POST

    Automatically generated routes will now fall back to the PATCH instead of the POST method.

    More information in the docs, at this issue and this PR.

upgrading from 0.5.0_old_serializer

  • The ViewInterface is gone so you might have to change your controller config if you refer to the fos_rest.view service.

  • The View class is now split into a View (simple data container) and a ViewHandler (contains the actual rendering logic).

    The following code would need to be changed:

    public function indexAction($name = null)
        $view = $this->container->get('fos_rest.view');
        if (!$name) {
        } else {
            $view->setParameters(array('name' => $name));
            $view->setTemplate(new TemplateReference('LiipHelloBundle', 'Hello', 'index'));
        return $view->handle();

    To the following code:

    public function indexAction($name = null)
        if (!$name) {
            $view = \FOS\RestBundle\View\RouteRedirectView::create('_welcome');
        } else {
            $view = \FOS\RestBundle\View\View::create(array('name' => $name))
                ->setTemplate(new TemplateReference('LiipHelloBundle', 'Hello', 'index'));
        return $this->container->get('fos_rest.view_handler')->handle($view);
    • The custom Serializer class was removed instead JMSSerializerBundle is now used, which replaces the concept of normalizers/encoders with the concept of visitors and handler
Jump to Line
Something went wrong with that request. Please try again.