Overview
Masalah yang diselesaikan. Tanpa aturan Git yang jelas, tim Laravel cepat berantakan: commit bernama "fix" atau "update", semua orang langsung mendorong ke main, konflik merge menumpuk, .env atau kunci API tak sengaja ter-commit, dan tidak ada yang tahu perubahan mana yang merusak production.
Hasil akhir:
Repository Laravel yang bersih (
.gitignore,.gitattributes,.env.example).Alur kerja GitHub Flow yang sederhana: cabang fitur, pull request, review, merge.
Konvensi nama cabang dan pesan commit.
Proteksi cabang
maindan CI otomatis (gaya kode dan test).Cara menangani konflik, membatalkan perubahan, dan rahasia yang terlanjur ter-commit.
Prerequisites
Komponen | Kebutuhan |
|---|---|
Git | 2.40 atau lebih baru |
Akun GitHub | Gratis sudah cukup |
PHP / Laravel | 8.3+ dan Laravel 12.x atau 13.x |
Composer / Node.js | Terpasang (untuk skrip CI) |
Terminal | PowerShell, Git Bash, atau terminal Laragon |
git --version
Step-by-Step Tutorial
1. Konfigurasi Awal Git
git config --global user.name "Nama Anda"
git config --global user.email "email@contoh.com"
git config --global init.defaultBranch main
git config --global pull.rebase false
git config --global core.autocrlf input
git config --global --list
Catatan tentang akhir baris di Windows: skeleton Laravel sudah menyertakan .gitattributes dengan * text=auto eol=lf, sehingga berkas disimpan dengan LF di repository. Jika editor Anda memaksa CRLF, atur editor agar memakai LF untuk proyek ini, atau gunakan .editorconfig (juga bawaan Laravel).
2. Autentikasi ke GitHub dengan SSH
ssh-keygen -t ed25519 -C "email@contoh.com"
Tekan Enter untuk lokasi bawaan, dan isi passphrase. Salin kunci publik:
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard
Di GitHub: Settings > SSH and GPG keys > New SSH key, lalu tempel. Uji:
ssh -T git@github.com
Hi username! You've successfully authenticated, but GitHub does not provide shell access.
Jangan pernah membagikan berkas id_ed25519 (kunci privat).
3. Siapkan Repository Laravel yang Bersih
Skeleton Laravel sudah membawa .gitignore yang baik. Pastikan memuat setidaknya:
/vendor
/node_modules
/public/build
/public/hot
/public/storage
/storage/*.key
/storage/pail
.env
.env.backup
.env.production
.phpunit.result.cache
Homestead.json
Homestead.yaml
auth.json
npm-debug.log
yarn-error.log
/.idea
/.vscode
Dan pastikan .env.example ada, lengkap, dan tanpa rahasia:
APP_NAME=Laravel
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=
Inisialisasi dan commit pertama:
cd C:\laragon\www\toko
git init
git add .
git status
Periksa daftar git status. Pastikan tidak ada .env, vendor/, atau node_modules/ di dalamnya.
git commit -m "chore: inisialisasi proyek Laravel"
4. Hubungkan ke GitHub
Buat repository kosong di GitHub (tanpa README), lalu:
git remote add origin git@github.com:username/toko.git
git branch -M main
git push -u origin main
Pilih repository Private untuk proyek komersial atau yang berisi kode klien.
5. Strategi Percabangan: GitHub Flow
Untuk sebagian besar tim kecil dan menengah, GitHub Flow sudah cukup:
main ───●───────────●──────────────●───────► selalu siap di-deploy
\ / \ /
feature/ ●──●──●─┘ ●──●──────┘ satu cabang per pekerjaan
login fix/stok-minus
Aturan:
mainselalu dalam kondisi stabil dan dapat di-deploy.Setiap pekerjaan dibuat di cabang terpisah dari
main.Commit kecil dan sering di cabang itu.
Buka Pull Request (PR) saat siap ditinjau.
Setelah disetujui dan CI lulus, merge ke
main, lalu hapus cabangnya.
Penamaan cabang:
Awalan | Untuk | Contoh |
|---|---|---|
| Fitur baru |
|
| Perbaikan bug |
|
| Perbaikan darurat production |
|
| Pemeliharaan, dependensi |
|
| Dokumentasi |
|
| Merapikan tanpa mengubah perilaku |
|
Untuk tim besar dengan rilis terjadwal, ada alternatif seperti Git Flow (cabang develop dan release/*) atau trunk-based development. Mulai dari GitHub Flow, dan tambah kerumitan hanya bila ada kebutuhan nyata.
6. Alur Harian dari Awal sampai Selesai
# 1. mulai dari main yang terbaru
git checkout main
git pull origin main
# 2. buat cabang kerja
git checkout -b feature/filter-produk
# 3. kerjakan, cek, lalu commit bertahap
git status
git add app/Services/ProductService.php app/Http/Controllers/ProductController.php
git commit -m "feat(produk): tambah filter berdasarkan kategori"
git add tests/Feature/ProductFilterTest.php
git commit -m "test(produk): uji filter kategori"
# 4. dorong cabang
git push -u origin feature/filter-produk
# 5. buka Pull Request di GitHub, minta review
Memeriksa sebelum commit:
git status
git diff # perubahan belum di-stage
git diff --staged # perubahan yang akan di-commit
vendor\bin\pint --test # cek gaya kode
php artisan test
7. Pesan Commit yang Baik
Gunakan format Conventional Commits agar riwayat mudah dibaca:
<tipe>(<ruang-lingkup>): <ringkasan singkat, kalimat perintah>
[badan opsional: apa dan mengapa, bukan bagaimana]
[footer opsional: Closes #42]
Tipe | Arti |
|---|---|
| Fitur baru |
| Perbaikan bug |
| Dokumentasi |
| Format kode (tanpa perubahan logika) |
| Merapikan kode |
| Menambah/memperbaiki test |
| Pemeliharaan, dependensi, konfigurasi |
| Peningkatan performa |
Contoh baik dan buruk:
BURUK fix
BURUK update
BURUK perbaikan banyak hal
BAIK fix(stok): cegah stok bernilai negatif saat checkout bersamaan
BAIK feat(preorder): tambah pengingat pelunasan otomatis
BAIK chore(deps): perbarui spatie/laravel-permission ke 6.x
Contoh dengan badan:
fix(stok): cegah stok negatif saat checkout bersamaan
Dua request bersamaan bisa lolos pengecekan stok. Pengurangan stok kini
dilakukan dalam transaksi dengan lockForUpdate.
Closes #42
Aturan praktis: satu commit mewakili satu perubahan logis, dan proyek harus tetap berjalan di setiap commit.
8. Pull Request dan Code Review
Buat templat PR di .github/pull_request_template.md:
## Ringkasan
<!-- Apa yang berubah dan mengapa -->
## Jenis perubahan
- ☐ Fitur baru
- ☐ Perbaikan bug
- ☐ Refactor
- ☐ Dokumentasi / chore
## Cara menguji
1. ...
2. ...
## Checklist
- ☐ Test ditambahkan/diperbarui dan lulus (`php artisan test`)
- ☐ Gaya kode lulus (`vendor/bin/pint --test`)
- ☐ Migrasi bersifat kompatibel mundur
- ☐ `.env.example` diperbarui bila ada variabel baru
- ☐ Tidak ada rahasia atau data pelanggan di commit
- ☐ Dokumentasi/README diperbarui bila perlu
Terkait: #nomor-issue
Panduan review:
Pemeriksa | Fokus |
|---|---|
Penulis PR | PR kecil (idealnya < 400 baris), deskripsi jelas, tinjau diri sendiri dulu |
Reviewer | Kebenaran logika, keamanan (validasi, otorisasi), N+1, test, keterbacaan |
Sikap | Kritik kodenya, bukan orangnya. Beri alasan dan saran |
Untuk perubahan skema atau migrasi, minta reviewer memeriksa urutan migrasi dan apakah aman dijalankan pada data production.
9. Menjaga Cabang Tetap Mutakhir
Jika main sudah berubah saat Anda mengerjakan fitur:
git fetch origin
git checkout feature/filter-produk
git merge origin/main
Atau dengan rebase untuk riwayat yang lebih lurus (hanya pada cabang yang belum dipakai orang lain):
git fetch origin
git rebase origin/main
git push --force-with-lease
--force-with-lease lebih aman daripada --force, karena menolak bila ada orang lain yang sudah mendorong ke cabang itu.
10. Menangani Konflik
Auto-merging routes/web.php
CONFLICT (content): Merge conflict in routes/web.php
Buka berkas, cari penanda konflik:
<<<<<<< HEAD
Route::get('/produk', [ProductController::class, 'index']);
=======
Route::get('/produk', [ProductController::class, 'index'])->middleware('auth');
>>>>>>> origin/main
Pilih atau gabungkan isi yang benar, hapus penanda, lalu:
git add routes/web.php
git commit # (merge) atau: git rebase --continue
Berkas yang sering menimbulkan konflik di Laravel:
Berkas | Cara menangani |
|---|---|
| Jangan gabung manual. Selesaikan |
| Ambil salah satu, lalu |
| Gabung manual dengan teliti |
Migrasi dengan timestamp bersamaan | Pastikan urutan masuk akal; ganti nama berkas bila perlu |
Batalkan merge yang membingungkan: git merge --abort atau git rebase --abort.
11. Membatalkan dan Memperbaiki
Situasi | Perintah |
|---|---|
Batalkan perubahan di berkas (belum di-stage) |
|
Keluarkan dari staging |
|
Ubah pesan commit terakhir (belum di-push) |
|
Batalkan commit terakhir, simpan perubahan |
|
Batalkan commit yang sudah di-push secara aman |
|
Simpan sementara pekerjaan yang belum selesai |
|
Ambil satu commit dari cabang lain |
|
Lihat riwayat ringkas |
|
Cari siapa mengubah baris tertentu |
|
Cari commit penyebab bug |
|
Hindari git reset --hard dan git push --force pada cabang bersama.
12. Lindungi Cabang main
Di GitHub: Settings > Branches > Add branch protection rule (atau Rulesets), untuk main:
☑ Require a pull request before merging
☑ Require approvals (minimal 1)
☑ Require status checks to pass (pilih job CI)
☑ Require branches to be up to date before merging
☑ Do not allow force pushes
☑ Do not allow deletions
Aktifkan juga Settings > Code security: Dependabot alerts, Dependabot security updates, dan secret scanning.
13. CI dengan GitHub Actions
.github/workflows/ci.yml:
name: CI
on:
pull_request:
push:
branches: [main]
jobs:
test:
runs-on: ubuntu-latest
services:
mysql:
image: mysql:8.4
env:
MYSQL_ROOT_PASSWORD: secret
MYSQL_DATABASE: testing
ports: ['3306:3306']
options: >-
--health-cmd="mysqladmin ping -h 127.0.0.1 -psecret"
--health-interval=10s --health-timeout=5s --health-retries=5
steps:
- uses: actions/checkout@v4
- uses: shivammathur/setup-php@v2
with:
php-version: '8.3'
extensions: mbstring, pdo_mysql, bcmath, intl, zip
coverage: none
- name: Cache Composer
uses: actions/cache@v4
with:
path: vendor
key: composer-${{ hashFiles('composer.lock') }}
- run: composer install --no-interaction --prefer-dist --no-progress
- run: cp .env.example .env && php artisan key:generate
- name: Cek gaya kode
run: vendor/bin/pint --test
- name: Jalankan test
env:
DB_CONNECTION: mysql
DB_HOST: 127.0.0.1
DB_PORT: 3306
DB_DATABASE: testing
DB_USERNAME: root
DB_PASSWORD: secret
run: php artisan test
- name: Audit dependensi
run: composer audit
- uses: actions/setup-node@v4
with: { node-version: 22, cache: npm }
- run: npm ci
- run: npm run build
Nama versi action (@v4) dan versi image dapat berubah. Sesuaikan dengan rilis terbaru.
14. Rahasia yang Terlanjur Ter-commit
Jika .env, kunci API, atau password terlanjur di-push:
Anggap rahasia itu sudah bocor. Ganti password, kunci API, dan
APP_KEYyang terkait. Ini langkah paling penting.Hentikan pelacakan berkas:
git rm --cached .env, pastikan masuk.gitignore, lalu commit.Bersihkan riwayat bila perlu dengan
git filter-repo(alat resmi yang direkomendasikan Git), lalu force push dan minta semua anggota tim melakukan clone ulang.Aktifkan secret scanning dan push protection di GitHub agar kejadian serupa tercegah.
Menghapus berkas dari commit terbaru tidak cukup, karena rahasia masih ada di riwayat.
15. Kolaborasi Tim Sehari-hari
Praktik | Cara |
|---|---|
Satu sumber tugas | GitHub Issues atau Projects, dan cantumkan nomor di commit/PR ( |
Rilis bertanda versi |
|
Catatan perubahan |
|
Pemilik kode | Berkas |
Pembaruan dependensi otomatis | Dependabot ( |
Sinkron lingkungan |
|
Contoh .github/dependabot.yml:
version: 2
updates:
- package-ecosystem: composer
directory: /
schedule: { interval: weekly }
- package-ecosystem: npm
directory: /
schedule: { interval: weekly }
- package-ecosystem: github-actions
directory: /
schedule: { interval: monthly }
Troubleshooting
Gejala | Penyebab | Solusi |
|---|---|---|
| Kunci SSH belum didaftarkan atau agen tidak aktif | Tambahkan kunci publik ke GitHub, uji |
| Memakai password HTTPS | Pakai SSH atau Personal Access Token / Git Credential Manager |
| Bukan di folder proyek |
|
| Remote punya commit yang belum Anda ambil |
|
| Sudah terlanjur dilacak |
|
| Git tetap melacak yang sudah masuk indeks |
|
| Pengaturan akhir baris di Windows |
|
Konflik di | Dua cabang memperbarui paket | Selesaikan |
Commit di cabang yang salah | Lupa membuat cabang baru |
|
Commit terlanjur di-push dengan kesalahan | - | Gunakan |
CI gagal hanya di GitHub | Perbedaan lingkungan (huruf besar-kecil nama berkas, versi PHP) | Samakan versi PHP; periksa nama berkas dan namespace dengan huruf yang tepat |
| Gaya kode belum diterapkan | Jalankan |
Berkas besar ditolak ( | Berkas biner besar masuk commit | Jangan commit berkas besar; gunakan Git LFS atau penyimpanan lain |
Best Practices
Keamanan
Jangan pernah commit
.env, kunci privat, token, atau data pelanggan. Pasang pemeriksaan sebelum commit (misalnya pre-commit hook atau secret scanning).Aktifkan autentikasi dua faktor (2FA) di akun GitHub.
Lindungi
maindengan PR wajib, review, dan status check.Berikan akses sesuai kebutuhan (prinsip hak minimum), dan tinjau anggota tim secara berkala.
Gunakan repository privat untuk kode komersial, dan aktifkan Dependabot dan secret scanning.
Performa
Gunakan commit kecil dan PR kecil agar review cepat dan konflik lebih jarang.
Cache dependensi di CI (
cache: npm, cachevendor) untuk mempercepat pipeline.Hindari memasukkan aset besar atau hasil build (
vendor,node_modules,public/build) ke repository.
Maintainability
Satu cabang, satu tujuan. Satu commit, satu perubahan logis.
Pakai Conventional Commits dan nama cabang berawalan, agar riwayat dan changelog mudah dibaca.
Wajibkan test dan gaya kode lulus sebelum merge. Otomatiskan lewat CI.
Rilis dengan tag semantik (
v1.4.0), dan jagaCHANGELOG.md.Tulis
README.mdyang memungkinkan anggota baru menjalankan proyek tanpa bertanya.Hapus cabang yang sudah di-merge:
git branch -d feature/...dangit push origin --delete feature/....Jangan menulis ulang riwayat di cabang bersama.
Related Articles
Last Tested
Catatan jujur: disusun dari dokumentasi Git, GitHub, dan GitHub Actions, tetapi belum dijalankan ulang terhadap repository dan runner nyata oleh penulis. Versi action dan fitur UI GitHub (Branch protection atau Rulesets) dapat berubah.
Komponen | Versi acuan penulisan | Versi saat Anda menguji |
|---|---|---|
Git | 2.4x (Windows) | |
GitHub | Antarmuka web, Oktober 2026 | |
GitHub Actions |
| |
PHP | 8.3.x | |
Laravel | 13.x (kompatibel dengan 12.x) | |
Tanggal uji |