Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/usemuffin/webservice
Bringing the power of the CakePHP ORM to your favourite webservices
https://github.com/usemuffin/webservice
cakephp cakephp-plugin php webservice
Last synced: about 1 month ago
JSON representation
Bringing the power of the CakePHP ORM to your favourite webservices
- Host: GitHub
- URL: https://github.com/usemuffin/webservice
- Owner: UseMuffin
- License: mit
- Created: 2015-04-29T19:17:28.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-05-13T06:02:50.000Z (7 months ago)
- Last Synced: 2024-10-20T10:10:25.773Z (about 2 months ago)
- Topics: cakephp, cakephp-plugin, php, webservice
- Language: PHP
- Homepage:
- Size: 528 KB
- Stars: 89
- Watchers: 11
- Forks: 43
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cakephp - Muffin/Webservices ORM plugin - An ORM like interface for webservices. (ORM / Database / Datamapping)
README
# Webservice
[](https://github.com/UseMuffin/Webservice/actions?query=workflow%3ACI+branch%3Amaster)
[](https://codecov.io/github/UseMuffin/Webservice)
[](https://packagist.org/packages/muffin/webservice)
[](LICENSE)
Bringing the power of the CakePHP ORM to your favourite webservices.
## Install
Using [Composer][composer]:
```
composer require muffin/webservice
```
You then need to load the plugin. You can use the shell command:
```
bin/cake plugin load Muffin/Webservice
```
## Usage
### Datasource Configuration
In your `app.php`, add a new `webservice` config under `Datasources`:
```php
'Datasources' => [
// Other db config here
'webservice' => [
'className' => \Muffin\Webservice\Datasource\Connection::class,
'service' => 'Articles',
// Any additional keys will be set as Driver's config.
],
],
```
If you are making a plugin then conventionally the datasource config key name
should be underscored version of plugin name.
### As an ORM
#### Create driver
```php
setClient(new Client([
'host' => 'example.com'
]));
}
}
```
#### Create a webservice
```php
getDriver()->getClient()->get('/articles.json');
if (!$response->isOk()) {
return false;
}
$resources = $this->_transformResults($query->endpoint(), $response->json['articles']);
return new ResultSet($resources, count($resources));
}
}
```
#### Create an endpoint (optional)
```php
loadModel('Articles', 'Endpoint');
$articles = $this->Articles->find();
}
}
```
### As base for a driver
You can also use this plugin as a base to a separate plugin or to manage custom webservice
drivers connections.
Until official documentation is written, [David Yell][1] wrote a good [post to get you started][2].
[1]:https://github.com/davidyell
[2]:https://github.com/davidyell/davidyell.github.com/blob/source/_posts/2015-09-11-connecting-to-a-web-service.markdown
## Implementations of webservices
### As an ORM
The following plugins use the Webservice ORM to give you easy access to all kinds of webservices:
- [GitHub plugin](https://github.com/cvo-technologies/cakephp-github) - Provides access to the GitHub REST APIs.
- [NS plugin](https://github.com/Qarox/cakephp-nsapi) - Provides access to the NS (Nederlandse Spoorwegen) APIs.
- [Stagemarkt plugin](https://github.com/ICT-College/cakephp-stagemarkt) - Provides access to the SBB Stagemarkt REST APIs.
- [Twitter plugin](https://github.com/cvo-technologies/cakephp-twitter) - Provides access to the Twitter REST and streaming APIs.
### As a driver
The following plugins implement a Webservice driver with their own methods:
- [GitHub plugin](https://github.com/UseMuffin/Github) - Provides access to the GitHub REST APIs.
- [Pusher plugin](https://github.com/UseMuffin/Pusher) - Provides access to the Pusher APIs.
- [TMDB plugin](https://github.com/drmonkeyninja/cakephp-tmdb) - Provides access to the TMDB APIs.
## Patches & Features
* Fork
* Mod, fix
* Test - this is important, so it's not unintentionally broken
* Commit - do not mess with license, todo, version, etc. (if you do change any, bump them into commits of
their own that I can ignore when I pull)
* Pull request - bonus point for topic branches
To ensure your PRs are considered for upstream, you MUST follow the CakePHP coding standards.
## Bugs & Feedback
http://github.com/usemuffin/webservice/issues
## License
Copyright (c) 2015-Present, [Use Muffin] and licensed under [The MIT License][mit].
[cakephp]:http://cakephp.org
[composer]:http://getcomposer.org
[mit]:http://www.opensource.org/licenses/mit-license.php
[muffin]:http://usemuffin.com