Mengenal File .editorconfig di Dalam Laravel

Halo teman-teman, pada materi kali ini kita akan membahas satu file kecil yang sering terlihat sepele, tapi dampaknya besar sekali terhadap kerapian kode, yaitu file .editorconfig.

Biasanya file ini sudah otomatis ada ketika kita membuat project Laravel baru. Namun, tidak sedikit developer yang membiarkannya begitu saja tanpa benar-benar memahami fungsinya. Padahal, file ini sangat membantu, terutama ketika kita bekerja dalam tim atau berpindah-pindah editor.

Apa Itu File .editorconfig?

Secara sederhana, .editorconfig adalah file konfigurasi standar untuk mengatur gaya penulisan kode (code style) di berbagai editor dan IDE.

Dengan kata lain:

File ini membantu agar kode kita tetap rapi dan konsisten, meskipun ditulis oleh banyak orang dan menggunakan editor yang berbeda-beda.

Editor seperti:

• VS Code
• PhpStorm
• Sublime Text
• Notepad++

semuanya bisa membaca aturan dari .editorconfig.

Kenapa .editorconfig Penting di Laravel?

Laravel sendiri sangat menjunjung tinggi konsistensi dan keterbacaan kode. Bayangkan kalau dalam satu project:

• ada file pakai tab
• ada file pakai spasi
• indentasi beda-beda
• baris baru tidak konsisten

Hasilnya? Kode tetap jalan, tapi pusing dibaca dan sulit dirawat.

Nah, di sinilah .editorconfig berperan sebagai “penjaga kerapian”.

Contoh Isi File .editorconfig di Laravel

Mari kita lihat contoh default .editorconfig pada project Laravel:

root = true

[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true

[*.{php,js,css,vue}]
indent_style = space
indent_size = 4

[*.md]
trim_trailing_whitespace = false

Sekarang kita bahas satu per satu, pelan-pelan.

Penjelasan Setiap Bagian

1. root = true

root = true

Artinya:

File ini adalah konfigurasi utama, editor tidak perlu mencari .editorconfig di folder atasnya.

Ini penting agar aturan tidak saling tumpang tindih.

2. Aturan Global [*]

[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true

Aturan ini berlaku untuk semua file.

Penjelasannya:

• charset = utf-8 → encoding standar
• end_of_line = lf → baris baru pakai LF (standar Linux & server)
• insert_final_newline = true → file selalu diakhiri baris kosong
• trim_trailing_whitespace = true → hapus spasi kosong di akhir baris

Ini membantu menghindari noise saat Git diff.

3. Aturan Khusus File Kode

[*.{php,js,css,vue}]
indent_style = space
indent_size = 4

Artinya:

• Gunakan spasi, bukan tab
• Jumlah spasi = 4

Ini sangat selaras dengan standar penulisan kode Laravel dan PHP secara umum.

4. Aturan Khusus File Markdown

[*.md]
trim_trailing_whitespace = false

Kenapa markdown beda?

Karena di Markdown:

• spasi di akhir baris bisa berpengaruh pada tampilan
• misalnya untuk line break

Maka trailing whitespace tidak dihapus otomatis.

.editorconfig vs Formatter (Prettier, Pint, dll)

Pertanyaan yang sering muncul:

“Kalau sudah pakai formatter, apakah .editorconfig masih perlu?”

Jawabannya: tetap perlu.

• .editorconfig → aturan dasar editor
• Formatter (Laravel Pint, Prettier, ESLint) → aturan detail formatting

Mereka saling melengkapi, bukan saling menggantikan.

Peran .editorconfig dalam Kerja Tim

Dalam tim, file ini sangat krusial:

• Menghindari perdebatan soal tab vs spasi
• Mengurangi konflik saat merge
• Kode terlihat seragam meski ditulis banyak orang
• Developer baru langsung mengikuti standar tanpa setting manual

Dengan kata lain:

.editorconfig adalah kesepakatan diam-diam dalam tim.

Kesalahan Umum yang Sering Terjadi

Beberapa hal yang sering saya temui:

1. Menghapus .editorconfig karena dianggap tidak penting
2. Tidak menyamakan indent dengan standar project
3. Mengandalkan setting editor masing-masing
4. Tidak commit .editorconfig ke repository

Padahal file ini wajib di-commit.

Kesimpulan

Sebagai penutup, teman-teman perlu ingat:

• .editorconfig menjaga konsistensi kode
• Berlaku lintas editor dan IDE
• Sangat membantu kerja tim
• Kecil ukurannya, besar manfaatnya

Kalau kita serius membangun aplikasi Laravel yang rapi, profesional, dan mudah dirawat, maka .editorconfig bukan sekadar pelengkap—tapi fondasi awal.