Annotations in Extbase
All available annotations for Extbase delivered by TYPO3 Core are placed within
the namespace
\TYPO3\.
Example in EXT:blog_example
for the annotation
Lazy:
<?php
declare(strict_types=1);
namespace T3docs\BlogExample\Domain\Model;
use TYPO3\CMS\Extbase\Annotation\ORM\Lazy;
use TYPO3\CMS\Extbase\DomainObject\AbstractEntity;
use TYPO3\CMS\Extbase\Persistence\ObjectStorage;
class Post extends AbstractEntity
{
/**
* @var ObjectStorage<Post>
*/
#[Lazy()]
public ObjectStorage $relatedPosts;
}
Annotations provided by Extbase
The following annotations are provided Extbase:
Validate
\TYPO3\: Allows to configure validators
for properties and method arguments. See Using validation for Extbase models and controllers for details.
Can be used in the context of a model property.
Example:
<?php
declare(strict_types=1);
namespace T3docs\BlogExample\Domain\Model;
use TYPO3\CMS\Extbase\Annotation\Validate;
use TYPO3\CMS\Extbase\DomainObject\AbstractEntity;
class Blog extends AbstractEntity
{
#[Validate([
'validator' => 'StringLength',
'options' => ['maximum' => 150],
])]
public string $description = '';
/**
* Use annotations instead for compatibility with TYPO3 v11:
*
* @Validate("StringLength", options={"maximum": 150})
*/
public string $description2 = '';
}
Validate annotations for a controller action are executed additionally
to possible domain model validators.
IgnoreValidation
\TYPO3\: Allows to ignore
all Extbase default validations for a given argument (for example a domain
model object).
Used in context of a controller action.
Example:
<?php
declare(strict_types=1);
namespace T3docs\BlogExample\Controller;
use Psr\Http\Message\ResponseInterface;
use T3docs\BlogExample\Domain\Model\Blog;
use TYPO3\CMS\Extbase\Annotation\IgnoreValidation;
use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;
final class BlogController extends ActionController
{
#[IgnoreValidation(['argumentName' => 'newBlog'])]
public function newAction(?Blog $newBlog = null): ResponseInterface
{
// Do something
return $this->htmlResponse();
}
/**
* Use annotations instead for compatibility with TYPO3 v11:
* @IgnoreValidation("newBlog")
*/
public function newAction2(?Blog $newBlog = null): ResponseInterface
{
// Do something
return $this->htmlResponse();
}
}
You can not exclude specific properties of a object specified in an argument.
If you need to exclude certain validators of a domain model, you could adapt the concept of a "Data Transfer Object" (DTO). You would create a distinct model variant of the main domain model, and exclude all the properties that you do not want validation for in your Extbase context, and transport the contents from and between your original domain model to this instance. Read more about this on https://usetypo3.com/dtos-in-extbase/ or see a CRUD example for this on https://github.com/garvinhicking/gh_validationdummy/
ORM (object relational model) annotations
The following annotations can only be used on model properties:
Cascade
\TYPO3\: Allows to remove
child entities during deletion of aggregate root.
Extbase only supports the option "remove".
Example:
<?php
declare(strict_types=1);
namespace T3docs\BlogExample\Domain\Model;
use TYPO3\CMS\Extbase\Annotation\ORM\Cascade;
use TYPO3\CMS\Extbase\DomainObject\AbstractEntity;
use TYPO3\CMS\Extbase\Persistence\ObjectStorage;
final class Blog extends AbstractEntity
{
/**
* @var ObjectStorage<Post>
*/
#[Cascade(['value' => 'remove'])]
public $posts;
/**
* Use annotations instead for compatibility with TYPO3 v11:
*
* @var ObjectStorage<Post>
* @Cascade("remove")
*/
public $posts2;
}
Transient
\TYPO3\: Marks property as transient
(not persisted).
Example:
<?php
declare(strict_types=1);
namespace T3docs\BlogExample\Domain\Model;
use TYPO3\CMS\Extbase\Annotation\ORM\Transient;
use TYPO3\CMS\Extbase\DomainObject\AbstractEntity;
final class Person extends AbstractEntity
{
#[Transient()]
protected string $fullname = '';
/**
* Use annotations instead for compatibility with TYPO3 v11:
* @Transient
*/
protected string $fullname2 = '';
}
Lazy
\TYPO3\: Marks model property to be loaded
lazily on first access.
Note
Lazy loading can greatly improve the performance of your actions.
Example:
<?php
declare(strict_types=1);
namespace T3docs\BlogExample\Domain\Model;
use TYPO3\CMS\Extbase\Annotation\ORM\Lazy;
use TYPO3\CMS\Extbase\DomainObject\AbstractEntity;
use TYPO3\CMS\Extbase\Persistence\ObjectStorage;
class Post extends AbstractEntity
{
/**
* @var ObjectStorage<Post>
*/
#[Lazy()]
public ObjectStorage $relatedPosts;
}
Combining annotations
Annotations can be combined. For example, "lazy loading" and "removal on cascade" are frequently combined:
<?php
declare(strict_types=1);
namespace T3docs\BlogExample\Domain\Model;
use TYPO3\CMS\Extbase\Annotation\ORM\Cascade;
use TYPO3\CMS\Extbase\Annotation\ORM\Lazy;
use TYPO3\CMS\Extbase\DomainObject\AbstractEntity;
use TYPO3\CMS\Extbase\Persistence\ObjectStorage;
class Post extends AbstractEntity
{
#[Lazy()]
#[Cascade(['value' => 'remove'])]
/**
* @var ObjectStorage<Comment>
*/
public ObjectStorage $comments;
}
Several validations can also be combined. See Using validation for Extbase models and controllers for details.