Ini proyek yang gw bikin buat kebutuhan Uji Kompetensi RPL Tahun 2019. At least part of it secara sekolah gw yang 4 tahun studinya minta 2 platform dan ini bagian web + API-nya
Proyek ini dibikin pake framework PHP laravel jadi perlu diperhatikan hal-hal di bawah ini
- PHP versi 7.2 atau lebih baru (lengkapnya bisa diliat disini)
- Database SQL (MySQL, MariaBD, Postgre, etc);
- Kalo gamau males intall 2 benda di atas boleh install paket AMP(Apache + MySQL/MariaDB + PHP). Buat Windows boleh install WAMP (ga recommend), macOS direkomendasikan install MAMP, lainnya boleh install XAMPP (berlaku untuk Windows, Linux, dan macOS)
- Composer (bisa dicari disini)
- Git (Gawajib tapi sangat disunnahkan untuk menginstall karena kalo gw update gaperlu download ulang proyeknya. Download disini)
TL:DR Gimanapun caranya yang penting ada di komputer kalian
Paling praktis tapi ngga recommended karena kalo ada update seluruh proyeknya mesti didownload ulang
Ini cara yang sangat disarankan karena kalo ada update cuma bagian yang diupdate yang mesti didownload dan kalian bisa ikut kolaborasi buat ngembangin proyek ini sampe jadi atau take it to the next level.
Install git kalo belum ngistall. Buka terminal/Command Prompt/PowerShell terus ketik perintah di bawah abis itu pencet enter
git clone https://github.com/bondanrsantoso/ujikom-rpl-inventaris.git
Kalo saya kebetulan update atau kalian notice ada update di repository masukin perintah di bawah terus pencet enter
git pull
Ada kalanya perintah di atas gagal. Apabila ini terjadi copy project yang telah dikerjakan ke folder lain sebagai backup kemudian (masih di folder project yang lama) masukkan perintah di bawah satu-persatu
git stash
git fetch --all
git reset --hard origin/master
Catatan buat perintah di atas itu mesti dimasukin dengan proyek ini sebagai direktori aktif di terminal/command prompt/powershell. Contohnya proyek kalian disimpen di direktori ~/proyek/ujikom-rpl-inventaris
atau C:\proyek\ujikom-rpl-inventaris
buat kalian yang pake Windows.
Kalo di Command Prompt/Powershell windows jadinya begini
C:\> cd "\proyek\ujikom-rpl-inventaris"
C:\proyek\ujikom-rpl-inventaris> git pull
Kalo di terminal sh
(Linux/macOS)
#Kalo di linux tampilannya kaya begini kira-kira:
user@localhost:~$ cd ~/proyek/ujikom-rpl-inventaris
user@localhost:~/proyek/ujikom-rpl-inventaris$ git pull
#Kalo di macOS tampilan standarnya begini
Users-MacBook-Pro:~ User$ cd ~/proyek/ujikom-rpl-inventaris
Users-MacBook-Pro:ujikom-rpl-inventaris User$ git pull
Abis proyek ini ada di komputer kalian, boleh (baca: harus) disetup dulu laravel-nya biar bisa running
-
Install PHP+Database (atau pake paket AMP) kalo belum
-
Install Composer kalo belum
-
Masuk ke direktori tempat proyek ini disimpen (liat instriksi di atas yang judulnya Side note kalo gapaham)
-
Di Terminal/Command Prompt/Powershell masukin perintah di bawah
composer install
-
Copy file
.env.example
abis itu rename hasil copy-annya jadi.env
- Catatan: file yang di depannya dikasih tanda titik itu otomatis tersembunyi di UNIX, Linux dan macOS
- Catatan buat pengguna Windows: nge-rename file jadi
.env
itu gadibolehin sama Explorer jadi mending nge-rename via text editor atau IDE favorit kalian (Sublime Text, VS Code, PHPStorm, Atom, etc) - Catatan buat pengguna macOS: file tersembunyi ngga bisa ditampilin di Finder. kalupun bisa itu tricky dan ga worth the hassle jadi mending pake metode ala Windows
-
Abis itu generate security key buat kebutuhan session (ini wajib, soalnya kalo nggak app laravel-nya gamau running)
-
Nyalain Database kalian
-
Bikin databse baru buat nampung data dari aplikasi ini (bisa pake GUI bar ga ribet ala PHPMyAdmin, Sequel Pro, Navicat, etc), kasih nama
ujikom
misalnya -
Edit file
.env
buat konfigurasi. Terutama konfigurasi database contohnya di bawahDB_CONNECTION=mysql # Ganti kalo pake DB lain selain MySQL/MariaDB DB_HOST=127.0.0.1 # bisa juga localhost DB_PORT=3306 # ganti kalo perlu DB_DATABASE=ujikom DB_USERNAME=usernameDatabase DB_PASSWORD=PasswordSuperRahasia
-
Karena udah ada file migrasi database laravel, masukin perintah di bawah ini di terminal/command prompt kalian
php artisan migrate # kalo perintah di atas gagal masukin yang bawah php artisan migrate:fresh
-
Kalo udah siap running masukin perintah
php artisan serve
di terminal/command prompt -
Enjoy
Biar makin cepet beres boleh dibantu pengembangannya buat yang pake git dengan nge-push hasil kerja kalian ke repository ini dengan perintah di bawah (masukinnya sebaris sebaris). Tapi jangan di branch master
. Branch master
cuma buat kode yang udah verified.
Maka dari itu ada baiknya bikin branch baru (namanya bebas, tapi buat contoh disini namanya nama-branch
) dengan perintah di bawah ini (masukin sebaris-sebaris):
git branch nama-branch
git checkout nama-branch
Catatan: Perintah di atas bakalan gagal kalo kalian udah terlanjur coding. cara mengatasinya adalah dengan perintah berikut:
git branch nama-branch
git stash
git checkout nama-branch
git stash pop
Kemudian kalo udah siap dibagi sama yang lain masukin perintah di bawah
git add .
git commit -m "pesan commit. contohnya: nambah fungsi blabla. maks 72 karakter"
git push origin nama-branch
Kalo misalnya ada update di branch master
dan kalian mau lanjut develop dari situ, push hasil kerja kalian terlebih dahulu (lihat perintah di atas) abis itu masukin perintah di bawah ini sebaris-sebaris:
git checkout master
git pull
git branch -C master nama-branch
Kalo menurut kalian aplikasi ini bisa taken to the next level ada baiknya kalian fork repository ini dan lanjut develop disana
Ini adalah proyek yang saya buat untuk uji kompetensi RPL jaman tahun 2019. Kalo kalian kebetulan perlu proyek ini buat belajar silahkan pakai proyek ini sesuka kalian dengan mematuhi guideline yang sudah ditetapkan di atas. Kalo kebetulan kalian nge-fork dan publish aplikasi ini di bawah nama kalian, it's good tapi jangan lupa untuk mencantumkan keterangan bahwa projek kalian itu di-fork dari repository ini. Happy Coding!