Published on May. 19, 2024

Tutorial Upgrade dari Laravel 10 ke Laravel 11

Laravel 11 Rilis 14 Maret 2024

Laravel secara rutin merilis versi baru setiap tahunnya, dan di awal tahun 2024, Laravel merilis versi terbarunya yaitu Laravel 11. Laravel 11 hadir dengan banyak perubahan dan peningkatan jika dibandingkan dengan versi pendahulunya, Laravel 10. Salah satu perubahan paling mencolok adalah perubahan struktur folder yang diklaim lebih minimalis dan efisien.

Artikel ini akan membahas cara upgrade dari Laravel 10 ke Laravel 11.

Mengapa Perlu Upgrade ke Laravel 11?

1. Keamanan dan Dukungan

Fix Bug: Laravel 10 hanya akan menerima perbaikan bug sampai tanggal 6 Agustus 2024.
Fix Security: Perbaikan keamanan untuk Laravel 10 akan berakhir pada tanggal 4 Februari 2025.

Dengan melakukan upgrade ke Laravel 11, aplikasi Anda akan tetap mendapatkan dukungan penuh, termasuk fitur terbaru dan perbaikan keamanan. Ini sangat penting terutama untuk proyek jangka panjang.

2. Fitur Baru

Laravel 11 hadir dengan berbagai fitur baru dan perbaikan performa yang tidak tersedia di versi sebelumnya. Upgrade ini memungkinkan Anda memanfaatkan teknologi terbaru dan meningkatkan efisiensi pengembangan aplikasi.

Anda dapat melihat fitur selengkapnya di Dokumentasi Laravel

Langkah-Langkah Upgrade dari Laravel 10 ke Laravel 11

1. Persiapan Awal

Sebelum memulai proses upgrade, pastikan Anda sudah melakukan backup seluruh data dan kode aplikasi Anda. Ini untuk menghindari kehilangan data jika terjadi kesalahan selama proses upgrade.

2. Perubahan Struktur Folder

Meskipun Laravel 11 memperkenalkan perubahan struktur folder yang lebih minimalis, Anda tidak diwajibkan untuk mengikuti struktur baru ini. Laravel telah memastikan bahwa aplikasi dengan struktur folder lama tetap kompatibel.

3. Menggunakan Laravel Shift

Jika Anda tertarik untuk dengan mudah mengupgrade ke versi 11 beserta struktur foldernya, Anda bisa menggunakan fitur berbayar yang disediakan oleh Laravel, yaitu Laravel Shift.

Laravel Shift adalah layanan otomatis yang dapat membantu mengupgrade aplikasi Laravel Anda dengan cepat dan efisien, termasuk menyesuaikan struktur folder dan memperbarui dependency yang diperlukan.

4. Persyaratan Versi PHP

Laravel 11 membutuhkan PHP versi minimal 8.2. Pastikan server Anda mendukung PHP 8.2. Anda dapat memeriksa versi PHP yang terpasang dengan menjalankan perintah berikut di terminal:

php -v

Jika versi PHP Anda belum 8.2 atau lebih tinggi, Anda perlu melakukan upgrade PHP terlebih dahulu.

Pastikan Versi php Anda minimal PHP 8.2

5. Periksa Informasi Instalasi Laravel

Sebelum melakukan modifikasi pada file project kita, selain kita melakukan backup file kerja kita, kita juga perlu mencatat beberapa kondisi sebelum dan sesudah dilakukan upgrade. Tujuannya agar proses yang kita lakukan dapat diverifikasi, apakah proses upgrade berhasil atau gagal.

Jalankan perintah berikut di terminal Anda, arahakan ke `root` folder project Anda

php artisan about

Informasi Versi Laravel sebelum Upgrade

6. Update Dependency di Composer

Selanjutnya, Anda perlu memperbarui beberapa dependency di file composer.json. Buka file `composer.json` di root folder project Anda, kemudian edit versi dependency yang sesuai.

Berikut adalah daftar dependency yang harus diubah:

Mandatory (wajib)

"laravel/framework": "^11.0",
"nunomaduro/collision": "^8.1"

Optional (jika diinstall)

"laravel/breeze": "^2.0",
"laravel/cashier": "^15.0",
"laravel/dusk": "^8.0",
"laravel/jetstream": "^5.0",
"laravel/octane": "^2.3",
"laravel/passport": "^12.0",
"laravel/sanctum": "^4.0",
"laravel/spark-stripe": "^5.0",
"laravel/telescope": "^5.0",
"inertiajs/inertia-laravel": "^1.0"

Berikut adalah contoh file composer.json sebelum dan sesudah diubah:

File composer.json sebelum dilakukan perubahan

Perubahan pada file composer.json

File composer.json setelah dilakukan perubahan

Save file composer.json Anda

7. Jalankan Update Composer

Setelah melakukan perubahan pada file composer.json, jalankan perintah berikut di terminal untuk memperbarui dependency:

composer update

Proses update dependency dari file composer.json

8. Verifikasi Upgrade

Setelah update selesai, verifikasi hasil upgrade dengan menjalankan perintah:

php artisan about

Perintah ini akan menampilkan informasi tentang instalasi Laravel Anda, memastikan bahwa versi Laravel telah diperbarui ke 11.

Informasi Versi Laravel setelah Upgrade

Selamat! Anda telah berhasil melaukan upgrade ke Laravel 11!

9. Menangani Error yang Mungkin Terjadi

Jika terjadi error selama proses update, pastikan Anda telah memperbarui semua dependency yang diperlukan. Beberapa package mungkin memerlukan update khusus agar kompatibel dengan Laravel 11. Baca dokumentasi dari library tersebut untuk petunjuk lebih lanjut.

Contoh Update Package

Sebagai contoh, jika Anda menginstal beberapa package tambahan, Anda perlu memastikan bahwa masing-masing package tersebut diperbarui agar mendukung Laravel 11.

Berikut adalah beberapa package yang mungkin perlu diperbarui:

cviebrock/eloquent-sluggable

Membuat slug otomatis dari input dengan javascript

"cviebrock/eloquent-sluggable": "^11.0"

laravel/scout

Membuat fitur pencarian pada model

"laravel/scout": "^10.9"

Pastikan untuk mengikuti dokumentasi resmi dari masing-masing package untuk instruksi update yang sesuai.

Kesimpulan

Upgrade ke Laravel 11 memberikan banyak manfaat, mulai dari dukungan keamanan yang diperpanjang hingga fitur dan performa yang ditingkatkan. Dengan mengikuti langkah-langkah di atas, Anda dapat dengan mudah mengupgrade aplikasi Laravel Anda dari versi 10 ke versi 11.

Pastikan Anda selalu mencadangkan data dan kode Anda sebelum melakukan perubahan besar seperti ini untuk menghindari kehilangan data yang tidak diinginkan.

Jika Anda ingin memanfaatkan struktur folder baru yang lebih minimalis dan efisien, pertimbangkan untuk menggunakan Laravel Shift, layanan berbayar yang dapat membantu memigrasi aplikasi Anda ke struktur yang baru.

BKA Blog