https://github.com/natpnk/microsoft-graph-laravel

Microsoft Graph wrapper and mail transporter for Laravel
https://github.com/natpnk/microsoft-graph-laravel

api composer laravel mail-transport microsoft office365 php wrapper

Last synced: about 1 month ago
JSON representation

Microsoft Graph wrapper and mail transporter for Laravel

• Host: GitHub
• URL: https://github.com/natpnk/microsoft-graph-laravel
• Owner: Natpnk
• License: mit
• Created: 2021-04-27T22:45:10.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-05-21T22:57:47.000Z (over 2 years ago)
• Last Synced: 2024-11-18T15:49:10.226Z (about 1 month ago)
• Topics: api, composer, laravel, mail-transport, microsoft, office365, php, wrapper
• Language: PHP
• Homepage:
• Size: 21.5 KB
• Stars: 3
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Microsoft Graph for Laravel

This laravel package contains a wrapper for Microsoft Graph with the following features:

 - Microsoft Graph API calls

 - Mail transport

## Requirements

 - Laravel 8^

 - PHP 7.2.5^

## Installation

To install and use this package follow instructions below:

#### Step 1: Install via composer

    $ composer require natpnk/microsoft-graph-laravel

#### Step 2: Publish config

Run the following to publish the config

    $ php artisan vendor:publish --provider="Natpnk\MicrosoftGraphLaravel\MicrosoftGraphServiceProvider" --tag="config"

The config file will be published as follow:

	 env('MSGRAPH_TENANT'),

	    'clientid' => env('MSGRAPH_CLIENT_ID'),

	    'clientsecret' => env('MSGRAPH_CLIENT_SECRET')    

	];

#### Step 3: Create app registration

To obtain the Tenant, ClientID and ClientSecret. Please follow this [article](https://docs.microsoft.com/azure/active-directory/develop/quickstart-register-app) to generate a app registration within Azure.

#### Step 4: Use Microsoft Graph as mail transport

It is possible to use Microsoft Graph as an mail transport within Laravel. Add the following to config/mail.php inside your Laravel installation.

    'microsoftgraph' => [

		'transport' => 'microsoftgraph',

	],

Additional settings are not required due to settings inside config/microsoftgraph.php. Remember to use a from address which is a valid mailbox inside your tenant.

##  Usage

A basic example usage example get's all the users from a tentant:

	use MicrosoftGraph;

	....

        $Users = MicrosoftGraph::createRequest("GET", "/Users")->setReturnType(\Microsoft\Graph\Model\User::class)->execute();

	print_r($Users);

for futher documentation about usage consult: [Microsoft Graph API docs](https://docs.microsoft.com/en-us/graph/overview)

## Inspiration

The inspiration for this package came from [wapacro/laravel-msgraph-mail](https://github.com/wapacro/laravel-msgraph-mail) and the need for a wrapper for Microsoft Graph to use in Laravel.  

## Contributing

Feel free contribute and send pull requests.