PHP : Membuat REST API dengan Slim Framework

By -

Intro


Slim Framework adalah microframework PHP yang dapat digunakan untuk membuat REST API. Slim Framework relatif mudah dipelajari dan sederhana konfigurasinya, namun bila membutuhkan tambahan seperti security layer masih susah kalau memakai Slim Framework. Alternatif lain untuk membuat REST API menggunakan PHP di antaranya adalah menggunakan Lumen yang "sekeluarga" dengan Laravel.

Membuat Database


Buat database dengan nama db_kuliah
CREATE DATABASE db_kuliah;
CREATE TABLE `tbl_mahasiswa` (
`nim` varchar(10) NOT NULL,
`nama` varchar(60) NOT NULL,
`alamat` varchar(300) DEFAULT NULL
);
INSERT INTO `tbl_mahasiswa` (`nim`, `nama`, `alamat`) VALUES
('M1453277', 'mahasiswa 1', 'Solo'),
('M1453278', 'mahasiswa 2', 'Klaten'),
('M1453279', 'mahasiswa 3', 'Sukoharjo');
view raw gistfile1.txt hosted with ā¤ by GitHub

Install Composer

Untuk dapat menggunakan Slim Framework, terlebih dahulu harus menginstall composer. Composer adalah tool dependency manager (tool untuk mendownload library / framework PHP). Tata cara instalasi composer dapat dibaca di https://getcomposer.org/download.

Install Slim Framework

Buat folder untuk menyimpan file-file web service + Slim Framework Masuk ke folder yang telah dibuat sebelumnya, install Slim Framework menggunakan perintah 
composer require slim/slim "^3.0"

Buat file classes/Mapper.php dengan isi script sebagai berikut
<?php
// abstract class PHP untuk memuat object db
// dari class ini diturunkan ke class lain untuk melakukan query db
abstract class Mapper {
protected $db;
public function __construct($db) {
$this->db = $db;
}
}
view raw Mapper.php hosted with ā¤ by GitHub

Buat file classes/MahasiswaMapper.php, file ini digunakan untuk melakukan query database. Hasil query database nantinya akan diakses melalui alamat URL web service oleh aplikasi lain misalnya aplikasi Android. Isi script classes/MahasiswaMapper.php adalah sebagai berikut
<?php
// class untuk melakukan query db ke tabel tbl_mahasiswa
class MahasiswaMapper extends Mapper
{
// mengambil semua record di tbl_mahasiswa
public function getAllMhs() {
$sql = "SELECT * from tbl_mahasiswa";
$stmt = $this->db->query($sql);
$results = $stmt->fetchAll();
return $results;
}
// mengambil record dari tbl_mahasiswa berdasarkan nim mahasiswa
public function getMahasiswaByNim($nim) {
$sql = "SELECT * from tbl_mahasiswa where nim = :nim";
$stmt = $this->db->prepare($sql);
$result = $stmt->execute(["nim" => $nim]);
if($result) {
return $stmt->fetch();
}
}
// memasukkan data mahasiswa baru ke tbl_mahasiswa
public function saveMahasiswa($nim, $nama, $alamat) {
$sql = "insert into tbl_mahasiswa
(nim, nama, alamat) values
(:nim, :nama, :alamat)";
$stmt = $this->db->prepare($sql);
$result = $stmt->execute([
"nim" => $nim,
"nama" => $nama,
"alamat" => $alamat,
]);
if(!$result) {
throw new Exception("could not save record");
}
}
// mengupdate data mahasiswa
public function updateMahasiswa($old_nim, $nim, $nama, $alamat) {
$sql = "update tbl_mahasiswa set nim = :nim, nama = :nama, alamat = :alamat where nim = :old_nim";
$stmt = $this->db->prepare($sql);
$result = $stmt->execute([
"old_nim" => $old_nim,
"nim" => $nim,
"nama" => $nama,
"alamat" => $alamat,
]);
if(!$result) {
throw new Exception("could not update record");
}
}
// menghapus data mahasiswa
public function deleteMahasiswa($nim) {
$sql = "delete from tbl_mahasiswa where nim = :nim";
$stmt = $this->db->prepare($sql);
$result = $stmt->execute([
"nim" => $nim
]);
if(!$result) {
throw new Exception("could not delete record");
}
}
}
view raw MahasiswaMapper.php hosted with ā¤ by GitHub


Buat file index.php untuk membuat URL dengan isi script sebagai berikut
<?php
use \Psr\Http\Message\ServerRequestInterface as Request;
use \Psr\Http\Message\ResponseInterface as Response;
require __DIR__ . '/vendor/autoload.php';
$config['addContentLengthHeader'] = false;
$config['displayErrorDetails'] = true;
// host atau alamat server mysql, bisa gunakan ip address
$config['db']['host'] = "localhost";
// username mysql
$config['db']['user'] = "username";
// password mysql
$config['db']['pass'] = "password";
// nama database
$config['db']['dbname'] = "db_kuliah";
$app = new \Slim\App(["settings" => $config]);
$container = $app->getContainer();
// memasukkan setting db
$container['db'] = function ($c) {
$db = $c['settings']['db'];
$pdo = new PDO("mysql:host=" . $db['host'] . ";dbname=" . $db['dbname'],
$db['user'], $db['pass']);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
return $pdo;
};
/* URL http://[host]/[namafolder]
method GET
menampilkan tulisan API Mahasiswa */
$app->get('/', function(){
echo "API Mahasiswa";
});
/* URL http://[host]/[namafolder]/mahasiswa/all
method GET
menampilkan data semua mahasiswa dari database */
$app->get('/mahasiswa/all', function(){
$mapper = new MahasiswaMapper($this->db);
$mahasiswa = $mapper->getAllMhs();
return json_encode($mahasiswa);
});
/* URL http://[host]/[namafolder]/mahasiswa/{nim}
method GET
menampilkan mahasiswa sesuai nim yang dimaksud */
$app->get('/mahasiswa/{nim}', function (Request $request, Response $response, $args) {
$mapper = new MahasiswaMapper($this->db);
$mahasiswa = $mapper->getMahasiswaByNim($args['nim']);
return json_encode($mahasiswa);
});
/* URL http://[host]/[namafolder]/mahasiswa/new
method POST
menambahkan data mahasiswa
pakai header
Content-type: application/json
contoh request body
{
"nim":"m2",
"nama":"nama2",
"alamat":"alamat2"
}
*/
$app->post('/mahasiswa/new', function (Request $request, Response $response) {
$data = $request->getParsedBody();
$mapper = new MahasiswaMapper($this->db);
$mapper->saveMahasiswa($data['nim'], $data['nama'], $data['alamat']);
$obj = (object) [
'status' => strval($response->getStatusCode())
];
echo json_encode($obj);
});
/* URL http://[host]/[namafolder]/mahasiswa/update/{old_nim}
method PUT
mengubah data mahasiswa sesuai nim yang dimaksud
pakai header
Content-type: application/json
contoh request body
{
"nim":"m3",
"nama":"nama2",
"alamat":"alamat3"
}
"old_nim":"m3"
old_nim ditambahkan ke url
*/
$app->put('/mahasiswa/update/{old_nim}', function (Request $request, Response $response, $args) {
$data = $request->getParsedBody();
$mapper = new MahasiswaMapper($this->db);
$mapper->updateMahasiswa($args['old_nim'], $data['nim'], $data['nama'], $data['alamat']);
$obj = (object) [
'status' => strval($response->getStatusCode())
];
echo json_encode($obj);
});
/* URL http://[host]/[namafolder]/mahasiswa/{nim}
method DELETE
menghapus mahasiswa sesuai nim yang dimaksud */
$app->delete('/mahasiswa/{nim}', function (Request $request, Response $response, $args) {
$mapper = new MahasiswaMapper($this->db);
$mahasiswa = $mapper->deleteMahasiswa($args['nim']);
$obj = (object) [
'status' => strval($response->getStatusCode())
];
echo json_encode($obj);
});
$app->run();
view raw index.php hosted with ā¤ by GitHub


Ubah file composer.json, ketik
{
"require": {
"slim/slim": "^3.0"
},
"autoload": {
"psr-4": {
"": "classes/"
}
}
}
view raw composer.json hosted with ā¤ by GitHub


Ketik perintah
composer dump-autoload
Agar file php di dalam folder classes dimuat secara otomatis oleh framework

Testing web service

Gunakan aplikasi web service client, misalnya Postman https://www.getpostman.com/

Comments

Post a Comment

Popular posts from this blog

Contoh Inheritance (Pewarisan) di Java

By -
Image
diupdate 24 November 2023 Inheritance atau pewarisan, dalam paradigma pemrograman berorientasi objek bisa diartikan membuat suatu class yang mirip seperti class yang lain. Ada class yang ditiru (class induk / parent / superclass) dan ada class hasil tiruan / hasil turunan (class child / subclass). Subclass akan mewarisi atribut dan method-method yang ada pada superclass. Contoh inheritance atau pewarisan dalam OOP misalnya sebagai berikut. Ada class Karyawan yang memiliki atribut NIP, nama, dan jenis kelamin serta dua buah method yaitu masukKerja() dan beriNama(String nama). Apabila digambarkan dalam class diagram seperti berikut Dibuat source code dalam bahasa pemrograman Java sebagai berikut Dibuat class baru yaitu Dosen, class Dosen adalah turunan dari class Karyawan. Dalam bahasa pemrograman Java untuk membuat pewarisan digunakan keyword extends ketika menuliskan deklarasi class (lihat baris ke tiga di source berikut). Class Dosen akan mewarisi atribut NIP, nama, dan je...
Read more

Review Singkat Pilihan Transportasi Umum Rute Solo - Wonosobo

By -
Image
foto terminal Mendolo Wonosobo Karena satu hal, saya cukup sering bolak balik Solo - Wonosobo. Jarak dua kota tersebut cukup jauh, sebenarnya bisa saja ditempuh dengan kendaraan pribadi seperti sepeda motor namun kadang untuk meminimalisir rasa capek akibat mengemudi saya memilih naik kendaraan umum. Terdapat beberapa pilihan moda transportasi umum untuk rute Solo - Wonosobo. Sejumlah bus AKAP asal Jawa Timur saat ini telah memperluas jangkauannya hingga mencapai Purbalingga, kita dapat memilih naik Eka atau Sugeng Rahayu jurusan Purbalingga yang melalui Wonosobo. Bus-bus AKAP ini cukup nyaman dengan fasilitas standar bus PATAS Jawa Timuran : AC dingin, interior terawat, dan tidak ketinggalan full music Jawa.  Dari segi harga, saya sudah agak lupa karena sudah lama tidak naik bus ini, namun kalau saya tidak salah ingat saat ini untuk jurusan Solo - Wonosobo sudah tembus di atas 100 ribu rupiah. Kenaikan harga BBM yang kemudian diikuti pandemi Covid-19 berkontribusi mengerek tarif b...
Read more

Pembahasan UTS Mata Kuliah Pemrograman Berorientasi Objek 2022

By -
Image
Berikut ini adalah pembahasan soal UTS mata kuliah Pemrograman Berorientasi Objek program studi Informatika UNS tahun 2022. Pembahasan soal no 1 : float hitung() { float x = 2f * f1; } Sebelum method hitung() ditulis tipe float, jadi method tersebut memiliki return value berupa float. Namun pada source code belum ditulis return valuenya misal diperbaiki menjadi float hitung() { float x = 2f * f1; return x; } Catatan : Mahasiswa banyak menuliskan mengenai perlunya main method ā†’ Main method tidak wajib ada pada sebuah class. Apabila sebuah class tidak memiliki main method, source code tidak akan error namun apabila source code dijalankan tidak ada yang dieksekusi. Sejumlah jawaban juga menyoroti penulisan 2f pada float x = 2f * f1; 2f tersebut adalah angka 2 yang ditulis sebagai float, bukan merupakan kesalahan penulisan code. - - - - - - - - - - - - - - - - - - Pembahasan  soal no 2  : Yang wajib ada adalah penggunaan keyword untuk perulangan, misalnya bisa ...
Read more