.. include:: /Includes.rst.txt
.. _ServicesYaml:
.. index::
   File; EXT:{extkey}/Configuration/Services.yaml
   Services.yaml
   Configuration; Services.yaml

=============
Services.yaml
=============

Services can be configured in this file. TYPO3 uses it for:

*  :ref:`Dependency Injection <configure-dependency-injection-in-extensions>`
*  :ref:`Event Listeners <EventDispatcherRegistration>`
*  Command Controllers (see :doc:`Feature: #89139 - Add dependency injection support for console commands <ext_core:Changelog/10.3/Feature-89139-AddDependencyInjectionSupportForConsoleCommands>`)
*  :ref:`Registering a widget with the dashboard <ext_dashboard:register-new-widget>`

A typical :file:`Configuration/Services.yaml` may look like this:

.. code-block:: yaml
   :caption: typo3/sysext/core/Configuration/Services.yaml

   services:
     # general settings
     _defaults:
       autowire: true
       autoconfigure: true
       public: false

     TYPO3\CMS\Core\:
       resource: '../Classes/*'

     # dependency injection (override public setting)
     TYPO3\CMS\Core\Mail\Mailer:
       public: true

     TYPO3\CMS\Core\Command\SendEmailCommand:
       tags:
         - name: 'console.command'
           command: 'mailer:spool:send'
         - name: 'console.command'
           command: 'swiftmailer:spool:send'
           alias: true
           schedulable: false

.. seealso::

   * TYPO3 uses the Symfony Dependency Injection component, so official documentation can be found at
     https://symfony.com/doc/current/service_container.html