Features 

Requirements 

• TYPO3 11.5 LTS
• PHP 7.4 or higher
• microsoft/microsoft-graph ^2 (installed automatically)
• zbateson/mail-mime-parser ^2 (installed automatically)

Composer 

Install the extension via Composer:

composer require oliverkroener/ok-typo3-helper

The required dependencies microsoft/microsoft-graph and zbateson/mail-mime-parser are installed automatically.

Local development 

To use a local checkout during development, add a path repository to your project's composer.json:

{
    "repositories": [
        { "type": "path", "path": "packages/ok_typo3_helper" }
    ]
}

Then require the package and activate the extension:

composer require oliverkroener/ok-typo3-helper
vendor/bin/typo3 extension:activate ok_typo3_helper

Service registration 

All classes under Classes/ are autowired and autoconfigured. The SiteRootService is additionally registered as a public singleton so it can be fetched directly from the container or via GeneralUtility::makeInstance():

services:
  _defaults:
    autowire: true
    autoconfigure: true
    public: false

  OliverKroener\Helpers\:
    resource: '../Classes/*'

  OliverKroener\Helpers\Service\SiteRootService:
    public: true
    autowire: true
    autoconfigure: true
    tags: ['singleton']

Microsoft Graph credentials 

MSGraphMailApiService only converts a message into the Graph Message format — it does not authenticate against Microsoft Graph itself. Authentication and the actual sending are the responsibility of the calling code, which must provide a configured Microsoft Graph client (for example an OAuth2 client-credentials flow with tenant ID, client ID and client secret).

Sending mail through Microsoft Graph 

Convert an outgoing Symfony SentMessage into a Microsoft Graph message and hand it to the Graph API:

use OliverKroener\Helpers\MSGraphApi\MSGraphMailApiService;

$result = MSGraphMailApiService::convertToGraphMessage($sentMessage);
$graphMessage = $result['message']; // \Microsoft\Graph\Generated\Models\Message
$fromAddress  = $result['from'];    // string, the sender address

The returned Message already contains recipients, subject, body and attachments (including inline images) and can be posted to the /users/{id}/sendMail endpoint with a configured Graph client.

Resolving the site root of a page 

SiteRootService is a public singleton and can be injected or fetched from the container:

use OliverKroener\Helpers\Service\SiteRootService;
use TYPO3\CMS\Core\Utility\GeneralUtility;

$rootPageId = GeneralUtility::makeInstance(SiteRootService::class)
    ->findNextSiteRoot($currentPageId); // int|null

Reflection-based accessors 

Add magic getters and setters to any class:

use OliverKroener\Helpers\Traits\ReflectionPropertiesTrait;

class Example
{
    use ReflectionPropertiesTrait;

    protected string $name = '';
}

$example = new Example();
$example->setName('TYPO3');   // writes the protected property
echo $example->getName();     // reads it back

Calling a getter or setter for a property that does not exist throws an \Exception.

Author — Oliver Kroener 

Support 

If you encounter issues or have questions about this extension:

• Bug reports & feature requests: Use the GitHub issue tracker
• Email: ok@oliver-kroener.de

Contributing 

Contributions are welcome. Please open a pull request or issue on GitHub.

License 

This extension is licensed under the GPL-2.0-or-later.