Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Tooling / Panduan Git dan GitHub untuk D...
Tooling

Panduan Git dan GitHub untuk Developer Laravel: Branching, Commit, dan Kolaborasi Tim

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
11 min read
12 views

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 main dan 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:

  1. main selalu dalam kondisi stabil dan dapat di-deploy.

  2. Setiap pekerjaan dibuat di cabang terpisah dari main.

  3. Commit kecil dan sering di cabang itu.

  4. Buka Pull Request (PR) saat siap ditinjau.

  5. Setelah disetujui dan CI lulus, merge ke main, lalu hapus cabangnya.

Penamaan cabang:

Awalan

Untuk

Contoh

feature/

Fitur baru

feature/checkout-preorder

fix/

Perbaikan bug

fix/stok-bisa-minus

hotfix/

Perbaikan darurat production

hotfix/webhook-pembayaran

chore/

Pemeliharaan, dependensi

chore/update-composer

docs/

Dokumentasi

docs/panduan-instalasi

refactor/

Merapikan tanpa mengubah perilaku

refactor/product-service

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

feat

Fitur baru

fix

Perbaikan bug

docs

Dokumentasi

style

Format kode (tanpa perubahan logika)

refactor

Merapikan kode

test

Menambah/memperbaiki test

chore

Pemeliharaan, dependensi, konfigurasi

perf

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

composer.lock

Jangan gabung manual. Selesaikan composer.json, lalu jalankan composer update --lock atau composer install/update untuk membuat ulang

package-lock.json

Ambil salah satu, lalu npm install untuk membangun ulang

routes/web.php

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)

git restore app/Models/Product.php

Keluarkan dari staging

git restore --staged app/Models/Product.php

Ubah pesan commit terakhir (belum di-push)

git commit --amend -m "pesan baru"

Batalkan commit terakhir, simpan perubahan

git reset --soft HEAD~1

Batalkan commit yang sudah di-push secara aman

git revert <hash> (membuat commit pembalik)

Simpan sementara pekerjaan yang belum selesai

git stash lalu git stash pop

Ambil satu commit dari cabang lain

git cherry-pick <hash>

Lihat riwayat ringkas

git log --oneline --graph --decorate -20

Cari siapa mengubah baris tertentu

git blame app/Services/OrderService.php

Cari commit penyebab bug

git bisect start lalu git bisect bad/good

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:

  1. Anggap rahasia itu sudah bocor. Ganti password, kunci API, dan APP_KEY yang terkait. Ini langkah paling penting.

  2. Hentikan pelacakan berkas: git rm --cached .env, pastikan masuk .gitignore, lalu commit.

  3. Bersihkan riwayat bila perlu dengan git filter-repo (alat resmi yang direkomendasikan Git), lalu force push dan minta semua anggota tim melakukan clone ulang.

  4. 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 (Closes #42)

Rilis bertanda versi

git tag -a v1.4.0 -m "Rilis 1.4.0" lalu git push origin v1.4.0

Catatan perubahan

CHANGELOG.md, atau GitHub Releases

Pemilik kode

Berkas .github/CODEOWNERS agar reviewer otomatis ditunjuk

Pembaruan dependensi otomatis

Dependabot (.github/dependabot.yml)

Sinkron lingkungan

README.md berisi langkah setup, dan .env.example selalu mutakhir

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

Permission denied (publickey)

Kunci SSH belum didaftarkan atau agen tidak aktif

Tambahkan kunci publik ke GitHub, uji ssh -T git@github.com

remote: Support for password authentication was removed

Memakai password HTTPS

Pakai SSH atau Personal Access Token / Git Credential Manager

fatal: not a git repository

Bukan di folder proyek

cd ke folder yang benar, atau git init

error: failed to push some refs ... non-fast-forward

Remote punya commit yang belum Anda ambil

git pull --rebase origin main (atau merge), lalu push

.env muncul di git status

Sudah terlanjur dilacak

git rm --cached .env, pastikan ada di .gitignore

.gitignore tidak berfungsi untuk berkas yang sudah dilacak

Git tetap melacak yang sudah masuk indeks

git rm -r --cached <path> lalu commit

warning: LF will be replaced by CRLF

Pengaturan akhir baris di Windows

git config --global core.autocrlf input, dan andalkan .gitattributes

Konflik di composer.lock

Dua cabang memperbarui paket

Selesaikan composer.json, jalankan composer update --lock atau buat ulang lock, jangan gabung manual

Commit di cabang yang salah

Lupa membuat cabang baru

git branch fitur-baru, lalu git reset --hard origin/main di cabang lama (hati-hati, pastikan perubahan sudah aman di cabang baru)

Commit terlanjur di-push dengan kesalahan

-

Gunakan git revert, bukan menulis ulang riwayat bersama

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

Pint gagal di CI

Gaya kode belum diterapkan

Jalankan vendor/bin/pint lokal lalu commit

Berkas besar ditolak (file exceeds 100 MB)

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 main dengan 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, cache vendor) 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 jaga CHANGELOG.md.

  • Tulis README.md yang memungkinkan anggota baru menjalankan proyek tanpa bertanya.

  • Hapus cabang yang sudah di-merge: git branch -d feature/... dan git 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

checkout@v4, setup-php@v2, setup-node@v4

PHP

8.3.x

Laravel

13.x (kompatibel dengan 12.x)

Tanggal uji

Bagikan artikel:

Artikel lainnya