This manual is no longer being maintained for TYPO3 versions 11.5 and above. The majority of the content has been migrated to the Extbase or Fluid sections in "TYPO3 Explained".

Setting up the Persistence Layer

As discussed in previous chapters, it is the persistence layer which takes care of conserving domain objects. In this chapter we will describe the necessary steps for doing that.

It is important to understand the lifecycle of a domain object to fully understand the persistence layer. When we instantiate a domain object, we essentially store it in memory. It is then in a transient (or volatile) state. When TYPO3 delivers the rendered website, PHP frees up this allocated memory. This means that the saved data will be lost and thus also the domain object.

Domain Objects need to be transferred into a persistent state if the need to be available across several page loads. This is done in Extbase by putting the Domain objects into a Repository. When the script finished its work, the Repository takes care about saving the volatile data in a persistent state. Normally, this is the database which is used by TYPO3 but may, for example, also be a text file.

This chapter deals with the necessary steps to persist the data of a Domain Object. First, the Domain Objects have to be prepared to make them persistable in the underlying database. Most extensions get their input data from the Backend, thus the input forms which receive the data have to be configured. Subsequently, the Repositories which serve as an interface to the Domain Object are created.

Those steps are sufficient for most of the simple extensions, however, bigger projects often need more complex queries to the persistence layer as you will see with the example extension SjrOffers. This exemplary extension deals with leisure and educational offers for parents or teenagers. An example request would be something like "Please show me all existing offers for a 5-years child close to the town centre". It should be possible to make such a request through the website, which should contain an input form. This form then sends the request to the extension. There, the Repository will retreive the appropriate offers and send them back to the website. Thus, we will implement the method findDemanded($demand) in a final step to find those offers.

Let's start with the database.