Proyek ini merupakan sebuah proyek mini yang berkaitan dengan inventarisasi barang. Menggunakan framework Laravel 10, proyek ini memanfaatkan database MySQL dan MongoDB. Fokus utama proyek ini adalah simulasi aplikasi inventarisasi barang mini. Perhatian utama dalam proyek ini adalah pada pengembangan bagian back-end, termasuk penggunaan route resource, gate, custom request, dan penanganan kesalahan pada front-end.
Ketika proyek ini dibuat, Laravel 10 belum didukung oleh jenssegers/mongodb. Oleh karena itu, proyek ini menggunakan paket mongodb versi dev-master. Sebelum menginstal proyek ini, jika jenssegers/mongodb telah mendukung Laravel 10, silahkan ubah jenssegers/mongodb ke versi yang mendukung Laravel 10.
- Laravel 10
- Laravel Breeze
- Tailwind
- DaisyUI
- MySQL
- MongoDB
Ini adalah langkah instalasi yang harus dilakukan untuk menginstal proyek ini pada mesin local.
- npm
- composer
- XAMPP/LAMPP
- php mongodb extension
- Laravel
- pecl
Di bawah ini adalah langkah-langkah yang diperlukan untuk proses instalasi proyek. Pastikan semua requirements telah ter-install.
-
Clone repository dengan perintah
git clone https://github.com/alifirhas/laravel-pos-barang.git
-
Masuk ke dalam folder proyek yang telah di-clone
-
salin file .env.example ke .env. Langkah ini bisa dilakukan dengan copy-paste atau menggunakan perintah
cp .env.example .env # Jangan menggunakan perintah mv .env.example .env # Karena ini akan menghapus file .env.example
Beberapa hal yang harus dilakukan di .env
-
Sesuaikan variable koneksi MySQL
- DB_HOST → terdapat perbedaan antara localhost dan 127.0.0.1
- DB_PORT → Cek port yang digunakan
- DB_DATABASE → Nama database yang akan digunakan untuk migration
- DB_USERNAME → Username dari akun yang dapat mengakses database
- DB_PASSWORD → Password dari username yang dapat mengakses database
-
Sesuaikan variable koneksi MongoDB
- MONGODB_DSN → Bisa didapatkan dari MongoDB atlas dengan koneksi pada driver PHP setelah membuat cluster
- MONGODB_DATABASE → Nama database yang ada pada cluster
Untuk contoh tolong gunakan variable ini
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=pos-barang DB_USERNAME=root DB_PASSWORD= # DSN mongodb dapat digunakan MONGODB_DSN=mongodb+srv://admin:[email protected]/?retryWrites=true&w=majority MONGODB_DATABASE=posbarang
-
-
Generate kunci aplikasi Laravel dengan menggunakan perintah
php artisan key:generate
-
Install package composer
composer install
-
Install package NPM
npm install
-
Buat database sesuai dengan nama database yang ada pada .env atau yang telah ditentukan pada phpmyadmin atau DBMS MySQL lainnya
-
Migrasi database menggunakan perintah
php artisan migrate
Jika menggunakan database MongoDB yang telah saya sediakan, tolong jalankan seeder untuk mengisi data awal pada database yang menyimpan data akun user (admin dan staff) juga data barang yang sesuai dengan log aktivitas
php artisan db:seed --class=UsersTableSeeder php artisan db:seed --class=BarangSeeder
-
Jalankan perintah
npm run build
untuk membangun tailwind css ui atau menjalankan perintahnpm run dev
untuk membuat server live tailwind CSS -
Pada terminal yang berbeda, jalankan perintah
php artisan serve
untuk memulai server Laravel 10
Setelah langkah-langkah di atas selesai, proyek Laravel 10 Anda harus siap digunakan. Pastikan untuk membaca dokumentasi Laravel resmi dan mengacu pada instruksi yang diberikan oleh pengembang proyek jika ada langkah-langkah khusus yang perlu dilakukan.
- Pastikan untuk membaca dokumentasi instalasi untuk setiap requirement sesuai dengan sistem operasi yang digunakan, karena ada beberapa cara instalasi yang berbeda tergantung pada sistem operasinya.
- Jika Anda menggunakan XAMPP di Linux dan terdapat dua versi PHP yang berbeda, disarankan untuk menginstal ekstensi MongoDB pada PHP sistem dan PHP XAMPP. Hal ini disebabkan oleh lokasi instalasi Composer, di mana Composer akan menggunakan PHP dari sistem.