PHP - Standar Pemrograman

Hai, para pengembang PHP masa depan! Saya sangat senang untuk memandu Anda melalui dunia menarik standar pemrograman PHP. Sebagai seseorang yang telah mengajar pemrograman selama tahun tahun, saya dapat menjamin bahwa menguasai standar ini akan membuat kode Anda lebih bersih, mudah dibaca, dan lebih profesional. Mari kita mulai!

Indentasi dan Panjang Baris

Indentasi yang benar seperti perilaku yang baik dalam pemrograman - itu membuat segala sesuatu lebih menyenangkan dan mudah dipahami. Dalam PHP, kita biasanya menggunakan 4 spasi untuk setiap tingkat indentasi. Ini contohnya:

<?php
if ($condition) {
echo "This line is indented";
if ($another_condition) {
echo "This line is indented even more";
}
}

Dalam contoh ini, pernyataan pertama echo diindentasi sekali (4 spasi), dan pernyataan kedua echo diindentasi dua kali (8 spasi). Hierarki visual ini membantu kita memahami struktur kode dengan cepat.

Untuk panjang baris, cobalah untuk menjaga baris Anda di bawah 80 karakter. Jika sebuah baris menjadi terlalu panjang, pisahkanlahnya menjadi beberapa baris seperti ini:

$very_long_variable_name = $another_long_variable_name
+ $yet_another_long_variable_name
+ $one_more_long_variable_name;

Struktur Kontrol

Struktur kontrol adalah blok pembangun logika program Anda. Dalam PHP, yang paling umum adalah if, else, elseif, while, for, dan switch. Berikut cara memformat mereka dengan benar:

if ($condition1) {
// kode di sini
} elseif ($condition2) {
// kode lebih lanjut di sini
} else {
// kode yang masih lebih lanjut di sini
}

while ($condition) {
// kode yang akan diulang
}

for ($i = 0; $i < 10; $i++) {
// kode yang akan diulang
}

switch ($variable) {
case 1:
// kode untuk kasus 1
break;
case 2:
// kode untuk kasus 2
break;
default:
// kode default
break;
}

Perhatikan bagaimana setiap blok kode dikelilingi oleh kurung kurawal {} dan diindentasi dengan benar.

Pemanggilan Fungsi

Ketika memanggil fungsi, tidak ada ruang antara nama fungsi dan kurung buka. Berikut cara yang benar:

$result = myFunction($arg1, $arg2);

Jika pemanggilan fungsi terlalu panjang, Anda dapat memisahkannya menjadi beberapa baris:

$result = myVeryLongFunctionName(
$arg1,
$arg2,
$arg3,
$arg4
);

Definisi Fungsi

Ketika mendefinisikan fungsi, ikuti format ini:

function myFunction($arg1, $arg2 = null)
{
// tubuh fungsi
}

Catatan bahwa kurung buka { berada di baris baru. Ini disebut "style Allman" dan umum digunakan dalam PHP.

Komentar

Komentar sangat penting untuk menjelaskan kode Anda. Gunakan mereka dengan berlebihan! Berikut jenis komentar dalam PHP:

// Ini adalah komentar baris tunggal

/*
Ini adalah komentar multi-baris.
Itu bisa menyebar ke beberapa baris.
*/

/**
* Ini adalah komentar DocBlock.
* Itu digunakan untuk mendokumentasikan fungsi, kelas, dll.
*
* @param string $arg1 Deskripsi argumen pertama
* @return bool Deskripsi apa yang dikembalikan fungsi
*/
function myDocumentedFunction($arg1)
{
// tubuh fungsi
}

Tag Kode PHP

Ketika menulis kode PHP, selalu gunakan tag PHP penuh:

<?php
// Kode PHP Anda di sini
?>

Hindari penggunaan tag pendek seperti <? karena mereka tidak selalu diaktifkan di semua server.

Nama Variabel

Nama variabel harus deskriptif dan gunakan huruf kecil dengan garis bawah (snake_case):

$user_name = "John";
$total_items = 5;

Untuk konstanta, gunakan huruf besar dengan garis bawah:

define('MAX_USERS', 100);

Buat Fungsi Reentrant

Fungsi reentrant adalah fungsi yang dapat diinterupsi di tengah eksekusinya dan kemudian dipanggil lagi secara aman. Untuk mencapai ini, hindari penggunaan variabel global atau variabel statis dalam fungsi Anda. Ini contohnya:

// Tidak reentrant
function badCounter()
{
static $count = 0;
return ++$count;
}

// Reentrant
function goodCounter($count)
{
return ++$count;
}

Perataan Blok Deklarasi

Ketika mendeklarasikan banyak variabel, peratakan mereka untuk keadaan yang lebih mudah dibaca:

$short        = 1;
$long_variable = 2;
$longer_variable = 3;

Satu Pernyataan Per Baris

Untuk kejelasan, letakkan hanya satu pernyataan per baris:

$a = 1;
$b = 2;
$c = 3;

Hindari:

$a = 1; $b = 2; $c = 3; // Ini lebih sulit dibaca

Metode atau Fungsi Pendek

Jaga agar fungsi Anda pendek dan fokus pada tugas tunggal. Sebagai aturan jari, jika sebuah fungsi lebih panjang dari 20-30 baris, pertimbangkan untuk memecahnya menjadi fungsi yang lebih kecil.

Berikut adalah tabel yang menggabungkan beberapa standar pemrograman PHP yang telah kita diskusikan:

Standar	Contoh
Indentasi	Gunakan 4 spasi
Panjang Baris	Jaga di bawah 80 karakter
Pemanggilan Fungsi	myFunction($arg1, $arg2);
Definisi Fungsi	function myFunction($arg1, $arg2) { ... }
Nama Variabel	Gunakan snake_case: $user_name
Konstanta	Gunakan UPPER_CASE: MAX_USERS
Komentar	Gunakan //, /* */, atau /** */
Tag PHP	Selalu gunakan <?php ?>

Ingat, standar ini bukan hanya aturan sembarang. Mereka adalah praktek terbaik yang dikembangkan selama tahun oleh komunitas PHP untuk membuat kode lebih mudah dibaca dan maintainable. Dengan mengikuti standar ini, Anda tidak hanya menulis kode - Anda sedang berkomunikasi dengan pengembang lain yang mungkin bekerja pada kode Anda di masa depan. Dan siapa tahu? Pengembang masa depan itu mungkin Anda sendiri!

Saat kita menyempurnakan, saya teringat tentang seorang murid yang pernah berkata kepadaku, "Belajar standar pemrograman adalah seperti belajar perilaku makan. Terlihat fussy pada awalnya, tapi setelah Anda惯udah terbiasa, Anda bertanya-tanya bagaimana Anda pernah hidup tanpanya!" Jadi, teruslatih standar ini, dan segera mereka akan menjadi kebiasaan. Selamat pemrograman!

Credits: Image by storyset