Pitch: Proxmox PHP SDK: uma forma simples e confiável de integrar PHP com Proxmox VE · jefersonflus

Quem já precisou integrar um sistema em PHP com o Proxmox VE provavelmente já passou por isso: a API existe, funciona bem, mas lidar com autenticação, chamadas HTTP repetidas e manutenção ao longo do tempo acaba virando um trabalho maior do que deveria.

O Proxmox PHP SDK nasce justamente para aliviar esse peso. A ideia não é reinventar a API do Proxmox nem esconder sua complexidade, mas oferecer uma forma organizada, previsível e confiável de consumi-la em projetos PHP.

Repositório do projeto:
https://github.com/jefersonflus/Proxmox-PHP-SDK

Uma proposta simples (e honesta)

O SDK segue um princípio claro:

Se existe na API oficial do Proxmox, existe no SDK — do mesmo jeito.

Não há camadas mágicas nem fluxos opinativos. As classes e métodos refletem diretamente a estrutura da API REST, o que torna o uso bastante intuitivo para quem já conhece o Proxmox.

A organização por domínios (Nodes, Cluster, Storage, Access, etc.) ajuda a manter o código limpo e fácil de navegar, mesmo em projetos maiores.

Autenticação sem complicação

Toda a parte de autenticação fica centralizada em um único ponto.

O SDK suporta:

Login tradicional com usuário e senha
Autenticação via API Token (modelo recomendado pelo próprio Proxmox)

Depois disso, o restante das chamadas simplesmente funciona.
Sem estados escondidos, sem sessão espalhada pelo código.

Cobertura completa da API (verificada automaticamente)

Um dos pontos mais fortes do projeto é que ele não assume que cobre toda a API — ele verifica isso automaticamente.

A implementação é validada contra o apidoc.js oficial do Proxmox.

Estado atual:

646 endpoints oficiais
646 endpoints implementados
0 endpoints faltando
0 divergências

Testes e cuidado com manutenção

Além da validação automática da API, o projeto conta com:

Testes de contrato em PHP
131 testes executados
131 testes aprovados
Pipeline com lint, testes e validação estrutural

Esse cuidado faz diferença principalmente para quem mantém sistemas de longo prazo, como painéis, integrações internas ou soluções comerciais.

Uso direto e previsível

Criar uma VM ou um container LXC com o SDK segue exatamente o fluxo esperado da API:

buscar o próximo VMID
escolher o nó
enviar os parâmetros necessários

Nada é escondido do desenvolvedor.
Isso deixa o código claro, fácil de debugar e simples de manter.

Para quem esse SDK faz sentido

O projeto é especialmente útil se você:

Desenvolve backends, painéis ou automações em PHP
Usa Proxmox no dia a dia
Quer evitar código curl repetido e difícil de manter
Prefere controle e previsibilidade em vez de abstrações excessivas

Talvez não seja a melhor escolha se você busca algo declarativo ou de alto nível (como Terraform ou Ansible). E tudo bem — o SDK não tenta ocupar esse espaço.

Conclusão

O Proxmox PHP SDK é um projeto feito com cuidado e propósito.

Ele:

não promete milagres
não esconde complexidade
entrega exatamente o que se propõe a fazer

Para quem precisa integrar PHP com Proxmox VE de forma limpa e confiável, ele resolve um problema real — e resolve bem.