Quickstarters
Bagaimana Membangun Backend untuk PHP?

40min
Pendahuluan
Dalam tutorial ini, Anda akan belajar cara membangun backend untuk PHP menggunakan Back4App untuk mendukung aplikasi web dinamis di sisi server. 
Kami akan fokus pada integrasi layanan kunci Back4App, seperti manajemen database, Fungsi Cloud Code, API REST dan GraphQL, otentikasi pengguna, dan kueri waktu nyata. 
Dengan mengikuti langkah-langkah ini, Anda akan membuat backend yang aman, dapat diskalakan, dan kuat yang dapat Anda gunakan dalam proyek PHP Anda.
Kami juga akan melihat mengapa Back4App mempercepat pengembangan backend dibandingkan membangun semuanya dari awal, sehingga Anda dapat menghemat waktu dan usaha. 
Anda akan menemukan cara untuk menerapkan keamanan tingkat lanjut, menjadwalkan tugas dengan Cloud Jobs, dan menghubungkan integrasi eksternal dengan webhook, semua sambil mengandalkan infrastruktur Back4App.
Pada akhir, Anda akan siap untuk mengembangkan backend sisi server dasar ini menjadi pengaturan produksi yang lengkap, atau mengintegrasikan API pihak ketiga dan logika kustom untuk penggunaan dunia nyata.
Prasyarat
Untuk menyelesaikan tutorial ini, Anda akan membutuhkan:
Akun Back4app dan proyek Back4App baru
Memulai dengan Back4app.
Jika Anda belum memiliki akun, buat satu secara gratis dan ikuti panduan untuk menyiapkan proyek baru Anda.
Lingkungan pengembangan PHP dasar
Anda dapat mengatur ini secara lokal dengan PHP terinstal atau menggunakan lingkungan hosting yang mendukung PHP.
Dokumentasi Resmi PHP.﻿
Dukungan cURL atau cara untuk mengirim permintaan HTTP
Sebagian besar instalasi PHP menyertakan cURL secara default.
Menginstal cURL (Dokumen Resmi).﻿
Keterampilan dasar tentang aplikasi web
Memahami HTTP, scripting sisi server, dan konsep dasar basis data akan sangat membantu.
Pastikan Anda memiliki prasyarat ini sebelum terjun ke langkah-langkah di bawah ini. Memiliki proyek Back4App Anda yang disiapkan dan lingkungan PHP yang siap akan memudahkan Anda untuk mengikuti.
Langkah 1 – Menyiapkan Proyek Back4App
Buat Proyek Baru
Langkah pertama dalam membangun backend sisi server Anda di Back4App adalah membuat proyek baru. Jika Anda belum melakukannya, ikuti langkah-langkah ini:
Masuk ke akun Back4App Anda.
Klik tombol “Aplikasi Baru” di dasbor Back4App Anda.
Beri nama aplikasi Anda (misalnya, “PHP-Backend-Tutorial”).
﻿
Setelah dibuat, proyek Back4App baru Anda akan muncul di dasbor. Proyek ini akan menjadi dasar untuk langkah-langkah konfigurasi yang akan datang.
Sambungkan ke Back4App melalui REST API
Karena kami bekerja dengan PHP tanpa SDK khusus Parse, kami akan mengandalkan REST dan GraphQL API Back4App untuk komunikasi. Anda akan memerlukan kredensial berikut dari dasbor Back4App Anda:
ID Aplikasi
Kunci REST API
URL Server Parse (biasanya https://parseapi.back4app.com)
Anda dapat menemukan ini dengan menavigasi ke Pengaturan Aplikasi atau bagian Keamanan & Kunci.
﻿
Dalam PHP, Anda dapat melakukan permintaan HTTP menggunakan cURL atau pustaka lainnya. Berikut adalah contoh singkat mengirim permintaan POST ke Back4App:
PHP
$url = 'https://parseapi.back4app.com/classes/Todo';
$data = array(
  'title' => 'Buy groceries',
  'isCompleted' => false
);
$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  'X-Parse-Application-Id: YOUR_APPLICATION_ID',
  'X-Parse-REST-API-Key: YOUR_REST_API_KEY',
  'Content-Type: application/json'
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

echo $result; // Print API response
$url = 'https://parseapi.back4app.com/classes/Todo';
$data = array(
  'title' => 'Buy groceries',
  'isCompleted' => false
);
$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  'X-Parse-Application-Id: YOUR_APPLICATION_ID',
  'X-Parse-REST-API-Key: YOUR_REST_API_KEY',
  'Content-Type: application/json'
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

echo $result; // Print API response
﻿
Potongan kode ini menunjukkan cara menghubungkan aplikasi PHP Anda ke backend Back4App Anda. Modifikasi YOUR_APPLICATION_ID, YOUR_REST_API_KEY, dan parameter lainnya agar sesuai dengan kunci Anda sendiri. Dengan melakukan ini, kode sisi server Anda dapat membaca dan menulis data di proyek baru Anda.
Langkah 2 – Menyiapkan Database
Membuat Model Data
Dengan proyek Back4App Anda siap, saatnya untuk menyusun database Anda. Model data mendefinisikan bagaimana data aplikasi web Anda diorganisir. Misalnya, Anda mungkin menyimpan tugas atau posting blog dalam kelas.
Pergi ke bagian “Database” di dasbor Back4App Anda.
Buat kelas baru (misalnya, “Todo”) dengan bidang seperti title (String) dan isCompleted (Boolean).
Buat Kelas Baru
﻿
Back4App memungkinkan Anda untuk membuat kolom untuk berbagai jenis data, termasuk String, Number, Boolean, Pointer, Relation, File, dan lainnya. Anda juga dapat membiarkan skema dibuat secara otomatis saat Anda pertama kali menyimpan objek dari skrip PHP Anda.
Buat Kolom
﻿
Membuat Model Data Menggunakan Agen AI
Agen AI Back4App dapat mengotomatiskan pembuatan model data:
Buka Agen AI dari Dasbor.
Berikan deskripsi seperti “Tolong buat aplikasi ToDo baru di Back4App dengan skema kelas yang lengkap.”
Biarkan Agen AI membuat skema basis data untuk Anda.
﻿
Fitur ini dapat menghemat waktu Anda dan menjaga aplikasi sisi server Anda tetap konsisten.
Membaca dan Menulis Data (REST API)
Untuk menyimpan objek baru di kelas Todo menggunakan REST, Anda dapat mengirim permintaan POST:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
﻿
Dalam PHP, Anda akan melakukan sesuatu yang serupa dengan cURL. Misalnya:
PHP
$url = 'https://parseapi.back4app.com/classes/Todo';
$data = array('title' => 'Buy groceries', 'isCompleted' => false);
// ... (same cURL setup as before)
$url = 'https://parseapi.back4app.com/classes/Todo';
$data = array('title' => 'Buy groceries', 'isCompleted' => false);
// ... (same cURL setup as before)
﻿
Untuk menanyakan semua Todo yang ada:
Bash
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  https://parseapi.back4app.com/classes/Todo
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  https://parseapi.back4app.com/classes/Todo
﻿
Membaca dan Menulis Data (API GraphQL)
Back4App juga mendukung GraphQL. Anda dapat menyisipkan atau mengambil data dengan mengirimkan kueri atau mutasi GraphQL ke:
Text
https://parseapi.back4app.com/graphql
https://parseapi.back4app.com/graphql
﻿
Sisipkan (Mutasi):
GraphQL
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
﻿
Kueri:
GraphQL
query {
  todos {
    edges {
      node {
        objectId
        title
        isCompleted
      }
    }
  }
}
query {
  todos {
    edges {
      node {
        objectId
        title
        isCompleted
      }
    }
  }
}
﻿
Bekerja dengan Kueri Langsung (opsional)
Jika Anda memerlukan pembaruan waktu nyata dalam aplikasi web Anda, pertimbangkan Kueri Langsung. Aktifkan Kueri Langsung di dasbor Back4App Anda, lalu gunakan pendekatan WebSocket dari lingkungan PHP Anda (atau klien terpisah) untuk berlangganan perubahan. Meskipun lebih umum di klien JavaScript, Anda dapat mengatur soket terpisah di PHP jika diperlukan. Untuk detail lebih lanjut, lihat Dokumentasi Kueri Langsung Back4App.﻿
Langkah 3 – Menerapkan Keamanan dengan ACL dan CLP
Ikhtisar Singkat
ACL (Daftar Kontrol Akses) dan CLP (Izin Tingkat Kelas) melindungi data Anda dengan mengontrol siapa yang dapat membaca atau menulis objek. Ini mengamankan backend Anda dari akses yang tidak sah.
﻿
Langkah-demi-Langkah
Atur Izin Tingkat Kelas (CLP) di dasbor Database. Anda dapat membatasi baca/tulis publik atau memerlukan otentikasi.
Konfigurasi ACL pada setiap objek jika Anda memerlukan kontrol yang lebih rinci. ACL dapat menentukan akses baca/tulis untuk pengguna atau peran tertentu.
Untuk detail lebih lanjut, lihat Pedoman Keamanan Aplikasi.﻿
Langkah 4 – Menulis Fungsi Kode Cloud
Mengapa Kode Cloud
Kode Cloud memungkinkan Anda menjalankan JavaScript sisi server untuk tugas seperti logika bisnis, pemicu, atau validasi, tanpa mengatur server Anda sendiri. Dengan cara ini, Anda dapat menyimpan kode tertentu secara tersembunyi, melakukan transformasi data, dan banyak lagi.
Contoh Fungsi
Fungsi Kode Cloud sederhana yang menghitung panjang teks:
JS
// main.js
Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
// main.js
Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
﻿
Fungsi ini dapat dipanggil dari skrip PHP Anda menggunakan REST:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello Back4app"}' \
  https://parseapi.back4app.com/functions/calculateTextLength
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello Back4app"}' \
  https://parseapi.back4app.com/functions/calculateTextLength
﻿
Penerapan
Anda dapat menerapkan Cloud Code melalui Back4App CLI atau Dasbor Back4App.
Modul NPM
Jika Anda memerlukan pustaka tambahan, instal dengan npm dan impor ke dalam Cloud Code Anda. Ini berguna untuk integrasi sisi server yang lebih lanjut.
Langkah 5 – Mengonfigurasi Autentikasi
Aktifkan Autentikasi
Secara default, proyek Back4App Anda memiliki autentikasi pengguna melalui Parse.User kelas. Anda dapat mengontrol apakah pengguna harus memverifikasi email mereka atau hanya masuk melalui nama pengguna/kata sandi.
Daftar, Masuk, Keluar (REST)
Buat pengguna:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "alice","password": "secret123","email": "[email protected]"}' \
  https://parseapi.back4app.com/users
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "alice","password": "secret123","email": "alice@example.com"}' \
  https://parseapi.back4app.com/users
﻿
Masuk sebagai pengguna yang sudah ada:
Bash
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -G \
  --data-urlencode 'username=alice' \
  --data-urlencode 'password=secret123' \
  https://parseapi.back4app.com/login
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -G \
  --data-urlencode 'username=alice' \
  --data-urlencode 'password=secret123' \
  https://parseapi.back4app.com/login
﻿
Masuk Sosial
Login sosial (Google, Apple, Facebook) dimungkinkan dengan mengonfigurasi alur OAuth. Untuk petunjuk, lihat di Dokumentasi Login Sosial.﻿
Langkah 6 – Menangani Penyimpanan File
Mengatur Penyimpanan File
Anda dapat mengunggah file melalui REST:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: image/jpeg" \
  --data-binary "@/path/to/myImage.jpg" \
  https://parseapi.back4app.com/files/myImage.jpg
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: image/jpeg" \
  --data-binary "@/path/to/myImage.jpg" \
  https://parseapi.back4app.com/files/myImage.jpg
﻿
Respons JSON berisi URL file. Anda dapat menyimpan URL ini di kelas Anda untuk merujuk ke file yang diunggah.
Contoh
Bash
{
  "name": "myImage.jpg",
  "url": "https://myapp.back4app.io/files/myImage.jpg"
}
{
  "name": "myImage.jpg",
  "url": "https://myapp.back4app.io/files/myImage.jpg"
}
﻿
Pertimbangan Keamanan
Anda dapat mengizinkan unggahan file hanya dari pengguna yang terautentikasi atau dari peran tertentu. Konfigurasikan aturan unggahan file di pengaturan server.
Langkah 7 – Verifikasi Email dan Reset Kata Sandi
Ikhtisar
Verifikasi email memastikan hanya alamat email yang valid yang digunakan. Reset kata sandi memungkinkan pengguna untuk memulihkan akun mereka dengan aman.
Konfigurasi Dasbor
Di Dasbor Back4App, pergi ke Pengaturan Aplikasi > Email.
Aktifkan verifikasi email dan atur template yang diinginkan.
Aktifkan reset kata sandi sehingga pengguna dapat memulihkan akun.
Implementasi
Setelah diaktifkan, pendaftaran pengguna memicu email verifikasi. Anda juga dapat meminta pengaturan ulang kata sandi menggunakan:
Bash
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}' \
  https://parseapi.back4app.com/requestPasswordReset
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"alice@example.com"}' \
  https://parseapi.back4app.com/requestPasswordReset
﻿
Langkah 8 – Penjadwalan Tugas dengan Cloud Jobs
Apa yang Dilakukan Cloud Jobs
Cloud Jobs memungkinkan Anda mengotomatiskan tugas seperti menghapus data lama atau mengirim email secara berkala. Anda dapat menulisnya di main.js dan menjadwalkannya di dasbor Back4App.
Contoh
JS
// main.js
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
// main.js
Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
﻿
Terapkan kode ini ke Back4App.
Jadwalkan pekerjaan di Dasbor di bawah Pengaturan Aplikasi > Pengaturan Server > Pekerjaan Latar Belakang.
Jadwal Pekerjaan Cloud
﻿
Langkah 9 – Mengintegrasikan Webhook
Definisi
Webhook memungkinkan Anda mengirim permintaan HTTP ke layanan lain ketika peristiwa terjadi, seperti pembuatan catatan baru di kelas Back4App Anda. Ini berguna untuk integrasi eksternal, termasuk platform pembayaran, alat pemasaran email, atau notifikasi Slack.
Konfigurasi
Buka panel Webhook di dasbor Back4App Anda > Lainnya > WebHooks.
Tambahkan Webhook baru dengan URL endpoint tempat Anda ingin mengirim data peristiwa.
Pilih pemicu (misalnya, pembuatan objek, pembaruan, atau penghapusan).
Menambahkan Webhook
﻿
Anda juga dapat mendefinisikan webhook dalam Cloud Code pemicu, membuat permintaan HTTP dengan modul Node.js seperti axios.
BeforeSave WebHook
﻿
Langkah 10 – Menjelajahi Panel Admin Back4App
Aplikasi Back4App Admin App adalah antarmuka yang berfokus pada model yang memungkinkan pengguna non-teknis atau administrator untuk mengelola data tanpa menulis kode. Ini menawarkan pengalaman penanganan data yang lebih intuitif dibandingkan dengan Dasbor Parse standar.
Di Mana Menemukannya
Aktifkan Aplikasi Admin dengan pergi ke Dasbor Aplikasi > Lainnya > Aplikasi Admin.
Klik “Aktifkan Aplikasi Admin” dan konfigurasikan kredensial admin Anda.
Pilih subdomain untuk mengakses Aplikasi Admin.
Aktifkan Aplikasi Admin
﻿
﻿
Masuk dengan kredensial admin yang baru Anda buat untuk mulai mengelola catatan database, akun pengguna, peran, dan lainnya.
﻿
Kesimpulan
Dalam tutorial ini, Anda belajar bagaimana membangun backend sisi server untuk aplikasi web PHP Anda menggunakan Back4App. Anda mengatur database yang aman, memanfaatkan fitur real-time, mendefinisikan logika kustom dalam Cloud Code, dan menjelajahi otentikasi pengguna, penyimpanan file, dan pekerjaan terjadwal. Anda juga melihat bagaimana webhook dan Panel Admin dapat terintegrasi dengan layanan eksternal dan menyederhanakan manajemen data.
Dengan fondasi ini, Anda memiliki backend yang fleksibel dan dapat diskalakan yang dapat Anda kembangkan sesuai kebutuhan untuk proyek PHP Anda berikutnya. Teruslah menjelajahi teknik-teknik lanjutan, peran kustom, atau API pihak ketiga untuk membuat aplikasi Anda semakin kuat dan dinamis.
Langkah Selanjutnya
Perbaiki aplikasi PHP siap produksi Anda dengan menambahkan caching, load balancing, atau keamanan lanjutan.
Tambahkan kontrol akses berbasis peran atau alur otentikasi unik, jika basis pengguna Anda membutuhkannya.
Konsultasikan dokumen resmi Back4App untuk mempelajari lebih lanjut tentang penyetelan kinerja, log, dan analitik.
Cobalah tutorial tambahan dan gunakan teknik yang dipelajari di sini untuk membangun solusi dunia nyata, dari e-commerce hingga platform sosial.
﻿
Diperbarui 24 Jan 2025
Apakah halaman ini membantu Anda?
SEBELUMNYA
Cara Membangun Backend untuk Dart?
BERIKUTNYA
Cara Membangun Backend untuk Xamarin?