Allow "friendsofsymfony/rest-bundle:^3.0"

[wbloszyk]

Subject

Allow "friendsofsymfony/rest-bundle:^3.0".

I am targeting this branch, because these changes respect BC.

Changelog

### Added
- support for "friendsofsymfony/rest-bundle:^3.0"
### Changed
- support for deprecated "rest" routing type in favor for xml

[codecov-commenter]

Codecov Report

Merging #688 into 3.x will not change coverage.
The diff coverage is 54.54%.

@@            Coverage Diff            @@
##                3.x     #688   +/-   ##
=========================================
  Coverage     45.33%   45.33%           
  Complexity     2500     2500           
=========================================
  Files           191      191           
  Lines          8127     8127           
=========================================
  Hits           3684     3684           
  Misses         4443     4443           

Impacted Files	Coverage Δ	Complexity Δ
...InvoiceBundle/Controller/Api/InvoiceController.php	84.00% <ø> (ø)	10.00 <0.00> (ø)
src/OrderBundle/Controller/Api/OrderController.php	84.00% <ø> (ø)	10.00 <0.00> (ø)
...ustomerBundle/Controller/Api/AddressController.php	86.27% <50.00%> (ø)	18.00 <0.00> (ø)
...stomerBundle/Controller/Api/CustomerController.php	88.40% <50.00%> (ø)	24.00 <0.00> (ø)
...ProductBundle/Controller/Api/ProductController.php	88.00% <50.00%> (ø)	26.00 <0.00> (ø)
...c/BasketBundle/Controller/Api/BasketController.php	83.06% <60.00%> (ø)	39.00 <0.00> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d9a52f6...d8ed128. Read the comment docs.

[wbloszyk]

@sonata-project/contributors Can you check it?

[phansys]

It'd be nice to have some tests covering these routes.

[wbloszyk]

I will add it at the end, after add support for nelmio/api-doc-bundle v3

[wbloszyk]

@OskarStark Can you look at DOCtor-RTS? You make somethig simmilar (to this), where nelmio/api-doc work with .yml.