Pelajari pemeriksaan sintaks PHP melalui terminal: siapkan berkas latihan, baca kesalahan parser, perbaiki kode, dan pahami batas pemeriksaan sebelum unggah.
Mengapa memeriksa berkas sebelum unggah
Perubahan kecil pada berkas PHP dapat menghentikan pekerjaan yang sebenarnya sederhana, misalnya memperbarui label pada katalog usaha. Sebelum berkas dikirim ke hosting, pemilik website dapat menambahkan satu pemeriksaan lokal yang mudah diulang: memeriksa apakah penulisan kode diterima parser PHP. Kebiasaan ini membantu menemukan kekeliruan saat berkas masih berada di komputer sendiri, sehingga perbaikannya tidak perlu menunggu keluhan pengunjung atau percobaan langsung pada halaman layanan yang sedang dipakai pelanggan.
Tutorial ini memakai berkas latihan terpisah dan satu perintah untuk setiap berkas. Manual PHP menjelaskan bahwa opsi -l melakukan pemeriksaan sintaks tanpa mengeksekusi kode PHP yang diberikan. Hasil yang bersih hanya menjawab pertanyaan tentang sintaks. Rencana kerja berikut menggabungkan pemeriksaan tersebut dengan pencatatan versi, nama berkas, dan hasil perbaikan agar pemeriksaan dapat ditelusuri. Contohnya bersifat lokal dan tidak memerlukan akun hosting, kata sandi database, maupun perubahan pada website produksi.

Prasyarat: terminal, editor, dan PHP CLI
Siapkan PHP CLI yang sudah tersedia pada komputer kerja, terminal, serta editor teks biasa. Contoh perintah menggunakan PowerShell di Windows dan berkas yang disimpan dalam satu folder latihan milik Anda. Bila perintah php belum dikenali, hentikan latihan dan siapkan lingkungan PHP melalui panduan pemasangan yang sesuai sistem Anda. Jangan menganggap komputer yang dapat membuka website PHP otomatis memiliki program PHP pada terminal; keduanya merupakan lingkungan kerja yang berbeda.
Ketahui pula versi PHP yang digunakan aplikasi tujuan melalui informasi pengelolaan hosting atau tim pengembang. Catat versi tersebut sebagai pembanding, tanpa menyalin informasi akun ke dalam catatan publik. Hindari mengubah versi PHP website hanya untuk mengikuti latihan. Pemeriksaan sebaiknya memakai versi yang sesuai dengan aplikasi tujuan, sebab pemeriksaan pada komputer sendiri harus relevan dengan kode yang nantinya digunakan. Gunakan salinan kerja berkas, terutama jika Anda belum terbiasa membedakan kode latihan dengan kode aplikasi sebenarnya.

Langkah 1: kenali program yang dipakai terminal
Buka terminal dari folder latihan, kemudian jalankan php -v. Perintah ini meminta informasi versi PHP yang ditemukan terminal. Catat versi dan pastikan yang Anda panggil adalah lingkungan CLI yang dimaksud. Jika beberapa instalasi tersedia, koordinasikan pemilihan program dengan pengembang agar hasil pemeriksaan tidak berpindah lingkungan tanpa disadari. Jangan melanjutkan berdasarkan dugaan ketika terminal menunjukkan versi berbeda dari lingkungan aplikasi yang hendak diperiksa; selesaikan perbedaan tersebut terlebih dahulu.
Buat catatan sederhana dengan kolom nama berkas, versi PHP, waktu pemeriksaan, dan hasil. Catatan tidak perlu berisi seluruh pengaturan komputer. Tujuannya adalah memastikan orang lain memahami apa yang sudah diperiksa ketika menerima berkas. Misalnya, tulisan “lolos sintaks pada berkas latihan-valid.php” lebih berguna daripada “website aman”. Rumusan pertama mempunyai ruang lingkup yang dapat diuji ulang, sedangkan rumusan kedua mencampurkan banyak aspek yang belum disentuh oleh perintah ini.
Langkah 2: buat berkas valid yang mudah dikenali
Simpan berkas bernama latihan-valid.php dalam folder latihan. Ketik tiga baris berikut menggunakan editor teks: baris pertama <?php, baris kedua $label = 'Katalog';, dan baris ketiga echo $label;. Setiap potongan tersebut berada pada barisnya sendiri. Pastikan editor menyimpan nama berkas dengan akhiran .php, bukan menambahkan .txt secara diam-diam. Simpan perubahan sebelum berpindah ke terminal agar pemeriksaan membaca isi terbaru pada penyimpanan, bukan isi lama sebelum suntingan.
Contoh ini sengaja tidak memakai penutup tag PHP karena seluruh berkas berisi kode PHP. Manual pemisahan instruksi menjelaskan penggunaan titik koma sebagai pemisah pernyataan serta pengecualian pada penutup tag. Dalam latihan ini, pernyataan penugasan dan echo sama-sama ditutup titik koma agar perbaikannya mudah terlihat. Jangan menambah formulir, koneksi database, atau pemanggilan layanan luar; semakin kecil contoh awal, semakin mudah menghubungkan pesan parser dengan bagian kode yang Anda tulis.
Langkah 3: periksa satu berkas tanpa menjalankan aplikasinya
Dari folder yang sama, jalankan php -l '.\latihan-valid.php'. Perhatikan keberadaan huruf l kecil setelah tanda minus. Menurut manual, keluaran keberhasilan memuat No syntax errors detected in lalu nama berkas. Itu merupakan hasil yang diharapkan untuk contoh valid, bukan laporan pengujian aplikasi. Terminal seharusnya tidak mencetak Katalog sebagai keluaran echo dari berkas tersebut, karena mode pemeriksaan ini tidak mengeksekusi kode PHP yang sedang diperiksa.
Jika terminal tidak menemukan berkas, periksa lokasi kerja dan ejaan nama berkas sebelum menyunting isi PHP. Kesalahan lokasi tidak memberikan bukti bahwa sintaksnya rusak. Bila nama folder mengandung spasi, pertahankan tanda kutip pada argumen jalur. Pakai satu nama berkas per pemanggilan agar jelas berkas mana yang menjadi objek pemeriksaan. Setelah memperoleh hasil yang sesuai, catat nama berkas persis seperti yang diperiksa dan simpan salinan latihannya untuk pembanding pada langkah berikut.
Langkah 4: buat kesalahan terkontrol dan baca petunjuknya
Buat salinan bernama latihan-rusak.php. Isinya tetap tiga baris seperti sebelumnya, tetapi hapus titik koma setelah 'Katalog' pada baris penugasan dan biarkan baris echo $label; berada sesudahnya. Simpan, lalu jalankan php -l '.\latihan-rusak.php'. Hasil yang diharapkan adalah pemeriksaan gagal dengan pesan parser dan keterangan Errors parsing beserta nama berkas. Susunan kalimat kesalahan dapat berbeda, sehingga jangan mencari kecocokan seluruh pesan secara harfiah untuk menentukan apakah latihan berhasil.
Baca lokasi yang disebutkan parser, kemudian lihat pula pernyataan sebelumnya. Tempat parser menyadari masalah belum tentu sama dengan tempat karakter yang hilang seharusnya berada. Pada contoh ini, perbaikan yang dicari adalah titik koma setelah penugasan label. Latihan dengan kesalahan yang diketahui membantu membangun kebiasaan membaca pesan secara berurutan: identifikasi berkas, lihat lokasi, lalu cocokkan konteks. Hindari mengganti banyak baris sekaligus, karena tindakan itu mengaburkan perubahan mana yang sebenarnya menyelesaikan masalah.
Langkah 5: perbaiki dan lakukan verifikasi ulang
Kembalikan titik koma pada penugasan di latihan-rusak.php, simpan, kemudian ulangi perintah lint terhadap berkas yang sama. Hasil yang diharapkan sekarang berpindah dari kesalahan parser menjadi keterangan tidak ditemukan kesalahan sintaks. Bandingkan nama berkas pada hasil dengan nama yang Anda sunting. Bila hasil tidak berubah, pastikan editor telah menyimpan perubahan dan terminal tidak memeriksa salinan lain. Catat tindakan perbaikan secara singkat, misalnya “menambahkan pemisah setelah penugasan label”.
Gunakan pasangan latihan valid dan rusak sebagai pemeriksaan pemahaman. Anda sudah mempunyai satu kondisi yang diperkirakan diterima, satu kondisi yang diperkirakan ditolak, dan satu perbaikan yang dapat diuji kembali. Untuk berkas aplikasi sungguhan, ulangi pemeriksaan pada setiap berkas yang berubah sesuai daftar perubahan proyek. Jangan menyimpulkan semua berkas dalam folder telah diperiksa hanya karena satu berkas menghasilkan pesan keberhasilan. Pisahkan pekerjaan pemeriksaan lokal ini dari keputusan mengunggah atau merilis aplikasi.
Langkah 6: pahami kasus yang masih memerlukan pengujian lain
Buat contoh tambahan hanya bila Anda ingin memahami batas pemeriksaan: sebuah berkas PHP berisi pembuka <?php dan pernyataan fungsi_latihan_belum_ada();. Secara bentuk, pemanggilan tersebut dapat diterima parser walaupun fungsi itu tidak disediakan. Cukup periksa dengan -l; tidak perlu mengeksekusinya. Manual PHP menyatakan pemeriksaan sintaks tidak menangkap kesalahan yang memerlukan eksekusi, termasuk fungsi yang tidak didefinisikan. Contoh ini membantu menjelaskan mengapa hasil lint bersih tidak boleh dipakai sebagai persetujuan rilis tunggal.
Setelah sintaks diterima, tim tetap perlu menguji perilaku aplikasi pada lingkungan uji yang sesuai: apakah halaman terbuka, masukan diproses benar, dan perubahan tampilan memenuhi kebutuhan. Buat daftar pemeriksaan berdasarkan fitur yang diubah, bukan daftar generik yang tidak berkaitan. Jika perubahan hanya menyentuh label katalog, periksa halaman katalog dan konteks tampilannya. Jika perubahan menyentuh perhitungan, libatkan kasus perhitungan yang disepakati pengembang. Hasil dari tahap berbeda ini sebaiknya dicatat terpisah agar batas bukti tetap jelas.
Kesalahan umum saat menggunakan pemeriksaan sintaks
Kesalahan pertama adalah lupa menulis -l sehingga perintah berubah menjadi cara menjalankan berkas. Periksa kembali perintah sebelum menekan Enter, terutama saat berpindah dari tutorial lain. Kesalahan berikutnya adalah memeriksa salinan yang sudah tertinggal, menggunakan versi PHP yang berbeda tanpa mencatatnya, atau memperbaiki baris yang disebut pesan tanpa melihat baris sebelumnya. Biasakan menyimpan perubahan, mencocokkan jalur, dan membaca konteks berurutan. Kebiasaan sederhana itu lebih berguna daripada mengulang perintah yang sama tanpa mengubah penyebabnya.
Kesalahan lain adalah menyatakan sebuah website siap digunakan berdasarkan lint saja. Simpan istilah “lolos pemeriksaan sintaks” untuk bukti yang memang tersedia, kemudian lanjutkan pengujian fitur sesuai kebutuhan. Untuk mengenali layanan yang berkaitan dengan penempatan aplikasi, Anda dapat membaca halaman hosting cPanel JagoWeb di https://www.jagoweb.com/hosting-cpanel dan daftar layanan pada https://www.jagoweb.com/. Kesesuaian versi serta kebutuhan aplikasi tetap perlu dicocokkan dengan layanan yang dipilih; tutorial lokal ini tidak mengasumsikan semua paket memiliki konfigurasi yang sama.



