{"id":12836,"date":"2025-05-02T09:16:32","date_gmt":"2025-05-02T09:16:32","guid":{"rendered":"https:\/\/binus.ac.id\/binus-digital\/?p=12836"},"modified":"2025-12-02T09:17:17","modified_gmt":"2025-12-02T09:17:17","slug":"biaya-tersembunyi-default-mysql-di-aplikasi-laravel-stabilitas-kinerja-dan-data-yang-akurat","status":"publish","type":"post","link":"https:\/\/binus.ac.id\/binus-digital\/2025\/05\/02\/biaya-tersembunyi-default-mysql-di-aplikasi-laravel-stabilitas-kinerja-dan-data-yang-akurat\/","title":{"rendered":"Biaya Tersembunyi Default MySQL di Aplikasi Laravel: Stabilitas, Kinerja, dan Data yang Akurat"},"content":{"rendered":"
\n
\n

\n Banyak proyek Laravel berjalan mulus di lokal, lalu mendapati anomali saat ke staging\/produksi: urutan sort yang berbeda,
\n indeks mendadak meledak, data yang \u201cdiam-diam\u201d terpotong, atau jam yang tidak sinkron. Seringkali penyebabnya sederhana:
\n kita membiarkan default MySQL apa adanya. Artikel ini membedah risiko-risiko tersebut dan memberikan pola aman yang
\n pragmatis\u2014tanpa mengorbankan kenyamanan pengembangan sehari-hari.\n <\/p>\n<\/header>\n

\n

Ringkasan Cepat<\/h2>\n
    \n
  • Samakan charset\/collation:<\/strong> Pastikan skema, tabel, dan kolom konsisten (idealnya utf8mb4<\/code> + collation yang tepat).<\/li>\n
  • Kendalikan panjang indeks:<\/strong> Hindari workaround global defaultStringLength(191)<\/code> bila Anda pakai MySQL 5.7+\/8\u2014benahi di akar.<\/li>\n
  • Gunakan SQL strict mode:<\/strong> Biar kegagalan terlihat cepat, bukan menyimpan utang teknis.<\/li>\n
  • Selaraskan timezone:<\/strong> Simpan UTC di DB, konversi di aplikasi\/UI.<\/li>\n
  • Pilih tipe data dengan sadar:<\/strong> decimal<\/code> untuk uang, json<\/code> untuk semi-terstruktur, bigIncrements<\/code> untuk tabel besar.<\/li>\n<\/ul>\n<\/section>\n
    \n

    1) Charset & Collation: Konsistensi yang Menentukan<\/h2>\n

    \n Laravel cenderung menset utf8mb4<\/code> dan kolasi berbasis Unicode. Namun banyak server MySQL lama\/host bersama masih
    \n menyalakan default lain (mis. latin1<\/code>), lalu tabel\/kolom baru warisi default yang berbeda. Dampaknya:\n <\/p>\n

      \n
    • Sort\/compare berbeda:<\/strong> ORDER BY berubah antara lingkungan.<\/li>\n
    • Emoji\/karakter non-BMP rusak:<\/strong> Selain data korup, indeks bisa gagal bila panjang byte tak cukup.<\/li>\n
    • Join error:<\/strong> \u201cIllegal mix of collations\u201d saat menggabungkan kolom dengan kolasi tak seragam.<\/li>\n<\/ul>\n
      \/\/ config\/database.php (cuplikan)\r\n'mysql' => [\r\n  'driver' => 'mysql',\r\n  'charset' => 'utf8mb4',\r\n  'collation' => 'utf8mb4_unicode_ci', \/\/ Pertimbangkan 'utf8mb4_0900_ai_ci' di MySQL 8+\r\n  'engine' => null,\r\n  'strict' => true,\r\n  \/\/ 'options' => [PDO::MYSQL_ATTR_INIT_COMMAND => \"SET time_zone = '+00:00'\"],\r\n],<\/code><\/pre>\n
      -- Audit cepat kolasi di server\r\nSHOW VARIABLES LIKE 'character_set_%';\r\nSHOW VARIABLES LIKE 'collation%';\r\n\r\n-- Tabel\/kolom yang kolasinya berbeda\r\nSELECT t.TABLE_SCHEMA, t.TABLE_NAME, t.TABLE_COLLATION\r\nFROM information_schema.TABLES t\r\nWHERE t.TABLE_SCHEMA = DATABASE()\r\nORDER BY t.TABLE_COLLATION;<\/code><\/pre>\n
      Rekomendasi:<\/strong> Standardisasi pada level database dan override per tabel bila perlu:\n    <\/p>\n
      \/\/ Migration contoh\r\nSchema::create('posts', function (Blueprint $table) {\r\n  $table->id();\r\n  $table->string('title')\r\n        ->charset('utf8mb4')\r\n        ->collation('utf8mb4_unicode_ci');\r\n  $table->text('body');\r\n  $table->timestampsTz(); \/\/ simpan UTC, tampilkan sesuai zona di UI\r\n});<\/code><\/pre>\n<\/section>\n
      \n
      2) Panjang String & Batas Indeks: 191 vs 255<\/h2>\n
      \n      Di MySQL lama (batas indeks 767 byte), utf8mb4<\/code> membuat indeks pada VARCHAR(255)<\/code> gagal. Solusi historis: Schema::defaultStringLength(191)<\/code>.
      \n      Ini bekerja, tetapi menyembunyikan masalah lingkungan dan menurunkan ketelitian indeks.\n    <\/p>\n
        \n
      • MySQL 5.7+\/8:<\/strong> Dengan InnoDB modern (row format DYNAMIC), batas indeks efektif 3072 byte\u2014hindari workaround global.<\/li>\n
      • Prefer refactor:<\/strong> Upgrade server\/engine\/row format daripada memendekkan semua kolom secara buta.<\/li>\n
      • Kasus unik:<\/strong> Untuk kolom unik email\/slug, batasi panjang kolom secara semantik (mis. 200) bila Anda benar-benar butuh.<\/li>\n<\/ul>\n
        \/\/ Hindari: di AppServiceProvider men-set defaultStringLength(191)\r\n\/\/ Gunakan design yang jelas: batasi panjang kolom yang memang perlu\r\n$table->string('slug', 200)->unique();<\/code><\/pre>\n<\/section>\n
        \n
        3) SQL Modes & Strict Mode: Gagal Cepat Lebih Murah<\/h2>\n
        \n      Tanpa strict mode, MySQL bisa memotong nilai diam-diam (truncation) atau mengkonversi nilai tak valid. Ini berbahaya karena
        \n      bug terlihat sangat terlambat. Laravel defaultnya strict: true<\/code>\u2014pertahankan demikian dan sinkronkan daftar mode di server.\n    <\/p>\n
          \n
        • ONLY_FULL_GROUP_BY:<\/strong> Paksa agregasi benar. Perbaiki query, jangan matikan.<\/li>\n
        • NO_ZERO_DATE\/NO_ZERO_IN_DATE:<\/strong> Cegah tanggal semu 0000-00-00<\/code>.<\/li>\n
        • ERROR_FOR_DIVISION_BY_ZERO:<\/strong> Lebih baik meledak daripada hasil kacau.<\/li>\n<\/ul>\n
          -- Lihat SQL_MODE\r\nSELECT @@GLOBAL.sql_mode, @@SESSION.sql_mode;<\/code><\/pre>\n<\/section>\n
          \n
          4) NULL vs String Kosong: Selaraskan dengan Validasi<\/h2>\n
          \n      Default kolom sering nullable<\/em> tanpa alasan. Padahal pada domain tertentu, \u201ctidak diisi\u201d berbeda makna dengan \u201cdiisi tapi kosong\u201d.
          \n      Pastikan migrasi dan rules Laravel konsisten agar analitik tidak bias.\n    <\/p>\n
          \/\/ Migration: eksplisitkan nullability\r\n$table->string('middle_name')->nullable(); \/\/ benar-benar boleh kosong\r\n$table->string('phone')->nullable(false);  \/\/ wajib diisi\r\n\r\n\/\/ Form request\r\n'phone' => ['required','string','max:32']<\/code><\/pre>\n<\/section>\n
          \n
          5) Timestamps & Timezone: Simpan UTC, Tampilkan Lokal<\/h2>\n
          \n      Default timestamps()<\/code> tidak menyertakan zona. Simpan UTC di DB dan konversikan di aplikasi\/klien.
          \n      Hindari campuran timezone antar layanan.\n    <\/p>\n
          \/\/ Migration: gunakan tipe bertzona bila tersedia\r\n$table->timestampsTz();       \/\/ created_at\/updated_at dengan zona\r\n$table->softDeletesTz();      \/\/ deleted_at dengan zona\r\n\r\n\/\/ AppServiceProvider (opsional): set session time_zone\r\nuse Illuminate\\Support\\Facades\\DB;\r\n\r\npublic function boot(): void\r\n{\r\n  DB::listen(function () {}); \/\/ agar koneksi terinisiasi\r\n  DB::unprepared(\"SET time_zone = '+00:00'\"); \/\/ simpan UTC\r\n}<\/code><\/pre>\n
          Catatan:<\/strong> Pastikan server MySQL punya tabel zona waktu lengkap jika menggunakan nama zona.<\/p>\n<\/section>\n
          \n
          6) Engine, Row Format, dan Stabilitas Indeks<\/h2>\n
          \n      InnoDB adalah pilihan aman. Di server lama, pastikan row format DYNAMIC agar indeks panjang (utf8mb4) aman.\n    <\/p>\n
          -- Cek engine\/row format\r\nSELECT TABLE_NAME, ENGINE, ROW_FORMAT\r\nFROM information_schema.TABLES\r\nWHERE TABLE_SCHEMA = DATABASE();<\/code><\/pre>\n
          \/\/ Migration: set per tabel bila perlu\r\nSchema::create('users', function (Blueprint $table) {\r\n  $table->engine = 'InnoDB';\r\n  $table->id();\r\n  $table->string('email')->unique();\r\n  $table->timestamps();\r\n});<\/code><\/pre>\n<\/section>\n
          \n
          7) Tipe Numerik & Uang: Hindari Float untuk Nilai Finansial<\/h2>\n
            \n
          • Gunakan DECIMAL:<\/strong> decimal(18,2)<\/code> atau sesuai kebutuhan agar akurat.<\/li>\n
          • Unsigned untuk ID\/Hitung ke atas:<\/strong> Hemat rentang dan konsisten dengan relasi.<\/li>\n
          • Skala besar:<\/strong> Gunakan bigIncrements<\/code>\/unsignedBigInteger<\/code> sejak awal untuk tabel yang akan tumbuh cepat.<\/li>\n<\/ul>\n
            \/\/ Migration\r\n$table->decimal('amount', 18, 2)->default(0);\r\n$table->unsignedBigInteger('user_id');<\/code><\/pre>\n<\/section>\n
            \n
            8) Kolom JSON: Kekuatan & Perbedaan MySQL vs MariaDB<\/h2>\n
            \n      Di MySQL 5.7+, JSON<\/code> punya validasi dan operator bawaan. Di MariaDB, tipe JSON<\/code> hanyalah alias LONGTEXT<\/code>.
            \n      Ketahui platform Anda sebelum mengandalkan fungsi lanjutan.\n    <\/p>\n
            \/\/ Query builder\r\nUser::whereJsonContains('meta->roles', 'admin')->get();\r\n\r\n\/\/ Index pada path JSON (MySQL): gunakan kolom terhitung\r\nALTER TABLE users\r\n  ADD COLUMN role_first VARCHAR(32)\r\n    GENERATED ALWAYS AS (json_unquote(json_extract(meta, '$.roles[0]'))) STORED,\r\n  ADD INDEX idx_role_first (role_first);<\/code><\/pre>\n<\/section>\n
            \n
            9) Boolean & Enum: Tegaskan Intent<\/h2>\n
              \n
            • Boolean = TINYINT(1):<\/strong> Tetap angka. Dokumentasikan maknanya dan gunakan cast Eloquent.<\/li>\n
            • Enum:<\/strong> Di MySQL 8+ bisa kombinasikan dengan CHECK untuk validasi tambahan, atau gunakan tabel referensi.<\/li>\n<\/ul>\n
              \/\/ Model cast\r\nprotected $casts = [\r\n  'is_active' => 'boolean',\r\n];<\/code><\/pre>\n<\/section>\n
              \n
              10) Ordering, Collation-Sensitive LIKE, dan Pencarian<\/h2>\n
              \n      Kolasi memengaruhi perbandingan\/penyortiran. Case-insensitive mungkin bagus untuk pencarian, tetapi bisa
              \n      menabrak kebutuhan case-sensitive tertentu. Terapkan kolasi pada level kolom atau query saat diperlukan.\n    <\/p>\n
              \/\/ Case-sensitive exact match\r\nUser::whereRaw(\"BINARY username = ?\", [$input])->first();\r\n\r\n\/\/ Pakai kolasi berbeda di query\r\nPost::orderByRaw(\"title COLLATE utf8mb4_0900_as_cs ASC\")->get();<\/code><\/pre>\n<\/section>\n
              \n
              11) Migrations & Konvensi: Lebih Eksplisit, Lebih Sedikit Kejutan<\/h2>\n
                \n
              • Eksplisitkan panjang dan nullability:<\/strong> Hindari default yang kabur.<\/li>\n
              • Gunakan timestampsTz<\/code>\/softDeletesTz<\/code>:<\/strong> Seragamkan waktu di UTC.<\/li>\n
              • Index yang bermakna:<\/strong> Nama indeks, urutan kolom, dan panjang kolom yang realistis.<\/li>\n
              • Hindari hack global:<\/strong> Seperti defaultStringLength(191)<\/code> kecuali benar-benar diperlukan untuk kompatibilitas sementara.<\/li>\n<\/ul>\n
                \/\/ Contoh migration terstandar\r\nSchema::create('orders', function (Blueprint $table) {\r\n  $table->bigIncrements('id');\r\n  $table->foreignId('user_id')->constrained()->cascadeOnDelete();\r\n  $table->string('number', 40)->unique();\r\n  $table->decimal('total', 18, 2)->default(0);\r\n  $table->json('meta')->nullable();\r\n  $table->timestampsTz();\r\n  $table->index(['user_id', 'created_at']);\r\n});<\/code><\/pre>\n<\/section>\n
                \n
                12) Observability & Audit: Kenali Lingkungan Anda<\/h2>\n
                -- Temukan kolom dengan collation berbeda dari default DB\r\nSELECT c.TABLE_NAME, c.COLUMN_NAME, c.COLLATION_NAME\r\nFROM information_schema.COLUMNS c\r\nWHERE c.TABLE_SCHEMA = DATABASE()\r\n  AND (c.COLLATION_NAME IS NOT NULL)\r\nORDER BY c.COLLATION_NAME;\r\n\r\n-- Cari indeks yang berisiko (panjang besar pada utf8mb4)\r\nSELECT TABLE_NAME, INDEX_NAME, SUM(CARDINALITY) AS card\r\nFROM information_schema.STATISTICS\r\nWHERE TABLE_SCHEMA = DATABASE()\r\nGROUP BY TABLE_NAME, INDEX_NAME\r\nORDER BY card ASC;<\/code><\/pre>\n
                \/\/ Cek nilai runtime di Laravel (Tinker)\r\nDB::select('select @@version as v, @@sql_mode as m, @@time_zone as tz');<\/code><\/pre>\n<\/section>\n
                \n
                13) Checklist Produksi<\/h2>\n
                  \n
                • [ ] DB, tabel, dan kolom memakai utf8mb4<\/code> + kolasi seragam.<\/li>\n
                • [ ] Strict mode aktif; ONLY_FULL_GROUP_BY<\/code> tidak dinonaktifkan demi kenyamanan.<\/li>\n
                • [ ] Timestamps disimpan UTC; UI mengonversi ke zona pengguna.<\/li>\n
                • [ ] Kolom finansial memakai decimal<\/code>; tidak ada float<\/code> untuk uang.<\/li>\n
                • [ ] Panjang kolom dan indeks dievaluasi semantik; tidak mengandalkan hack global.<\/li>\n
                • [ ] Perbedaan MySQL vs MariaDB diakomodasi (terutama JSON & kolasi).<\/li>\n
                • [ ] Migrations eksplisit; tidak ada kolom nullable tanpa alasan.<\/li>\n
                • [ ] Audit Dev\/Stage\/Prod memiliki konfigurasi yang konsisten.<\/li>\n<\/ul>\n<\/section>\n
                  \n
                  Penutup<\/h2>\n
                  \n      Default nyaman di awal, tetapi mahal di akhir. Dengan menstandardisasi charset\/collation, mengaktifkan strict mode,
                  \n      menyelaraskan timezone, memilih tipe data yang tepat, dan menulis migrasi eksplisit, Anda mengurangi kelas problem
                  \n      \u201caneh di produksi\u201d. Perlakukan database sebagai bagian dari desain sistem\u2014bukan sekadar tempat menyimpan data.\n    <\/p>\n<\/section>\n