Home / Artikel / Web Development
Web Development

Login Berhasil tetapi Session PHP Hilang: Melacak Masalah dari Cookie sampai Server

Login terlihat sukses, tetapi halaman berikutnya meminta login lagi. Masalah session PHP sering bukan di form login, melainkan di cookie, domain, HTTPS, atau konfigurasi server. Berikut cara melacaknya secara sistematis.

Pengguna memasukkan email dan password dengan benar. Halaman login menampilkan pesan sukses, lalu mengarahkan ke dashboard. Namun beberapa detik kemudian, dashboard berubah menjadi halaman login lagi. Kasus seperti ini sering membuat pengembang curiga pada password, padahal masalahnya bisa jauh di belakang form: session PHP tidak terbaca pada request berikutnya.

Session adalah cara aplikasi web mengingat bahwa seseorang sudah login. PHP menyimpan data session di server, sedangkan browser hanya memegang kunci berupa cookie, biasanya bernama PHPSESSID. Jika kunci itu tidak tersimpan, tidak terkirim, atau berubah, server akan menganggap pengguna sebagai tamu baru. Karena itu, login yang berhasil tetapi session hilang hampir selalu soal rantai cookie, domain, HTTPS, dan konfigurasi server.

Session bukan file ajaib: cookie adalah kuncinya

Bayangkan session seperti loker di gym. Server menyimpan isi loker, misalnya data pengguna yang sudah login. Browser hanya membawa nomor loker dalam bentuk cookie. Setiap kali pengguna membuka halaman lain, browser menunjukkan nomor loker itu. Kalau nomornya hilang atau tertukar, petugas tidak bisa menemukan loker yang benar.

Di PHP, proses ini dimulai dengan session_start(). Fungsi itu membuat atau melanjutkan session, lalu mengirim cookie ke browser. Pada request berikutnya, browser harus mengirim cookie yang sama. Jika salah satu langkah gagal, aplikasi akan membuat session baru dan pengguna tampak logout sendiri.

Tiga lapisan yang perlu diperiksa

Masalah session jarang berdiri sendiri. Ada tiga lapisan yang perlu dilihat berurutan: browser, kode PHP, dan server atau proxy di depannya. Memeriksa semuanya sekaligus bisa membingungkan, jadi mulai dari yang paling mudah diamati.

1. Cookie tidak tersimpan atau tidak terkirim

Buka DevTools di browser, masuk ke tab Network, lalu ulangi proses login. Perhatikan response dari request login. Di sana harus ada header Set-Cookie untuk PHPSESSID. Setelah redirect, periksa request ke dashboard. Di header request harus ada Cookie yang membawa PHPSESSID yang sama.

Jika Set-Cookie tidak muncul, periksa pengaturan cookie di PHP. Jika muncul tetapi tidak terkirim pada request berikutnya, periksa domain, path, dan atribut keamanan cookie. Cookie untuk www.example.com tidak otomatis berlaku untuk example.com, begitu pula sebaliknya. Path yang terlalu sempit juga bisa membuat cookie hanya berlaku di sebagian halaman.

Atribut Secure mengharuskan cookie dikirim lewat HTTPS. Kalau situs masih diakses lewat HTTP, cookie dengan atribut ini tidak akan dipakai. Atribut SameSite mengatur kapan cookie boleh dikirim antar-situs. Untuk login biasa, Lax sering cukup. Jika memakai None, cookie wajib memakai Secure dan situs harus HTTPS.

Contoh pengaturan yang lebih eksplisit:

session_set_cookie_params([
    'lifetime' => 0,
    'path' => '/',
    'domain' => '.example.com',
    'secure' => true,
    'httponly' => true,
    'samesite' => 'Lax',
]);
session_start();

Gunakan domain yang memang menjadi kanonik situs. Jangan mencampur www dan non-www tanpa redirect yang konsisten. Setelah login berhasil, panggil session_regenerate_id(true) untuk mengganti ID session lama. Ini praktik keamanan yang juga membantu memastikan session baru benar-benar terbentuk.

2. Session ID berubah karena konfigurasi server

Di hosting biasa, session biasanya disimpan sebagai file di server. Jika folder penyimpanan tidak bisa ditulis, session akan gagal dibuat. Periksa session.save_path dan izin foldernya. Di lingkungan dengan beberapa server, session file lokal tidak akan terbaca oleh server lain. Solusinya memakai penyimpanan bersama seperti Redis, atau mengaktifkan sticky session di load balancer.

Perhatikan juga session.gc_maxlifetime. Nilai ini menentukan berapa lama session disimpan sebelum dibersihkan. Jika terlalu pendek, pengguna bisa terlogout lebih cepat dari yang diharapkan. Sebaliknya, nilai yang terlalu panjang tanpa pengelolaan bisa menumpuk data. Sesuaikan dengan kebutuhan aplikasi dan kapasitas server.

Di belakang proxy atau load balancer, pastikan aplikasi tahu bahwa koneksi aslinya HTTPS. Jika tidak, PHP bisa mengira koneksi masih HTTP dan menolak mengirim cookie Secure. Gejalanya sering membingungkan: di server lokal lancar, di produksi session selalu hilang.

3. Kode memanggil session_start() terlambat atau ganda

session_start() harus dipanggil sebelum ada output apa pun ke browser. Spasi sebelum <?php, karakter tak terlihat di awal file, atau echo sebelum session dimulai bisa memicu pesan headers already sent. Dalam kondisi tertentu, cookie session tidak terkirim dengan benar.

Setelah redirect, selalu akhiri dengan exit atau die. Tanpa itu, skrip bisa terus berjalan dan menulis output tambahan. Pola yang aman:

session_start();
header('Location: /dashboard.php');
exit;

Jika aplikasi memakai output buffering, pastikan tidak ada buffer yang ditutup terlalu awal. Periksa juga apakah ada file yang dipanggil berulang kali sehingga session_start() dieksekusi ganda. Pemanggilan ganda bisa memicu notice dan membuat alur session tidak stabil.

Cara melacak dalam 15 menit

  1. Reproduksi masalah di jendela incognito agar cookie lama dan ekstensi browser tidak mengganggu.
  2. Buka DevTools, tab Network, lalu login. Catat header Set-Cookie pada response login.
  3. Lihat request berikutnya. Pastikan header Cookie membawa PHPSESSID yang sama.
  4. Periksa status redirect. Pastikan tidak ada loop antara HTTP dan HTTPS atau antara www dan non-www.
  5. Cek file session di server. Jika file baru terus dibuat setiap request, berarti browser tidak mengirim ID lama atau server tidak menemukan session lama.
  6. Baca log PHP dan web server. Cari pesan headers already sent, permission denied, atau warning seputar session.
  7. Uji di browser lain. Jika berhasil di satu browser tetapi gagal di browser lain, curigai pengaturan cookie atau ekstensi privasi.

Contoh kasus yang sering terjadi

Di localhost, login berjalan normal. Setelah diunggah ke hosting, pengguna selalu kembali ke halaman login. Ternyata situs diakses lewat https://www.example.com, tetapi cookie diatur untuk example.com tanpa titik di depan. Redirect internal juga berpindah ke domain tanpa www. Browser menganggap keduanya situs berbeda, sehingga cookie tidak ikut.

Kasus lain: aplikasi berjalan di dua server di belakang load balancer. Session disimpan sebagai file lokal. Pengguna login di server A, lalu request berikutnya diarahkan ke server B. Server B tidak menemukan file session, membuat session baru, dan pengguna terlihat logout. Solusinya bukan menambah kapasitas server, melainkan menyatukan penyimpanan session atau mengarahkan pengguna ke server yang sama.

Apa artinya bagi kita?

Masalah session mengajarkan satu hal penting: login bukan hanya soal mencocokkan password. Login adalah kesepakatan antara browser, aplikasi, dan server untuk terus mengenali pengguna. Kalau salah satu pihak tidak konsisten, pengalaman pengguna langsung terasa rusak. Untuk situs kecil, dampaknya bisa berupa pengguna gagal masuk. Untuk toko online atau aplikasi internal, dampaknya bisa berupa keranjang hilang, pekerjaan terputus, atau data yang tampak tidak tersimpan.

Karena itu, perbaikan session sebaiknya tidak dilakukan dengan menambah pengecekan password berulang-ulang. Telusuri akar masalahnya: domain, cookie, HTTPS, penyimpanan session, dan urutan kode. Setelah ditemukan, buat pengujian sederhana yang bisa diulang di lingkungan lokal dan produksi.

Yang bisa dilakukan sekarang

  • Tetapkan satu domain kanonik dan redirect semua variasi ke domain itu.
  • Atur parameter cookie session secara eksplisit: path, domain, Secure, HttpOnly, dan SameSite.
  • Panggil session_start() di awal bootstrap aplikasi, sebelum output apa pun.
  • Selalu akhiri redirect dengan exit.
  • Gunakan penyimpanan session bersama jika aplikasi berjalan di lebih dari satu server.
  • Uji login di incognito, browser berbeda, dan setelah pindah dari HTTP ke HTTPS.
  • Catat dan pantau warning session di log, jangan hanya mengandalkan tampilan halaman.

Session yang hilang bukan bug mistis. Ia biasanya meninggalkan jejak di header, cookie, dan log. Dengan memeriksa rantai itu dari browser sampai server, kita bisa menemukan titik putusnya dan membuat login terasa sebagaimana mestinya: sekali masuk, tetap dikenali.

– Rio Yotto @rioyotto