Backup DB ke GDrive

Kembali
Prasyarat Sistem

Pastikan Anda memiliki akses dan kelengkapan berikut sebelum memulai proses instalasi:

Fase 1: Konfigurasi Google Cloud & API

Fase ini bertujuan mendapatkan kredensial otorisasi (credentials.json) agar skrip PHP diizinkan mengunggah file ke Google Drive.

1. Buat Project Baru
  1. Buka Google Cloud Console dan login.
  2. Klik dropdown project di kiri atas, lalu klik New Project.
  3. Beri nama project (misal: "cPanel DB Backup"), lalu klik Create.
2. Aktifkan Google Drive API
  1. Di menu navigasi kiri, pilih APIs & Services > Library.
  2. Cari "Google Drive API".
  3. Klik hasilnya dan tekan tombol Enable.
3. Konfigurasi OAuth Consent Screen
  1. Masuk ke APIs & Services > OAuth consent screen.
  2. Pilih External, lalu klik Create.
  3. Isi informasi wajib: App name, User support email, dan Developer contact info.
  4. Klik Save and Continue melewati tab Scopes dan Test users.
  5. Di halaman Summary, klik Back to Dashboard.
  6. PENTING: Klik tombol Publish App (Ubah status dari Testing menjadi In production agar refresh token tidak kedaluwarsa dalam 7 hari).
4. Buat OAuth Client ID
  1. Masuk ke APIs & Services > Credentials.
  2. Klik + CREATE CREDENTIALS, pilih OAuth client ID.
  3. Pilih Application type: Desktop app (Sangat penting karena ini skrip CLI).
  4. Beri nama (misal: "CLI Backup App"), lalu klik Create.
  5. Unduh file JSON, ubah namanya menjadi credentials.json, dan simpan di komputer Anda.
5. Dapatkan ID Folder GDrive
  1. Buka Google Drive dan masuk ke folder tujuan backup Anda.
  2. Salin ID acak di akhir URL (misal: .../folders/1A2b3C4d5E6f7G8h9I0jK-LmNoPqRsTuV).
  3. Simpan ID ini untuk dimasukkan ke skrip PHP.
Fase 2: Persiapan Environment di cPanel
Keamanan: Skrip dan file kredensial harus diletakkan di luar folder public_html agar tidak dapat diakses langsung oleh publik.
1. Buat Direktori Skrip & Unggah Kredensial
  1. Login ke cPanel, buka File Manager.
  2. Pastikan Anda berada di Home Directory (/home/username/).
  3. Buat folder baru: scripts/db_backup/.
  4. Masuk ke folder tersebut, lalu Upload file credentials.json.
2. Instal Google API Client via Composer
  1. Buka fitur Terminal di cPanel.
  2. Jalankan perintah berikut:
cd ~/scripts/db_backup
composer require google/apiclient:^2.15
Fase 3: Pembuatan Skrip PHP

Buat file backup.php di dalam folder scripts/db_backup/ dan tempelkan kode php di bawah ini. Sesuaikan bagian KONFIGURASI.

<?php
if (php_sapi_name() !== 'cli') {
    http_response_code(403);
    die("Error: Skrip ini hanya dapat dijalankan melalui Terminal.");
}

require __DIR__ . '/vendor/autoload.php';

// 1. KONFIGURASI DATABASE & GOOGLE DRIVE
$dbHost = 'localhost';
$dbUser = 'username_db_anda'; 
$dbPass = 'password_db_anda'; 
$dbName = 'nama_db_anda';     

// ID Folder dari URL Google Drive Anda
$driveFolderId = 'MASUKKAN_ID_FOLDER_DRIVE_ANDA_DISINI'; 

// 2. PROSES BACKUP LOKAL (mysqldump)
$date = date('Y-m-d_H-i-s');
$backupFile = __DIR__ . "/backup_{$dbName}_{$date}.sql";

echo "Mengeksekusi mysqldump...\n";

putenv("MYSQL_PWD=" . $dbPass);

$command = sprintf(
    'mysqldump --opt -h %s -u %s %s > %s 2>&1',
    escapeshellarg($dbHost),
    escapeshellarg($dbUser),
    escapeshellarg($dbName),
    escapeshellarg($backupFile)
);

exec($command, $output, $resultCode);
putenv("MYSQL_PWD=");

if ($resultCode !== 0) {
    die("Gagal melakukan backup. Error: " . implode("\n", $output));
}

// 3. AUTENTIKASI GOOGLE DRIVE API
$client = new Google\Client();
$client->setApplicationName('Backup DB cPanel');
$client->setScopes(Google\Service\Drive::DRIVE_FILE);
$client->setAuthConfig(__DIR__ . '/credentials.json');
$client->setAccessType('offline'); 
$client->setPrompt('select_account consent');

$tokenPath = __DIR__ . '/token.json';

if (file_exists($tokenPath)) {
    $accessToken = json_decode(file_get_contents($tokenPath), true);
    $client->setAccessToken($accessToken);
}

if ($client->isAccessTokenExpired()) {
    if ($client->getRefreshToken()) {
        $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
    } else {
        $authUrl = $client->createAuthUrl();
        printf("\n!!! BUKA URL BERIKUT DI BROWSER !!!\n%s\n", $authUrl);
        print "\nMasukkan Authorization Code: ";
        
        $authCode = trim(fgets(STDIN));
        $accessToken = $client->fetchAccessTokenWithAuthCode($authCode);
        $client->setAccessToken($accessToken);
    }
    file_put_contents($tokenPath, json_encode($client->getAccessToken()));
}

// 4. PROSES UNGGAH KE GOOGLE DRIVE
$service = new Google\Service\Drive($client);

$fileMetadata = new Google\Service\Drive\DriveFile([
    'name' => basename($backupFile),
    'parents' => [$driveFolderId] 
]);

$content = file_get_contents($backupFile);
$file = $service->files->create($fileMetadata, [
    'data' => $content,
    'mimeType' => 'application/sql',
    'uploadType' => 'multipart'
]);

echo "File terunggah. ID: " . $file->id . "\n";

// 5. CLEANUP FILE LOKAL
if (file_exists($backupFile)) {
    unlink($backupFile);
}
echo "Selesai.\n";
Fase 4: Otorisasi Manual (Pertama Kali)
Skrip tidak akan bisa berjalan otomatis sebelum Anda memberikan izin secara manual satu kali untuk menghasilkan file token.json.
  1. Buka Terminal di cPanel.
  2. Jalankan skrip PHP: php /home/username/scripts/db_backup/backup.php
  3. Terminal akan menampilkan URL otorisasi Google. Salin URL tersebut.
  4. Buka URL di browser, login dengan akun Google Drive Anda.
  5. Berikan izin aplikasi. Anda akan mendapatkan Authorization Code.
  6. Salin kode tersebut, paste kembali ke Terminal cPanel, lalu tekan Enter.
  7. Skrip akan mengunggah file pertama Anda dan membuat file token.json.
Fase 5: Otomatisasi dengan Cron Job
  1. Di cPanel, buka menu Cron Jobs.
  2. Atur jadwal (misal: Setiap hari jam 00:00).
    Minute: 0, Hour: 0, Day: *, Month: *, Weekday: *
  3. Pada kotak Command, masukkan perintah berikut (ganti username):
/usr/local/bin/php /home/username/scripts/db_backup/backup.php >/dev/null 2>&1

Penambahan >/dev/null 2>&1 digunakan agar cPanel tidak mengirimkan email notifikasi terminal setiap kali cronjob berhasil dijalankan.