Download the PHP package chuckbartowski/ovh-sdk without Composer

Framework-agnostic core — usable from any PHP project, script, or worker — with an optional bundle for first-class Symfony integration. The OVHcloud $1$ request signature is implemented natively (no dependency on the official ovh/ovh wrapper), with automatic clock-drift correction, typed exceptions, opt-in retries, and a comment-free, strictly typed codebase (PHP 8.2+, declare(strict_types=1) everywhere).

Table of Contents

• Features
• Requirements
• Installation
• Authentication
• Quick Start (plain PHP)
• Symfony Integration (optional)
• Architecture
• API Reference
  • Account (me)
  • Domains & DNS
  • Dedicated servers
  • VPS
  • Public Cloud
  • Managed Databases & Kubernetes
  • Web Hosting
  • Email
  • IP
  • vRack
  • Load Balancer
  • CDN, Licenses, Orders, SMS, Logs, Support, VoIP
  • Generic access
• Responses
• Error Handling
• Testing
• Security Notes
• WHMCS module
• License

Features

Requirements

Installation

If the package is published on Packagist:

Authentication

OVHcloud signs every request with X-Ovh-Signature: $1$ + sha1(secret + "+" + consumerKey + "+" + method + "+" + url + "+" + body + "+" + timestamp). This SDK does all of it for you — you only provide three credentials:

• Application key + Application secret — identify your app (create an application).
• Consumer key — identifies the authorization granted to your app on an account.

The fastest path is api.ovh.com/createToken which gives you all three at once. To mint a consumer key programmatically with a chosen scope:

The clock-drift correction is automatic: the first signed call fetches OVHcloud's server time from /auth/time and offsets every subsequent timestamp, so a skewed local clock never breaks the signature.

Quick Start (plain PHP)

Client constructor signature:

Symfony Integration (optional)

Register the bundle, then create config/packages/ovh_sdk.yaml:

The Ovh facade is then autowirable in controllers, services, commands, and message handlers.

Architecture

API Reference

Every method returns an ApiResponse and throws on failure. Service names (domains, VPS, dedicated servers…) are URL-encoded for you.

Account (me)

$ovh->me() — info(), update(), bills() / bill(id), orders() / order(id), paymentMethods(), contacts(), SSH keys (sshKeys, addSshKey, deleteSshKey), API credentials (apiApplications, apiCredentials, revokeCredential), iamPolicies(), and fetch(path) for any other /me/* endpoint.

Domains & DNS

$ovh->domains() — domain lifecycle (list, find, serviceInfos, nameservers, updateNameservers, dnssec) and the full DNS zone editor:

Dedicated servers

$ovh->dedicatedServers() — list, find, update, serviceInfos, hardware, network, reboot, reinstall(name, options) + installStatus, bootOptions, setMonitoring, ipmiAccess, interventions, tasks.

VPS

$ovh->vps() — list, find, update, power (reboot, start, stop), reinstall(name, options), images, ips, snapshots (snapshots, createSnapshot), disks, tasks.

Public Cloud

$ovh->cloud() — every method takes the $projectId first:

Anything else on a project: cloud()->fetch($projectId, '/…').

Managed Databases & Kubernetes

$ovh->cloudDatabases() — services(projectId), list(projectId, engine) (postgresql, mysql, redis, mongodb, kafka…), create, deleteCluster, databases, users, createUser, backups. $ovh->kubernetes() — clusters, cluster, create, update, deleteCluster, kubeconfig, reset, node pools (nodePools, createNodePool, updateNodePool, deleteNodePool), nodes.

Web Hosting

$ovh->webHosting() — list, find, attached domains, databases (databases, createDatabase), cron, users, SSL (ssl, requestSsl), ovhConfigs, tasks.

Email

$ovh->email() — MX Plan (domains, accounts, createAccount, deleteAccount, changePassword, redirections, mailing lists) and Exchange (exchangeServices, exchangeAccounts).

IP

$ovh->ips() — list, find, reverse DNS (reverse, setReverse, deleteReverse), move, park, firewall (firewall, enableFirewall, firewallRules, addFirewallRule), DDoS mitigation (mitigation, enableMitigation).

vRack

$ovh->vrack() — list, find, and membership management: dedicated servers, cloud projects, IP blocks (add/remove for each).

Load Balancer

$ovh->loadBalancers() — IPLB services: frontends/createFrontend, backends/createBackend, servers/addServer, pendingChanges, and refresh() to apply staged changes.

CDN, Licenses, Orders, SMS, Logs, Support, VoIP

• $ovh->cdn() — dedicated & website CDN, domains, flushCache.
• $ovh->licenses() — Windows, cPanel, Plesk, DirectAdmin, Office licenses.
• $ovh->orders() — cart lifecycle (createCart, addItem, checkout) and public catalog.
• $ovh->sms() — send(service, receivers, message), jobs, outgoing/incoming, senders.
• $ovh->dbaasLogs() — Logs Data Platform: streams, dashboards, inputs, aliases.
• $ovh->support() — tickets (create, reply, close, messages).
• $ovh->voip() — Telephony: billing accounts, lines, numbers, consumption, click2Call.

Generic access

Any endpoint not wrapped by a module stays one call away — signing, endpoint and error handling still apply:

Responses

Note the OVHcloud idiom: list endpoints usually return arrays of identifiers (record IDs, service names), which you then fetch individually — records() returns IDs, record($zone, $id) returns the detail.

Error Handling

All SDK exceptions implement OvhSdkExceptionInterface:

Testing

The suite runs entirely offline against MockHttpClient — including a test that recomputes the $1$ signature byte-for-byte:

Security Notes

• The application secret and consumer key are passed with #[\SensitiveParameter], so they never appear in stack traces.
• Scope consumer keys tightly with accessRules — grant GET /domain/*, not ALL /*, when a service only reads domains.
• Keep credentials in .env.local or your secret vault — never commit them.
• Destructive calls (deleteInstance, deleteRecord, deleteCluster, dedicated reinstall) are irreversible — gate them behind confirmation flows.

WHMCS module

A ready-to-use WHMCS registrar module ships in whmcs/modules/registrars/ovhsdk/. It plugs OVHcloud domains into WHMCS's DNS and nameserver management through this SDK.

Install

1. composer require chuckbartowski/ovh-sdk in your WHMCS root.
2. Copy the ovhsdk folder into <whmcs>/modules/registrars/.
3. Activate OVHcloud (SDK) in System Settings » Domain Registrars and enter your application key / secret / consumer key and endpoint.

Domain registration and transfers go through OVHcloud's order cart (orders()), which is a multi-step purchase flow — the registrar hooks above cover the day-to-day DNS management that WHMCS drives automatically.

License

MIT