📘 Modul 01: Persyaratan Sistem & Instalasi
Selamat datang di dokumentasi resmi Pakem Framework! Modul ini membahas semua hal yang Anda butuhkan untuk memulai pengembangan aplikasi dengan Pakem dari awal.
1. Persyaratan Sistem (System Requirements)
Sebelum menggunakan Pakem, pastikan sistem komputer Anda telah terpasang:
- Rust Compiler & Cargo: Versi 1.75+ (Stable).
- Cek versi:
rustc --versiondancargo --version - Panduan instalasi: rustup.rs
- Cek versi:
- Database Engine (Pilih salah satu atau beberapa sesuai kebutuhan):
- SQLite: Cocok untuk pemula, prototyping cepat, zero-config tanpa server database tambahan.
- PostgreSQL: Direkomendasikan untuk production berkinerja tinggi.
- MySQL / MariaDB: Alternatif populer untuk aplikasi web standar.
- Git: Untuk inisialisasi repositori otomatis dan version control.
- (Opsional) WebAssembly Target: Jika Anda ingin mengembangkan plugin WASM:bash
rustup target add wasm32-unknown-unknown
2. Instalasi Pakem CLI (canting)
Pakem dilengkapi dengan toolchain Command Line Interface (CLI) bawaan yang elegan dan canggih bernama pakem.
Cara 1: Pasang Global via Crates.io
cargo install canting --forceCara 2: Pasang Langsung dari Repositori GitHub Resmi
cargo install --git https://github.com/pakem-rs/framework.git canting --forceSetelah instalasi selesai, verifikasi dengan menjalankan:
pakem --version
pakem --helpCara 3: Auto-Upgrade Toolchain & Dependensi Proyek
canting upgradeCara 4: Instalasi Lokal dari Source Code
Jika Anda berkontribusi atau memodifikasi source code Pakem:
# Clone repositori framework
git clone https://github.com/pakem-rs/framework.git
cd framework
# Install biner CLI ke lingkungan Cargo lokal
cargo install --path canting --force3. Membuat Proyek Baru (canting new)
Pakem menyediakan flag --db untuk mengonfigurasi driver database dan file .env secara instan, serta memangkas waktu kompilasi cargo build awal hingga 45%.
Opsi A: SQLite (Tercepat, Zero-Config)
canting new my-blog --db sqliteOtomatis membuat file
database.sqlitedan menyiapkan dependensi SQLite yang ramping.
Opsi B: PostgreSQL (Production Ready)
canting new enterprise-app --db postgresMenyiapkan driver PostgreSQL berkinerja tinggi dan template koneksi standard.
Opsi C: MySQL / MariaDB
canting new store-app --db mysqlOpsi D: Microsoft SQL Server (MSSQL Enterprise)
canting new enterprise-app --db mssqlMenyiapkan driver pure-Rust TDS Tiberius berkecepatan tinggi tanpa memerlukan instalasi driver ODBC Microsoft eksternal di sistem operasi.
Opsi E: Multi-Driver (Semua Driver Aktif)
canting new portal-app --db all4. Struktur Direktori Proyek
Pakem menerapkan arsitektur Model-View-Controller (MVC) yang terorganisir rapi dan intuitif:
my-app/
├── app/
│ └── scripts/ # Skrip Indonesian Script (.is) backend
├── database/
│ ├── migrations/ # File migrasi SQL skema tabel
│ └── seeders/ # Data seeding untuk pengujian/dummy
├── plugins/ # Plugin WebAssembly (.wasm) dan source plugin
├── public/ # Static assets publik (gambar, font, favicon)
├── resources/
│ ├── css/ # Stylesheet CSS kustom
│ ├── js/ # JavaScript frontend
│ └── views/ # Template Blade (.blade.rs)
│ ├── layouts/ # Layout dasar (@extends)
│ └── auth/ # Halaman login, register, profil
├── src/
│ ├── app/
│ │ ├── controllers/ # Controller handlers HTTP
│ │ ├── models/ # Model data (PakemModel derive)
│ │ ├── requests/ # Validasi Form/JSON request
│ │ └── services/ # Business logic layer
│ ├── routes/
│ │ ├── api.rs # Endpoint RESTful API
│ │ └── web.rs # Route halaman web
│ └── main.rs # Entrypoint server aplikasi
├── storage/
│ ├── app/public/ # Berkas upload user
│ ├── cache/ # Cache aplikasi
│ └── logs/ # File log perputaran harian
├── .env # Konfigurasi environment lokal aktif
├── .env.example # Template konfigurasi environment
└── Cargo.toml # Dependensi Rust & Cargo crate5. Konfigurasi Environment (.env)
File .env otomatis digenerate saat project dibuat. Contoh konfigurasi SQLite:
# Pengaturan Aplikasi
APP_NAME=Pakem
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost:8000
APP_KEY=pakem-super-secret-key-change-me-in-production
# Logging
LOG_LEVEL=info
LOG_TO_FILE=true
# Database Configuration (SQLite)
DB_CONNECTION=sqlite
DB_DATABASE=./database.sqlite
DATABASE_URL=sqlite:./database.sqlite
# Session & JWT
JWT_SECRET=pakem-jwt-secret-key-change-me-in-production
RATE_LIMIT_MAX=60
RATE_LIMIT_WINDOW=606. Menjalankan Server Aplikasi
Masuk ke folder proyek yang baru dibuat:
cd my-blogMenjalankan Server Standar:
canting serve
# atau langsung menggunakan: cargo runMenjalankan Server dengan Auto-Reload (Hot-Reloading):
Jika Anda menginstal cargo-watch, server akan otomatis restart setiap kali Anda menyimpan perubahan kode:
canting watchBuka browser Anda dan akses: 👉 http://localhost:8000
Navigasi Modul:
- Berikutnya: Modul 02: Routing & Middleware ➔
- Kembali ke: Daftar Isi Dokumentasi