Jangan Pernah Lagi Mencampur Kode PHP di Client Script atau Startup Script pada PHPMaker 2021

Pada PHPMaker versi 2020 dan versi-versi major sebelumnya, kita dapat mencampur kode PHP di bagian Client Script dan/atau Startup Script. Sayangnya, sejak PHPMaker versi 2021, hal itu sudah tidak bisa lagi. Kita tidak dapat menulis kode PHP di antara kode Javascript/jQuery pada kedua bagian tadi.

Tentu timbul pertanyaan, mengapa? Jawabannya, karena kode yang di-generate oleh PHPMaker pada bagian Client Script dan Startup Script tadi, akan ditempatkan ke dalam file .js (Javascript). Itu artinya, kode di dalam file .js tidak boleh mengandung kode PHP.

O iya. Sekedar mengingatkan saja. Kedua bagian Client Script dan Startup Script tersebut dikenal dengan istilah Client Scripts (dengan akhiran huruf s) di dalam project PHPMaker, yaitu area yang disediakan bagi Web Developer untuk menulis kode Javascript/jQuery, agar kode tersebut nantinya dieksekusi di sisi client (browser) dari Aplikasi Web yang dibangkitkan oleh PHPMaker.

Istilah Client Scripts di dalam project PHPMaker meliputi 2 bagian tadi, yaitu Client Script (tanpa akhiran huruf s), dan Startup Script.

Jadi, jika Anda melihat istilah Client Scripts (dengan akhiran huruf s) dalam PHPMaker, jangan bingung lagi ya, karena istilah itu mengacu kepada 2 bagian tadi, yaitu Client Script (tanpa akhiran huruf s) dan Startup Script.

Kembali ke topik semula.

Jika kita sudah tidak bisa lagi mencampur kode PHP dengan kode Javascript/jQuery di bagian Client Scripts, maka pertanyaan selanjutnya adalah, bagaimana jika kita ingin menambahkan business-logic yang biasanya kita tulis dengan kode PHP? Hehe, pertanyaan bagus dan cerdas!

Jawabannya: tidak perlu khawatir! Seperti biasa, tetap tenang, stay cool, dan jangan panik, hehehe…

Di PHPMaker 2021, sudah tersedia sebuah fungsi PHP global yang bernama SetClientVar. Sesuai namanya, fungsi ini untuk mengeset variable dari sisi server ke sisi client. Ada dua parameter di dalam fungsi tersebut. Parameter pertama adalah nama variabel di sisi client, sedangkan parameter kedua adalah nilai atau variable di sisi server, yang akan kita kirim ke sisi client.

Untuk menggunakan fungsi global itu, PHPMaker pun sudah menyediakan server event khusus yang bernama Page_Rendering yang berada di bawah lokasi berikut: Server Events -> Global -> All Pages.

Contoh, kita ingin mengirim nilai current user id ke sisi client, maka cukup dengan menulis kode berikut pada server Page_Rendering tersebut:

	// pass variables from server-side to to client-side:
	SetClientVar("curUserId", CurrentUserID());

Dalam contoh kode ini, nama variable di sisi client adalah curUserId, dan karena tipenya String, maka harus diapit dengan karakter petik ganda. Variabel curUserId tersebut artinya akan diisi dengan nilai dari fungsi global PHP bawaan PHPMaker yang bernama CurrentUserID().

Selanjutnya, untuk menangkap nilai dari variable di sisi client, kita bisa menulis kode Javascript pada area Client Scripts dari project PHPMaker. Uniknya, PHPMaker sudah menyediakan sebuah variable global dalam bentuk object variable, untuk menampung semua variable yang diset dari sisi server tadi, yaitu ew.vars.

Scope dari object variable ini adalah global. Itu artinya, kita bisa membaca nilai variable tadi dari bagian manapun di dalam project PHPMaker.

Dalam contoh di atas, maka kita cukup menulis kode Javascript berikut dari bagian Client Scripts project PHPMaker:

	// get variable from server-side in client-side:
	var curUserId = ew.vars.curUserId;

Dalam kode ini, kita mendeklarasikan variable Javascript yang bernama curUserId, yang nilainya kita tampung dari object variable ew.vars.curUserId.

Sangat mudah, bukan?

Meskipun sekarang kita sudah tidak bisa lagi menggunakan atau mencampur kode PHP ke dalam kode Javascript/jQuery di sisi client, kita masih tetap dapat menghubungkan sisi server dan sisi client dengan menggunakan fungsi global SetClientVar.

PHPMaker memang tiada duanya, hehehe… 🙂