Skip to content

Commit 9618dcc

Browse files
authored
fix: broken data-persisters and data-providers links (#1772)
1 parent 1feaacd commit 9618dcc

File tree

4 files changed

+5
-5
lines changed

4 files changed

+5
-5
lines changed

core/events.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ These built-in event listeners are registered for routes managed by API Platform
2525
Name | Event | [Pre & Post hooks](#custom-event-listeners) | Priority | Description
2626
------------------------------|--------------------|---------------------------------------------|----------|-------------
2727
`AddFormatListener` | `kernel.request` | None | 28 | Guesses the best response format ([content negotiation](content-negotiation.md))
28-
`ReadListener` | `kernel.request` | `PRE_READ`, `POST_READ` | 4 | Retrieves data from the persistence system using the [state providers](data-providers.md) (`GET`, `PUT`, `PATCH`, `DELETE`)
28+
`ReadListener` | `kernel.request` | `PRE_READ`, `POST_READ` | 4 | Retrieves data from the persistence system using the [state providers](state-providers.md) (`GET`, `PUT`, `PATCH`, `DELETE`)
2929
`QueryParameterValidateListener` | `kernel.request` | None | 2 | Validates query parameters
3030
`DeserializeListener` | `kernel.request` | `PRE_DESERIALIZE`, `POST_DESERIALIZE` | 2 | Deserializes data into a PHP entity (`POST`); updates the entity retrieved using the state provider (`PUT`, `PATCH`)
3131
`DenyAccessListener` | `kernel.request` | None | 1 | Enforces [access control](security.md) using Security expressions

core/getting-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ web API.
141141

142142
If you are familiar with the Symfony ecosystem, you noticed that entity classes are also mapped with Doctrine ORM annotations
143143
and validation constraints from [the Symfony Validator Component](http://symfony.com/doc/current/book/validation.html).
144-
This isn't mandatory. You can use [your preferred persistence](data-providers.md) and [validation](validation.md) systems.
144+
This isn't mandatory. You can use [your preferred persistence](state-providers.md) and [validation](validation.md) systems.
145145
However, API Platform has built-in support for those libraries and is able to use them without requiring any specific
146146
code or configuration to automatically persist and validate your data. They are a good default option and we encourage you to use
147147
them unless you know what you are doing.

core/security.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ Available variables are:
111111
* `request` (only at the resource level): the current request
112112

113113
Access control checks in the `security` attribute are always executed before the [denormalization step](serialization.md).
114-
It means that for `PUT` or `PATCH` requests, `object` doesn't contain the value submitted by the user, but values currently stored in [the persistence layer](data-persisters.md).
114+
It means that for `PUT` or `PATCH` requests, `object` doesn't contain the value submitted by the user, but values currently stored in [the persistence layer](state-processors.md).
115115

116116
## Executing Access Control Rules After Denormalization
117117

distribution/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ Doctrine ORM and its bridge support most popular RDBMS including PostgreSQL, MyS
138138
There is also a shipped [Doctrine MongoDB ODM](https://www.doctrine-project.org/projects/mongodb-odm.html) optional support.
139139

140140
That being said, keep in mind that API Platform is 100% independent of the persistence system. You can use the one(s) that
141-
best suit(s) your needs (including NoSQL databases or remote web services) by implementing the [right interfaces](../core/data-providers.md). API Platform even supports using several persistence
141+
best suit(s) your needs (including NoSQL databases or remote web services) by implementing the [right interfaces](../core/state-providers.md). API Platform even supports using several persistence
142142
systems together in the same project.
143143

144144
### Using Symfony CLI
@@ -348,7 +348,7 @@ The only remaining task to have a working API is to be able to query and persist
348348

349349
To retrieve and save data, API Platform proposes two main options (and we can mix them):
350350

351-
1. Writing our own [data providers](../core/data-providers.md) and [data persisters](../core/data-persisters.md) to fetch and save data in any persistence system and trigger our custom business logic. This is what we recommend if you want to separate the public data model exposed by the API from the internal one, and to implement a layered architecture such as Clean Architecture or Hexagonal Architecture;
351+
1. Writing our own [state providers](../core/state-providers.md) and [state processors](../core/state-processors.md) to fetch and save data in any persistence system and trigger our custom business logic. This is what we recommend if you want to separate the public data model exposed by the API from the internal one, and to implement a layered architecture such as Clean Architecture or Hexagonal Architecture;
352352
2. Using one of the various existing data providers and persisters allowing to automatically fetch and persist data using popular persistence libraries. Out of the box, data providers and persisters are provided for [Doctrine ORM](https://www.doctrine-project.org/projects/orm.html) and [Doctrine MongoDB ODM](../core/mongodb.md).
353353
A data provider (but no persister yet) is also available for [Elasticsearch](../core/elasticsearch.md). [Pomm](https://github.com/pomm-project/pomm-api-platform) and [PHP Extended SQL](https://github.com/soyuka/esql#api-platform-bridge) also provides data providers and persisters for API Platform. We recommend this approach for Rapid Application Development.
354354

0 commit comments

Comments
 (0)