OVHcloud APIs 轻量级 PHP 包装器安装与配置指南

OVHcloud APIs 轻量级 PHP 包装器安装与配置指南

php-ovh Lightweight PHP wrapper for OVH APIs. That's the easiest way to use OVH.com APIs in your PHP applications. 项目地址: https://gitcode.com/gh_mirrors/ph/php-ovh

1. 项目基础介绍和主要编程语言

本项目是一个开源的 PHP 包，提供对 OVHcloud API 的轻量级包装。它使得 PHP 应用程序可以更加简便地接入和使用 OVHcloud 提供的 API 服务。主要编程语言为 PHP。

2. 项目使用的关键技术和框架

• PHP: 项目的主要编程语言。
• GuzzleHttp: 一个 PHP HTTP 客户端库，用于发送 HTTP 请求。
• Composer: PHP 的依赖管理工具，用于管理和安装项目依赖。

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

在开始安装之前，请确保您的开发环境满足以下要求：

• PHP 版本至少为 7.4，兼容 8.0、8.1、8.2。
• 安装了 Composer。
• 您已经拥有 OVHcloud 账户，并能够获取到应用程序密钥（application key）、应用程序密钥（application secret）以及消费者密钥（consumer key）。

安装步骤

以下是将 OVHcloud PHP 包装器集成到您的 PHP 应用程序中的步骤：

1. 克隆仓库

   使用 Git 命令克隆项目到您的本地环境：

   git clone https://github.com/ovh/php-ovh.git
   

2. 安装依赖

   进入项目目录，并使用 Composer 安装项目依赖：

   cd php-ovh
   composer install
   

3. 配置 OVHcloud 凭据

   在您项目的合适位置创建一个配置文件，并添加您的 OVHcloud 凭据：

   // config.php
   return [
       'applicationKey' => '您的应用程序密钥',
       'applicationSecret' => '您的应用程序密钥',
       'endpoint' => 'ovh-eu', // 根据您的 OVHcloud 区域选择 'ovh-eu', 'ovh-ca', 或 'ovh-us'
       'consumerKey' => '您的消费者密钥',
   ];
   

4. 初始化 OVHcloud API 客户端

   在您的 PHP 脚本中引入 Composer 的自动加载文件，并初始化 OVHcloud API 客户端：

   // index.php
   require 'vendor/autoload.php';
   
   use Ovh\Api;
   
   $config = require 'config.php';
   
   $ovh = new Api(
       $config['applicationKey'],
       $config['applicationSecret'],
       $config['endpoint'],
       $config['consumerKey']
   );
   

5. 测试 API 调用

   现在您可以尝试进行一个简单的 API 调用，例如获取当前登录用户的名字：

   try {
       echo "Welcome " . $ovh->get('/me')['firstname'];
   } catch (\GuzzleHttp\Exception\ClientException $e) {
       echo $e->getResponse()->getBody()->getContents();
   }
   

按照上述步骤，您应该能够成功安装并配置 OVHcloud PHP 包装器，并开始使用 OVHcloud API。

php-ovh Lightweight PHP wrapper for OVH APIs. That's the easiest way to use OVH.com APIs in your PHP applications. 项目地址: https://gitcode.com/gh_mirrors/ph/php-ovh