Lightweight PHP wrapper for OVH APIs. That's the easiest way to use OVH.com APIs in your PHP applications.

Hi!

I'm trying to make simple GET request to test how this API works. I have used many days for this but still haven't got this to work.

So I have Application Key, Application Secret and Consumer Key (with granted permissions to /*) and I have downloaded all the decencies (php-ovh-2.0.1-with-dependencies). I have correctly changed correct keys to example codes but they still are not working. I have tested keys with ovh python and that's simple, they are working. With all the examples on the page I get server error:

The * page isn’t working

• is currently unable to handle this request.

My ovh hosting is using PHP 5.4 and when using this page: https://api.ovh.com/console/ I can use all the GET reguest and they are working. Am I missing something or how this works? I don't have composer on my page.

In Api.php line 266: Attempted to call function "build_query" from namespace "GuzzleHttp\Psr7".

Namespace: GuzzleHttp\Psr7 Deprecated: build_query will be removed in guzzlehttp/psr7:2.0. Use Query::build instead.

PS: Works with : $query = \GuzzleHttp\Psr7\Query::build($query);

Bonjour Vincent,

lors de l'appel à DELETE /telephony/{billingAccount}/service/{serviceName} j'ai un 400 Bad Request avec le message INVALID_SIGNATURE quelque soit les droits du token utilisé (DELETE sur /*) sur ce SDK (fonctionne sur d'autres SDK php avec les mêmes paramètres) Avez-vous une idée de l'origine du blocage? Merci Alexandre

I am checking some operation in the API Console about domains.

For me it is very useful the authInfo, unlock, owo, etc. But it would be a lot useful if I could renew the domains in some way, adding even a money balance to my account or so.

Would be available this at some point, so I can automatize the domain renovations? Other domain providers offers an API for this, and I see a lack of feature on OVH, but I would like stay with OVH too if this gets implemented.

As I already mentioned in the #35 issue, I think it's more suitable to use a PHP build tool instead of a JS one. I don't tell that Grunt is not a powerful tool but it's a complicated installation process to be able to run tests.

Phing is required as a composer package and can be run directly after the composer install.

Examples:

vendor/bin/phing
vendor/bin/phing test
vendor/bin/phing clean
vendor/bin/phing phplint
vendor/bin/phing phpcs
vendor/bin/phing phpunit
vendor/bin/phing phpunit -Donly.units=true #The travis test process

The only difference here is the watch process. Phing doesn't have that kind of feature. It can be emulated with different tasks but require a lot more work. I think that PR is the first step, maybe we can go further if necessary.

I rewritten the API to support the new Guzzle 6.0 I also added 100% code coverage and completed the PhpDoc and type hintings

No method name has changed, only the to request with Guzzle.

Since Guzzle 6.0 is clearly not complatible with <6.0, I think this PR should be on a new dev branch (and a new major version )

this allows the license to be known on Packagist instead of marking it as unknown license: https://packagist.org/packages/ovh/ovh

The LICENSE file looks like the text of the MIT license, which is why I did the update this way. If it is not actually the MIT license but a different one, please provide the actual license code.

This fantastic story is about how fantastic OVH has developed its proprietary programming in APIs. Terribly sad part of this story is how little OVH provided user friendly interface, examples or support until today. The example scripts provided are just not sufficient.

Only after a torturous playing with /Ovh/Api.php and firewall.php (created based on default php code from API website, code unchanged) with correct details to login, I found sending an input to /ip/{ip}/firewall/{ipOnFirewall}/rule from my server is useless as it contains dots in the URI query string (from an IP Address).

More details are here:

Get PHP to stop replacing '.' characters in $_GET or $_POST arrays?

https://stackoverflow.com/questions/68651/get-php-to-stop-replacing-characters-in-get-or-post-arrays

One solution is to have Api.php classes modified to convert dots into underscores at client, when it transmits the query string with dots. Thereafter, the receiving server reconverts the changed query string back into IPs, if underscores are found in /firewall parsing of strings. An advantage is that there is no vulnerability in this system.

Second solution is to provide clients a proper functioning php script. In the API, one finds proper php codes after login. They contain dots from IPs. Due to this "DOT in URL" nothing works.

Because OVH APIs provided those php codes, I thought that this problem of dots is taken care of. This is not the case. The script can login and fetch some data from the API path /me. But it does not do anything when an API call is made under php to /ip/{ip}. It gets stuck with dots in {ip} and throws an error with some explanation one takes time to understand .

One of the best solution is to provide a DYNHost function integrated with /ip/{ip}/firewall that could constantly feed in the actual IP of subdomain under DYNHost to sequence 0 every day. A customer could choose under DYNHost if the latest IP should be inserted into /ip/{ip}/firewall/{ipOnFirewall}/rule/{0}. By doing so, all customers shall have their Routers IP automatically inserted into Rule 0 of all firewalls.

In the absence of the above DYNHost function, all clients are required to undergo a torturous deleting and creating IP under Rule 0 for each firewall by making ten - 15 clicks. Had it been there, a customer could bind services to a specific IP, which could then bind and route to a customer's Router IP. With this system, a customer could have secure access to admin services at non-public and non-standard ports directly bound to his Router IP every day. This increases security and ease to use firewall as all admin services are accessible to a customer's Router IP.

Thus, the suggestion is here not only to [Modify Api.php] but also create an extra API for DYNHost function.

Hi,

Today i've started working with the OVH API to do a project to get finished my studies.

I'm trying to create a subdomain using the mentioned API, and it works (it create the subdomain). But however I can't retrieve the returned data that contains the ID with the "post" function, when I return the value of the variable $task, I'm getting always a null object.

To handle all the process i've build a custom class called OVHAPI, next i'll left the code that i've builded:

<?php

	require_once 'libs/php-ovh/vendor/autoload.php';

	use \Ovh\Api;
	use GuzzleHttp\Client;

	class OVHAPI {

	    private $application_key;
		private $application_secret;
		private $consumer_key;
		private $ovh;
		private $http_client;

	    function __construct() {
	    	require("ovh_conexion.php");

	    	$this->http_client = new Client([
				'timeout'         => 30,
				'connect_timeout' => 5,
			]);

	    	$this->ovh = new Api($this->application_key,
                $this->application_secret,
                'ovh-eu',
                $this->consumer_key,
                $this->http_client
            );
	    }

	    function __destruct() {
	        
	    }

	    function createSubdomain($sub_domain, $zone="cocohost.tk", $field_type="A", $target="149.56.108.120") {
	    	$task = $this->ovh->post('/domain/zone/'.$zone.'/record', array(
			    'fieldType' => $field_type,
			    'subDomain' => $sub_domain,
			    'target' => $target,
			    'ttl' => 'NaN'
			));

			$this->ovh->post('/domain/zone/'.$zone.'/refresh');

			return $task;
	    }
	}

?>

Remove the $this->http_client->get() call used in the calculateTimeDelta method.

This call was too coupled to the Http client, using the same method for all the calls is always better.

Guzzle6 was not include into php wrapper because of changes in Exception after Guzzle6 release.

Now, that's time to upgrade!

Thanks to @ByScripts work on https://github.com/ovh/php-ovh/pull/17, we include Guzzle6 into our wrapper.

Backported from https://github.com/carsso/php-ovhcloud

This PR includes many things among :

• Build is using GitHub actions for PHP versions 7.4, 8.0, 8.1 (old travis build config has been removed)
• Code linting (inclued in build checks)
• Updated and uniformized configuration files for tests, documentation and linter (everything can be executed easily through a composer command)
• Updated functional tests (mainly to fix infinite test data persisted in OVHcloud account when tests are interrupted)
• New README file organization

Known limitation discovered in functional tests, not fixed but partially workarounded in GitHub actions config : functional tests cannot not be parallelized because they are changing a real OVHcloud account configuration while being executed.

You will need to enable/setup codecov on this repo here https://app.codecov.io/gh/ovh/php-ovh You don't need to put the codecov token anywhere, codecov will bind directly using github api.

You will also need to create a few secrets in your github actions config :

• OVH_TESTS_APP_KEY
• OVH_TESTS_APP_SECRET
• OVH_TESTS_CONSUMER_KEY
• OVH_TESTS_ENDPOINT

To fill these secrets, generate an unlimited token from the OVHcloud API (I highly recommend to use an empty account dedicated to tests).

Needed rights :

[
  {
    method: "GET",
    path: "/*"
  },
  {
    method: "POST",
    path: "/me/accessRestriction/*"
  },
  {
    method: "PUT",
    path: "/me/accessRestriction/*"
  },
  {
    method: "DELETE",
    path: "/me/accessRestriction/*"
  }
]

When response body contains invalid UTF-8 characters, the script ignore them instead of throwing an error. This si usefull to manage call logs designation like "France Société française du radiotéléphone".

Hi,

The readme explain how to generate the document for this package here.

I followed this step by step but I'm unable to find the phing file in the vendor directory.

I am missing something ?

Environment :

• PHP 7.4.20 (cli)
• Composer version 2.1.2
• ovh/ovh v3.0.0

Bonjour, J'utilise depuis longtemps l'API afin de faire différentes tâches, et mes tâches échouent depuis quelques jours. J'ai essayé de mettre à jour l'API, toujours la même erreur.

Que voici : Fatal error: Uncaught exception 'GuzzleHttp\Exception\ClientException' with message 'Client error: POST https://eu.api.soyoustart.com/1.0/ip/127.0.0.1%2F29/reverse resulted in a 400 Bad Request response: {"errorCode":"INVALID_SIGNATURE","message":"Invalid signature","httpCode":"400 Bad Request"} ' in /var/www/vhosts/azertyuiop.fr/httpdocs/.composer/vendor/guzzlehttp/guzzle/src/Exception/RequestException.php:113 Stack trace: #0 /var/www/vhosts/azertyuiop.fr/httpdocs/.composer/vendor/guzzlehttp/guzzle/src/Middleware.php(66): GuzzleHttp\Exception\RequestException::create(Object(GuzzleHttp\Psr7\Request), Object(GuzzleHttp\Psr7\Response)) #1 /var/www/vhosts/azertyuiop.fr/httpdocs/.composer/vendor/guzzlehttp/promises/src/Promise.php(203): GuzzleHttp\Middleware::GuzzleHttp{closure}(Object(GuzzleHttp\Psr7\Response)) #2 /var/www/vhosts/azertyuiop.fr/httpdocs/.composer/vendor/guzzlehttp/promises/src/Promise.php(156): GuzzleHttp\Promise\Promise::callHandler(1, Object(GuzzleHttp\Psr7\Response), Array) #3 /var/www/vhosts/azertyuiop.fr/httpdocs in /var/www/vhosts/azertyuiop.fr/httpdocs/.composer/vendor/guzzlehttp/guzzle/src/Exception/RequestException.php on line 113

En attente d'une correction, Rapide, je l'espère... Merci à vous.