mirror of
https://github.com/ovh/php-ovh.git
synced 2023-11-05 03:20:26 +01:00
Update the phpdoc to make it valid
Types were missing everywhere in the phpdoc. Signed-off-by: Christophe Coevoet <stof@notk.org>
This commit is contained in:
parent
ec7afae21c
commit
6df59f8382
54
src/Api.php
54
src/Api.php
@ -34,7 +34,7 @@ use GuzzleHttp\Client as GClient;
|
|||||||
use GuzzleHttp\Stream\Stream;
|
use GuzzleHttp\Stream\Stream;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Wrapper to manage login and exchanges with simpliest Ovh API
|
* Wrapper to manage login and exchanges with simplest Ovh API
|
||||||
*
|
*
|
||||||
* This class manage how works connections to the simple Ovh API with
|
* This class manage how works connections to the simple Ovh API with
|
||||||
* login method and call wrapper
|
* login method and call wrapper
|
||||||
@ -93,15 +93,15 @@ class Api
|
|||||||
/**
|
/**
|
||||||
* Construct a new wrapper instance
|
* Construct a new wrapper instance
|
||||||
*
|
*
|
||||||
* @param $application_key key of your application.
|
* @param string $application_key key of your application.
|
||||||
* For OVH APIs, you can create a application's credentials on https://api.ovh.com/createApp/
|
* For OVH APIs, you can create a application's credentials on https://api.ovh.com/createApp/
|
||||||
* @param $application_secret secret of your application.
|
* @param string $application_secret secret of your application.
|
||||||
* @param $api_endpoint name of api selected
|
* @param string $api_endpoint name of api selected
|
||||||
* @param $consumer_key If you have already a consumer key, this parameter prevent to do a
|
* @param string|null $consumer_key If you have already a consumer key, this parameter prevent to do a
|
||||||
* new authentication
|
* new authentication
|
||||||
* @param $http_client instance of http client
|
* @param GClient|null $http_client instance of http client
|
||||||
*
|
*
|
||||||
* @throws InvalidParameterException if one parameter is missing or with bad value
|
* @throws Exceptions\InvalidParameterException if one parameter is missing or with bad value
|
||||||
*/
|
*/
|
||||||
public function __construct(
|
public function __construct(
|
||||||
$application_key,
|
$application_key,
|
||||||
@ -157,8 +157,10 @@ class Api
|
|||||||
* Request a consumer key from the API and the validation link to
|
* Request a consumer key from the API and the validation link to
|
||||||
* authorize user to validate this consumer key
|
* authorize user to validate this consumer key
|
||||||
*
|
*
|
||||||
* @param $accessRules list of rules your application need.
|
* @param array $accessRules list of rules your application need.
|
||||||
* @param $redirection url to redirect on your website after authentication
|
* @param string|null $redirection url to redirect on your website after authentication
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
*
|
*
|
||||||
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
||||||
*/
|
*/
|
||||||
@ -186,10 +188,12 @@ class Api
|
|||||||
* This is the main method of this wrapper. It will
|
* This is the main method of this wrapper. It will
|
||||||
* sign a given query and return its result.
|
* sign a given query and return its result.
|
||||||
*
|
*
|
||||||
* @param $method HTTP method of request (GET,POST,PUT,DELETE)
|
* @param string $method HTTP method of request (GET,POST,PUT,DELETE)
|
||||||
* @param $path relative url of API request
|
* @param string $path relative url of API request
|
||||||
* @param $content body of the request
|
* @param array|\stdClass|null $content body of the request
|
||||||
* @param $is_authenticated if the request use authentication
|
* @param bool $is_authenticated if the request use authentication
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
*
|
*
|
||||||
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
||||||
*/
|
*/
|
||||||
@ -244,8 +248,10 @@ class Api
|
|||||||
/**
|
/**
|
||||||
* Wrap call to Ovh APIs for GET requests
|
* Wrap call to Ovh APIs for GET requests
|
||||||
*
|
*
|
||||||
* @param $path path ask inside api
|
* @param string $path path ask inside api
|
||||||
* @param $content content to send inside body of request
|
* @param array\\stdClass|null $content content to send inside body of request
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
*
|
*
|
||||||
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
||||||
*/
|
*/
|
||||||
@ -259,8 +265,10 @@ class Api
|
|||||||
/**
|
/**
|
||||||
* Wrap call to Ovh APIs for POST requests
|
* Wrap call to Ovh APIs for POST requests
|
||||||
*
|
*
|
||||||
* @param $path path ask inside api
|
* @param string $path path ask inside api
|
||||||
* @param $content content to send inside body of request
|
* @param array\\stdClass|null $content content to send inside body of request
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
*
|
*
|
||||||
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
||||||
*/
|
*/
|
||||||
@ -274,8 +282,10 @@ class Api
|
|||||||
/**
|
/**
|
||||||
* Wrap call to Ovh APIs for PUT requests
|
* Wrap call to Ovh APIs for PUT requests
|
||||||
*
|
*
|
||||||
* @param $path path ask inside api
|
* @param string $path path ask inside api
|
||||||
* @param $content content to send inside body of request
|
* @param array\\stdClass|null $content content to send inside body of request
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
*
|
*
|
||||||
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
||||||
*/
|
*/
|
||||||
@ -289,8 +299,10 @@ class Api
|
|||||||
/**
|
/**
|
||||||
* Wrap call to Ovh APIs for DELETE requests
|
* Wrap call to Ovh APIs for DELETE requests
|
||||||
*
|
*
|
||||||
* @param $path path ask inside api
|
* @param string $path path ask inside api
|
||||||
* @param $content content to send inside body of request
|
* @param array\\stdClass|null $content content to send inside body of request
|
||||||
|
*
|
||||||
|
* @return array
|
||||||
*
|
*
|
||||||
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
* @throws \GuzzleHttp\Exception\ClientException if http request is an error
|
||||||
*/
|
*/
|
||||||
|
@ -33,7 +33,7 @@ namespace Ovh\Exceptions;
|
|||||||
use Exception;
|
use Exception;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ApiException exception is throwed when a request to OVH API failed
|
* ApiException exception is thrown when a request to OVH API failed
|
||||||
*
|
*
|
||||||
* ApiException appears when the request to OVH API return an error (HTTP
|
* ApiException appears when the request to OVH API return an error (HTTP
|
||||||
* code < 100 or >= 400)
|
* code < 100 or >= 400)
|
||||||
|
@ -33,7 +33,7 @@ namespace Ovh\Exceptions;
|
|||||||
use Exception;
|
use Exception;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* InvalidParameterException exception is throwed when a request failed because of a bad client configuration
|
* InvalidParameterException exception is thrown when a request failed because of a bad client configuration
|
||||||
*
|
*
|
||||||
* InvalidParameterException appears when the request failed because of a bad parameter from
|
* InvalidParameterException appears when the request failed because of a bad parameter from
|
||||||
* the client request.
|
* the client request.
|
||||||
|
@ -33,7 +33,7 @@ namespace Ovh\Exceptions;
|
|||||||
use Exception;
|
use Exception;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* NotLoggedException exception is throwed when there is no credentials defined
|
* NotLoggedException exception is thrown when there is no credentials defined
|
||||||
*
|
*
|
||||||
* NotLoggedException appears when there is no credentials defined in openstack
|
* NotLoggedException appears when there is no credentials defined in openstack
|
||||||
*
|
*
|
||||||
|
Loading…
Reference in New Issue
Block a user