cv4pve-api-php ๐ง

**๐ Official PHP Client Library Suite for Proxmox VE API**
[](LICENSE)
[](https://packagist.org/packages/Corsinvest/cv4pve-api-php)

[](https://packagist.org/packages/Corsinvest/cv4pve-api-php)
โญ **We appreciate your star, it helps!** โญ
```text
______ _ __
/ ____/___ __________(_)___ _ _____ _____/ /_
/ / / __ \/ ___/ ___/ / __ \ | / / _ \/ ___/ __/
/ /___/ /_/ / / (__ ) / / / / |/ / __(__ ) /_
\____/\____/_/ /____/_/_/ /_/|___/\___/____/\__/
Corsinvest for Proxmox VE Api Client (Made in Italy ๐ฎ๐น)
```
๐ About
cv4pve-api-php is a comprehensive PHP client library that provides seamless integration with Proxmox VE's REST API. Designed for developers who need to programmatically manage virtual machines, containers, storage, and cluster resources in Proxmox VE environments., (*1)
๐ฆ Package Suite
Package |
Description |
Status |
corsinvest/cv4pve-api-php |
Core API Client Library |
โ
Available |
๐ Quick Start
Installation
composer require corsinvest/cv4pve-api-php
Basic Usage
<?php
require_once 'vendor/autoload.php';
use Corsinvest\ProxmoxVE\Api\PveClient;
$client = new PveClient("your-proxmox-host.com");
if ($client->login('root', 'password', 'pam')) {
// Get cluster status
$status = $client->getNodes()->get("pve1")->getStatus()->current();
echo "Node Status: " . $status->getResponse()->data->status . "\n";
// List VMs
foreach ($client->getNodes()->get("pve1")->getQemu()->vmlist()->getResponse()->data as $vm) {
echo "VM {$vm->vmid}: {$vm->name} - Status: {$vm->status}\n";
}
}
๐ Key Features
Developer Experience
-
๐ก Intuitive API Structure - Mirrors Proxmox VE API hierarchy for easy navigation
-
๐ Comprehensive Documentation - Detailed examples and API reference
-
๐ง Easy Integration - Simple composer installation and minimal setup required
-
โก Flexible Response Handling - Choose between object or array response formats
Core Functionality
-
๐ Complete API Coverage - Full implementation of Proxmox VE REST API endpoints
-
๐ฅ๏ธ VM & Container Management - Create, configure, start, stop, and monitor VMs and containers
-
๐พ Storage Operations - Manage storage pools, volumes, and backups
-
๐ Cluster Management - Monitor cluster status, resources, and performance
Enterprise Ready
-
๐ Multiple Authentication Methods - Username/password, API tokens, and two-factor authentication
-
๐ก๏ธ Security First - Secure communication with SSL/TLS support
-
๐ Task Management - Built-in support for monitoring long-running operations
-
โฑ๏ธ Connection Management - Configurable timeouts and connection pooling
Technical Excellence
-
๐ Zero Dependencies - Lightweight design using only native PHP cURL
-
๐๏ธ PHP 5.5+ Compatible - Wide compatibility with modern and legacy environments
-
๐ Error Handling - Comprehensive error reporting and exception management
-
๐ฑ Cross-Platform - Works on Windows, Linux, and macOS
๐ Documentation
๐ Getting Help
๐ข About Corsinvest
Corsinvest Srl is an Italian software company specializing in virtualization solutions. We develop professional tools and libraries for Proxmox VE that help businesses automate and manage their virtual infrastructure efficiently., (*2)
๐ค Contributing
We welcome contributions from the community! Whether it's bug fixes, new features, or documentation improvements, your help makes this project better for everyone., (*3)
๐ฏ Use Cases
Perfect for:
- ๐ข Infrastructure Automation - Automate VM/CT deployment and configuration
- ๐ Monitoring & Analytics - Build custom dashboards and monitoring solutions
- ๐พ Backup Management - Implement automated backup and disaster recovery workflows
- ๐ Multi-tenant Environments - Manage multiple Proxmox VE clusters and tenants
- ๐ DevOps Integration - Integrate with CI/CD pipelines and deployment automation, (*4)
โ๏ธ Requirements
-
PHP: 5.5.0 or higher
-
Extension: php-curl (typically included with PHP)
-
Composer: For dependency management
๐ License
Copyright ยฉ Corsinvest Srl, (*5)
This software is part of the cv4pve-tools suite. For licensing details, please visit LICENSE., (*6)