PHPackages                             caiovieiraflor/cloudz - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. caiovieiraflor/cloudz

ActiveLibrary[Utility & Helpers](/categories/utility)

caiovieiraflor/cloudz
=====================

v2.0.0(10mo ago)02PHP

Since Jul 11Pushed 9mo agoCompare

[ Source](https://github.com/CaioVieiraFlor/cloudz)[ Packagist](https://packagist.org/packages/caiovieiraflor/cloudz)[ RSS](/packages/caiovieiraflor-cloudz/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (3)Versions (3)Used By (0)

CloudZ
======

[](#cloudz)

Bem-vindo ao CloudZ Library
---------------------------

[](#bem-vindo-ao-cloudz-library)

O CloudZ é uma biblioteca PHP desenvolvida para facilitar a interação com diferentes serviços de armazenamento em nuvem através de uma interface unificada e intuitiva.

Serviços Suportados
-------------------

[](#serviços-suportados)

- **FTP** - File Transfer Protocol
- **SFTP** - SSH File Transfer Protocol
- **AWS S3** - Amazon Simple Storage Service
- **Google Drive** - Google Drive API

Instalação
----------

[](#instalação)

A biblioteca CloudZ está disponível via Composer:

```
composer require caiovieiraflor/cloudz
```

Inicialização
-------------

[](#inicialização)

Para usar a biblioteca CloudZ, você deve fornecer os dados da conta diretamente ao instanciar o serviço:

```
use CloudZ\CloudService;
use CloudZ\CloudServiceTypes;

// Dados da conta FTP
$accountData = [
    'host' => '192.168.0.1',
    'port' => 21,
    'user' => 'admin',
    'password' => '123456',
    'isPassive' => true,
    'dirWork' => '/uploads',
    'urlAccess' => 'http://example.com/uploads',
    'useSSH' => false
];

$cloudService = new CloudService(CloudServiceTypes::FTP_ACCOUNT, $accountData);
```

### Estrutura de Dados por Serviço

[](#estrutura-de-dados-por-serviço)

#### FTP/SFTP

[](#ftpsftp)

```
$ftpData = [
    'host' => '192.168.0.1',
    'port' => 21,              // 21 para FTP, 22 para SFTP
    'user' => 'username',
    'password' => 'password',
    'isPassive' => true,       // true/false
    'dirWork' => '/uploads',
    'urlAccess' => 'http://example.com/uploads',
    'useSSH' => false          // false para FTP, true para SFTP
];
```

#### AWS S3

[](#aws-s3)

```
$s3Data = [
    'AWSKey' => 'YOUR_ACCESS_KEY',
    'AWSSecretKey' => 'YOUR_SECRET_KEY',
    'AWSRegion' => 'us-east-1',
    'AWSType' => 'S3',
    'bucketName' => 'my-bucket'
];
```

#### Google Drive

[](#google-drive)

```
$driveData = [
    'clientId' => 'your_google_client_id.apps.googleusercontent.com',
    'clientSecret' => 'your_google_client_secret',
    'refreshToken' => 'your_refresh_token',
    'folderId' => null,              // ou ID da pasta específica
    'type' => 'GOOGLE-DRIVE'
];
```

Tipos de Serviços
-----------------

[](#tipos-de-serviços)

Use as constantes da classe `CloudServiceTypes`:

```
use CloudZ\CloudServiceTypes;

// Constantes disponíveis
CloudServiceTypes::FTP_ACCOUNT        // 'FTP'
CloudServiceTypes::AWS_S3_ACCOUNT     // 'AWS-S3'
CloudServiceTypes::GOOGLE_DRIVE_ACCOUNT // 'GOOGLE-DRIVE'
```

Configurações
-------------

[](#configurações)

A classe `CloudService` permite configurações opcionais através da propriedade `settings`:

```
use CloudZ\CloudService;
use CloudZ\CloudServiceTypes;

$cloudService = new CloudService(CloudServiceTypes::FTP_ACCOUNT, $accountData);

// Configurações disponíveis
$cloudService->settings->add('canEncryptName', true);      // Criptografa o nome do arquivo
$cloudService->settings->add('canDeleteAfterUpload', true); // Remove arquivo local após upload
$cloudService->settings->add('path', '/custom/directory');  // Define diretório específico
```

### Configurações Disponíveis

[](#configurações-disponíveis)

- **canEncryptName** (bool): Criptografa o nome do arquivo durante o envio
- **canDeleteAfterUpload** (bool): Remove o arquivo local após upload bem-sucedido
- **path** (string): Define um diretório específico no serviço de nuvem

Utilitários de Caminho
----------------------

[](#utilitários-de-caminho)

A biblioteca oferece utilitários para organização de diretórios:

```
use CloudZ\Utility\Path\CloudServicePathUtility;

// Para projetos de solução
$solutionPath = CloudServicePathUtility::mountSolutionPath('root', 'meuProjeto', 'modulo');
// Resultado: 'root/solucoes/meuProjeto/modulo/'

// Para integrações externas
$integrationPath = CloudServicePathUtility::mountIntegrationPath('root', 'minhaIntegracao');
// Resultado: 'root/integracoes/minhaIntegracao/'

// Usando com configurações
$cloudService->settings->add('path', $solutionPath);
```

Operações com Arquivos
----------------------

[](#operações-com-arquivos)

### Upload de Arquivos

[](#upload-de-arquivos)

```
use CloudZ\CloudService;
use CloudZ\CloudServiceFile;
use CloudZ\CloudServiceTypes;

$cloudService = new CloudService(CloudServiceTypes::FTP_ACCOUNT, $accountData);

// Preparar arquivo
$file = new CloudServiceFile('C:\Documents\exemplo.txt');

// Realizar upload
$response = $cloudService->upload($file);

// Verificar resultado
if ($response->getCode() === 200) {
    echo "Upload realizado com sucesso!";
    echo "URL de acesso: " . $response->getUrl();
} else {
    echo "Erro no upload: " . $response->getMessage();
}
```

### Exclusão de Arquivos

[](#exclusão-de-arquivos)

```
use CloudZ\DeleteCloudServiceFile;

// Criar referência do arquivo remoto pela URL
$remoteFile = new DeleteCloudServiceFile('http://example.com/uploads/arquivo.txt');

// Realizar exclusão
$response = $cloudService->delete($remoteFile);

// Verificar resultado
if ($response->getCode() === 200) {
    echo "Arquivo excluído com sucesso!";
} else {
    echo "Erro na exclusão: " . $response->getMessage();
}
```

Respostas da API
----------------

[](#respostas-da-api)

Todas as operações retornam objetos de resposta com informações estruturadas:

### Resposta de Sucesso

[](#resposta-de-sucesso)

```
// Propriedades disponíveis
$response->getCode();     // 200 para sucesso
$response->getMessage();  // Mensagem de sucesso
$response->getUrl();      // URL de acesso (apenas para upload)
```

### Resposta de Erro

[](#resposta-de-erro)

```
// Propriedades disponíveis
$response->getCode();     // 400 para erro
$response->getMessage();  // Descrição do erro
```

Exemplos Completos
------------------

[](#exemplos-completos)

### Exemplo FTP com Configurações

[](#exemplo-ftp-com-configurações)

```
use CloudZ\CloudService;
use CloudZ\CloudServiceFile;
use CloudZ\CloudServiceTypes;
use CloudZ\Utility\Path\CloudServicePathUtility;

// Dados da conta FTP
$ftpAccount = [
    'host' => 'ftp.example.com',
    'port' => 21,
    'user' => 'username',
    'password' => 'password',
    'isPassive' => true,
    'dirWork' => '/public_html',
    'urlAccess' => 'https://example.com',
    'useSSH' => false
];

// Criar serviço
$cloudService = new CloudService(CloudServiceTypes::FTP_ACCOUNT, $ftpAccount);

// Configurar caminho organizado
$projectPath = CloudServicePathUtility::mountSolutionPath('uploads', 'meuSistema', 'documentos');
$cloudService->settings->add('path', $projectPath);
$cloudService->settings->add('canEncryptName', true);
$cloudService->settings->add('canDeleteAfterUpload', false);

// Upload
$file = new CloudServiceFile('/local/path/documento.pdf');
$uploadResponse = $cloudService->upload($file);

if ($uploadResponse->getCode() === 200) {
    echo "Arquivo enviado: " . $uploadResponse->getUrl();
}
```

### Exemplo AWS S3

[](#exemplo-aws-s3)

```
use CloudZ\CloudService;
use CloudZ\CloudServiceFile;
use CloudZ\CloudServiceTypes;

// Dados da conta AWS S3
$s3Account = [
    'AWSKey' => 'YOUR_ACCESS_KEY',
    'AWSSecretKey' => 'YOUR_SECRET_KEY',
    'AWSRegion' => 'us-east-1',
    'AWSType' => 'S3',
    'bucketName' => 'my-application-bucket'
];

// Criar serviço
$cloudService = new CloudService(CloudServiceTypes::AWS_S3_ACCOUNT, $s3Account);

// Configurar pasta específica
$cloudService->settings->add('path', 'user-uploads/images/');

// Upload
$file = new CloudServiceFile('/local/images/photo.jpg');
$response = $cloudService->upload($file);

if ($response->getCode() === 200) {
    echo "Imagem disponível em: " . $response->getUrl();
}
```

### Exemplo Google Drive

[](#exemplo-google-drive)

```
use CloudZ\CloudService;
use CloudZ\CloudServiceFile;
use CloudZ\CloudServiceTypes;
use CloudZ\GoogleDrive\GoogleDriveHelper;

// Dados da conta Google Drive
$driveAccount = [
    'clientId' => 'your_client_id.apps.googleusercontent.com',
    'clientSecret' => 'your_client_secret',
    'refreshToken' => 'your_refresh_token',
    'folderId' => null,
    'type' => 'GOOGLE-DRIVE'
];

// Criar serviço
$cloudService = new CloudService(CloudServiceTypes::GOOGLE_DRIVE_ACCOUNT, $driveAccount);

// Opcional: Usar GoogleDriveHelper para gerenciar pastas
$googleDriveHelper = new GoogleDriveHelper($cloudService->account);

// Testar conexão
if (!$googleDriveHelper->testConnection()) {
    echo "❌ Erro na conexão com Google Drive!";
    exit;
}

// Criar ou encontrar pasta
$pastaId = $googleDriveHelper->findFolderByName('MeusProjetos');
if (!$pastaId) {
    $pastaId = $googleDriveHelper->createFolder('MeusProjetos');
}

// Definir pasta de destino
$cloudService->account->folderId = $pastaId;

// Configurações adicionais
$cloudService->settings->add('makePublic', true);

// Upload
$file = new CloudServiceFile('/local/documents/report.docx');
$response = $cloudService->upload($file);

if ($response->getCode() === 200) {
    echo "Documento no Google Drive: " . $response->getUrl();
}
```

Ferramentas e Utilitários
-------------------------

[](#ferramentas-e-utilitários)

### ArrayHelper

[](#arrayhelper)

Utilitário para manipulação de arrays (localizado em `CloudZ\Utility\ArrayHelper`).

### CloudServiceUtility

[](#cloudserviceutility)

Classe base para utilitários da biblioteca (localizado em `CloudZ\Utility\CloudServiceUtility`).

### Validação de Contas

[](#validação-de-contas)

A biblioteca inclui validadores automáticos para cada tipo de serviço:

- `AWSS3AccountValidationStrategy`
- `FtpAccountValidationStrategy`
- `GoogleDriveAccountValidationStrategy`

Arquitetura
-----------

[](#arquitetura)

### Padrões Implementados

[](#padrões-implementados)

- **Strategy Pattern**: Para diferentes serviços de nuvem
- **Factory Pattern**: Para criação de contas e estratégias
- **Builder Pattern**: Para construção de objetos de conta

### Estrutura de Classes Principais

[](#estrutura-de-classes-principais)

- `CloudService`: Classe principal da biblioteca
- `CloudServiceFile`: Representa arquivos locais
- `DeleteCloudServiceFile`: Representa arquivos remotos para exclusão
- `CloudServiceSettings`: Gerencia configurações
- `CloudServiceTypes`: Constantes dos tipos de serviço

Requisitos
----------

[](#requisitos)

- PHP 7.4 ou superior
- Composer
- Extensões PHP necessárias conforme o serviço:
    - `curl` para AWS S3 e Google Drive
    - `ftp` para FTP
    - `ssh2` para SFTP

Licença
-------

[](#licença)

Este projeto está licenciado sob os termos especificados no arquivo LICENSE.

Autores
-------

[](#autores)

- **Caio Flor** -
- **Lucas Soares** -

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance55

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~31 days

Total

2

Last Release

326d ago

Major Versions

v1.0.0 → v2.0.02025-08-12

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/934738?v=4)[Kristof](/maintainers/cloudz)[@cloudz](https://github.com/cloudz)

---

Top Contributors

[![CaioVieiraFlor](https://avatars.githubusercontent.com/u/75533933?v=4)](https://github.com/CaioVieiraFlor "CaioVieiraFlor (4 commits)")

### Embed Badge

![Health badge](/badges/caiovieiraflor-cloudz/health.svg)

```
[![Health](https://phpackages.com/badges/caiovieiraflor-cloudz/health.svg)](https://phpackages.com/packages/caiovieiraflor-cloudz)
```

###  Alternatives

[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k43](/packages/civicrm-civicrm-core)[akeneo/pim-community-dev

Akeneo PIM, the future of catalog management is open!

1.0k624.1k86](/packages/akeneo-pim-community-dev)[altis/core

Core module for Altis

19228.0k3](/packages/altis-core)[phpseclib/phpseclib2_compat

phpseclib 2.0 polyfill built with phpseclib 3.0

132.1M17](/packages/phpseclib-phpseclib2-compat)[shopware/app-php-sdk

Shopware App SDK for PHP

15109.8k3](/packages/shopware-app-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)