symfony快速构建restfull api--api-platform初体验（快速上手笔记）

初识api-platform：

      都0202年了，整天还在用php一遍又一遍的写crud api吗？还在为构建restfull风格api而烦恼吗？那么，symfony的衍生框架api-platform你值得拥有。

      东西很强大，只是国内好像用的人不是很多，只有英文文档也难怪（不过现在机翻这么强大，这都不是问题）。作为过来人，把好东西分享给大家。同时，好记性不如烂键盘！

当然，api-platform不只是在symfony框架上加了一个api快速构建组件这么简单，这里有一张官网菜单的机翻截图：

api组件可以基于symfony框架快速构建restfull api、管理员组件可以通过对easyBundle配置快速构建后台管理、客户端生成器组件可以结合当前主流的3大前端框架生成客户端界面。

没错，它想让你优雅的成为一名优雅的全栈（然而大多数时候全栈和全干好像一个意思|||）。

附：

1. 官方文档 https://api-platform.com/

安装/环境构建：

你可以使用 composer require api 直接将api-platform作为依赖安装。

使用：

1、api组件的使用

--------- 初级用法 -------------------------------------------------- 

1、创建api

如果成功安装了api-platform,使用 bin/console make:entity 命令创建entity（输入entity name时或问你是否标记这个类为一个api platform资源，默认no，你可以输入yes）之后，访问项目的/api路由，你惊奇的发现entity的crud api和文档都已经生成好了（并且做了分页），并且页面还给每个接口都附带了一个测试工具。没错，就是这么快。

--------- 进阶用法 -------------------------------------------------- 

上面这些接口可能不太灵活，想要自定义，没问题：过滤器用起来

2、过滤器

你想要的 大|小|等于、排序、模糊查询、范围等等一切的查询，写写注释，改改配置，api就写完了美滋滋。

这时候用过symfony的人突然发现，我他喵的用symfony连doctrine都不用学了，哈哈哈！

1>、搜索过滤器(个人觉得这个比较常用，文档 https://api-platform.com/docs/core/filters/#search-filter)

比如在DocumentResource类里做了如下配置（注意注释第二行）：

 

use ApiPlatform\Core\Bridge\Doctrine\Orm\Filter\SearchFilter;

/**
 * @ApiResource()
 * @ApiFilter(SearchFilter::class, properties={"resourceGroup":"exact","fileName":"partial"})
 * @ORM\Entity(repositoryClass="App\Repository\DocumentResourceRepository")
 */
class DocumentResource
{
// ...
}

 * exact 精确查找   partial 模糊查找 *

于是这样的api就已经创建成功了：

结果：

3、序列化器

上面接口返回的json里某些属性值是类似 "/api/users/1" 这样，如果想只直接获取到对象的属性的值就需要用到序列化器了。

直接上图直观对比：

序列化器文档：https://api-platform.com/docs/core/serialization/

 

其他的后面用到再更啦。。。

-----最后更新于 2020-8-19