What it does 

Requirements 

• TYPO3: 10.4 LTS
• PHP: 7.2 or higher
• Dependencies: microsoft/microsoft-graph ^1 and zbateson/mail-mime-parser ^2

Composer 

composer require oliverkroener/ok-typo3-helper

Local path repository 

For local development, expose the extension through a path repository in your project's root composer.json:

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

Then require and activate it:

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

Dependencies 

Composer resolves the runtime dependencies automatically:

• microsoft/microsoft-graph ^1
• zbateson/mail-mime-parser ^2

Convert a message for Microsoft Graph 

Pass a Symfony SentMessage to MSGraphMailApiService::convertToGraphMessage(). It returns an array with the Graph message object and the resolved sender address:

use OliverKroener\Helpers\MSGraphApi\MSGraphMailApiService;
use Symfony\Component\Mailer\SentMessage;

/** @var SentMessage $sentMessage */
$result = MSGraphMailApiService::convertToGraphMessage($sentMessage);

$graphMessage = $result['message']; // Microsoft\Graph\Model\Message
$fromAddress  = $result['from'];    // string, the sender address

// $graphMessage can now be passed to the Microsoft Graph "sendMail" request.

Inline images referenced in the HTML body via cid: are detected automatically from their Content-Disposition: inline header and carried over with their Content-ID, so embedded graphics render in the delivered mail.

Dynamic property accessors 

Use ReflectionPropertiesTrait to add magic getters and setters to any class. The trait resolves the property through reflection:

use OliverKroener\Helpers\Traits\ReflectionPropertiesTrait;

class Contact
{
    use ReflectionPropertiesTrait;

    private string $email = '';
}

$contact = new Contact();
$contact->setEmail('ok@oliver-kroener.de'); // magic setter
echo $contact->getEmail();                   // magic getter

Calling an accessor for a property that does not exist throws an Exception.

Development tooling 

The extension ships with static analysis and coding-standards tooling, exposed as Composer scripts:

composer run stan       # PHPStan (level 5, TYPO3 stubs)
composer run cs:check   # PHP-CS-Fixer dry-run (TYPO3 coding standards)
composer run cs:fix     # PHP-CS-Fixer apply

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.