Download the PHP package kauffinger/onoffice-laravel-adapter without Composer
On this page you can find all versions of the php package kauffinger/onoffice-laravel-adapter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download kauffinger/onoffice-laravel-adapter
More information about kauffinger/onoffice-laravel-adapter
Files in kauffinger/onoffice-laravel-adapter
Package onoffice-laravel-adapter
Short Description A joyful way to interact with the onOffice API using Laravel and Saloon.
License MIT
Homepage https://github.com/kauffinger/onoffice-laravel-adapter
Informations about the package onoffice-laravel-adapter
A joyful way to interact with the onOffice API using Laravel and Saloon.
This is a package meant to make interacting with the onOffice API enjoyable and easy. We try our best to make all rules from the API as explicit as possible in code. This means you shouldn't be able to create invalid requests. It is based on the official php sdk and saloon.
Installation
You can install the package via composer:
You can publish the config file with:
This is the contents of the published config file:
Usage
Or, if you like your code even cleaner, how about this:
You can easily send multiple actions in one request:
With the custom response class, you can easily manage the response. For example, when onOffice returns the HTTP status code 200, but the response contains status.code == 500, the response will not be marked as OK:
Furthermore, it provides easy access to both the results of an onOffice response:
If you don't need the full results array, because you maybe only sent a single action, you can access action data directly:
You can determine if a response is cacheable by calling the cacheable
method.
It checks the response for each action in the request and checks cacheability:
Since the goal of this SDK is to streamline onOffice API usage as much as possible, a lot of endpoints are still missing. You can then still use the library to send custom actions:
Known Issues
- Currently, no identifier seems to be returned from the onOffice API.
Future Features
- Access all onOffice API endpoints in a way that is as typesafe as possible (in progress)
- Integrate optional saloon based caching of requests (todo)
- Add saloon resource classes for the most used basic actions (todo)
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Konstantin Auffinger
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of onoffice-laravel-adapter with dependencies
illuminate/contracts Version ^10.0||^11.0
saloonphp/saloon Version ^3.5
saloonphp/laravel-plugin Version ^3.0
spatie/laravel-package-tools Version ^1.16