Web Services, mungkin sudah sering terdengar ungkapan ini, tetapi sekitar 2-3 bulan lalu akhirnya saya menggunakannya dalam lingkungan project. Singkatnya banyak sekali aplikasi berbasiskan web dengan berbagai macam latar belakang platform, dan juga OS. Celakanya adalah mereka terkadang tidak memberi akses ke database yang digunakan(atau mungkin gw ga tau DB apa yang mereka gunakan), mereka hanya memberikan sebuah interface untuk menerima atau mengirim data. Secara programing agaknya ga mungkin kita melakukan parsing HTML saja karena kita tidak bisa mendapatkan data dari si sumber data, kalaupun bisa, hasilnya tidak akan akurat.

Dari sinilah lahir namanya web services. Dulu jaman kuliah, web services ini pernah disinggung waktu belajar ASP.net hanya saat itu masih blurry, saya tidak ngerti fungsinya karena dosen cuman menjelaskan bagaimana buatnya dan gunanya untuk transfer data ke system lain, tetapi dosen tidak memberikan contoh paling tidak saat dua cross platform saling bertukar data melalui web services tersebut sehingga paling tidak saya ada gambaran.

Ada beberapa jenis metode menggunakan web service. Paling sederhana adalah XMLRPC dan yang lebih advanced adalah SOAP. keduanya menggunakan media format XML untuk bertukar data. Dalam tutorial ini, saya akan mencoba menerangkan penggunaan XMLRPC dalam PHP menggunakan sebuah library yang sangat sederhana yang dapoat diambil disini.

XMLRPC sendiri sudah banyak yang menggunakannya walau belum dipatentkan oleh W3C, contohnya oleh WordPress(dengan blogging aplikasinya seperti halnya di Microsoft Word 2007  atau ada juga aplikasi untuk OS mobile seperti Android, iPhone, etc), bloger, etc.

Tutorial akan terbagi menjadi 2 bagian besar, yaitu Bagian Server dan Bagian Client. Bagian Client nanti akan merequest ke Server sebuah action dengan mengirim parameter atau hanya sekedar merequest saja, sedangkan server akan menerima request dan melakukan proses. Apabila Method/action yang diminta terdaftar maka server akan melakukan tugasnya dan mereturn sesuatu untuk kembali dibaca oleh si client, apabila method yang diinginkan tidak terdaftar maka server akan mengembalikan error value.

Yang dibutuhkan dalam tutorial ini adalah:

1. Web Server Apache + PHP (simple, using XAMPP kalau tidak tahu cara installnya)
2. XML-RPC Library for PHP (download disini)
3. Text editor seperti Notepad++ atau Adobe Dreamweaver atau Notepad biasa apabila terpaksa

Sebelum memulai tutorial ini ada baiknya kita membuat sebuah folder di dalam folder di folder htdocs(apabila menggunakan XAMPP) dnegan nama “xmlrpc” kemudian buatlah 2 buah folder lagi di dalamnya bernama “server” dan “client” dimana nantinya folder server akan berisi file untuk XMLRPC-server side dan folder client akan berisi file-file untuk XMLRPC-client side.

Kemudian buatlah sebuah database mysql baru(dalam contoh ini saya menggunakan nama database ‘tutorial‘) dan import file dump ini ke dalam mysql.

SERVER SIDE

Copy-kan file XML-RPC Library yang sudah di download ke folder server. Dan rename menjadi “xmlrpc-func.php”. Kemudian logikanya karena Server nantinya yang akan berhubungan dengan database, maka kita harus buat sebuah file yang akan mempersiapkan koneksi ke database dan juga meng-include semua library yang kita buat nantinya.

Sebelumnya kita buat dulu 3 php file dengan nama “index.php”, “xmlrpc_proc.php”, ”app_load.php”. Sehingga susunan isi folder akan menjadi seperti berikut ini:

Funsgi masing-masing file adalah sbb:

1. app_load.php: akan melakukan koneksi ke database, dan menginclude library file serta file yang berisi fungsi-fungsi yang akan di execute oleh XMLRPC server.
2. index.php: index file yang akan menjadi front-end XMLRPC server. Semua request untuk XMLRPC akan menuju ke file ini.
3. xmlrpc-func.php: Library XMLRPC yang dibuat oleh Keith Devens.
4. xmlrpc_proc.php: adalah file berisi method-method/action yang dapat dipanggil oleh client.

Okay, pertama-tama mari kita buat dulu isi untuk file app-load.php. Fungsi utama file ini adalah seperti dituliskan diatas, yaitu mengkoneksikan ke database, dan meng-include file-file library yang dibutuhkan.

Penjelasan:

Line 10 : connect ke mysql
Line 11 : memilih database “tutorial”
Line 12 : including xmlrpc library
Line 21 : Including xmlrpc server action/method

Save file tersebut kemudian sekarang kita akan buat content file kedua yaitu “xmlrpc_proc“. File ini akan berisi 4 buah fungsi. Tiga fungsi untuk method/action yang digunakan oleh XMLRPC melayani request dari client dan 1 adalah fungsi untuk mereturn pesan error saat method/action yang direquest tidak terdaftar.

Bagian yang penting dalam file ini:

1. Line 6 – 10 : kita daftarkan method yang dapat diakses oleh client dalam variable “$xmlrpc_methods”. Dimana key array merupakan nama alias fungsi method/action untuk client, sedangkan valuenya merupakan nama fungsi internal yang akan diexecute oleh XMLRPC.
2. Line 15 : merupakan function get_sum_data, yang nantinya akan berfungsi untuk pemanggilan request method “exec.get_sum_data” oleh client yang akan mengembalikan jumlah record dalam database.
3. Line 23 : fungsi untuk memberikan response ke client dengan mengembalikan value yang direquest dalam fungsi ini(jumlah record dalam table database).
4. Line 29: fungsi load_list_limit, digunakan untuk mengambil data sejumlah yang direquest dari client(apabila method yang direquest adalah ‘exec.module_load_all_list_limit‘). Dalam fungsi ini, fungsi menerima parameter berjenis array dimana index ’0′ berisi offset data mulai akan mulai diambil. Sedangkan offset ’1′ merupakan jumlah data yang akan diambil.
5. Line 43: mengembalikan response ke client dengan jenis array berisi hasil query sejumlah yang dihasilkan berdasarkan parameter yang dikirimkan.
6. Line 49: merupakan function load_single. Yang mana diexecute apabila client merequest method/action “exec.module_load_single” fungsinya adalah untuk mengambil detail 1 row dari data. Fungsi ini menerima 1 buah parameter berjenis integer yang merupakan primary key value row yang akan diambil.
7. Line 53: di line 51 kita validasikan apakah id yang terkirim adalah berupa numerik atau bukan. Apabila bukan maka kita harus response kembali ke client sebuah pesan error. Maka di line 53 ini adalah contoh memberikan respons ke client untuk [pesan error, kita beri error number 3 untuk ini(Nomor error dapat dimodifikasi sesuai selera Anda ).
8. Line 61: Mengirimkan response ke client berisi data detail satu buah row yang direquest oleh client.
9. Line 65: fungsi XMLRPC_method_not_found, dimana fungsi ini akan di-execute apabila method/action yang direquest tidak ditemukan.

Save file tersebut. Sekarang mari kita buat file untuk front-end XMLRPC servernya

Bukalah file "index.php" dan isilah contentnya seperti berikut ini:

Keterangan isi file:

1. Line 10 : meng-include semua library yang sudah di load dalam file "app_load.php".
2. Line 12: melakukan parsing XML terhadap request post.
3. Line 16: mengambil nama method yang direquest oleh client
4. Line 22: Mendapatkan parameter yang dikirim oleh Client.
5. Line 33: kita cek apakah method yang diminta oleh client(lihat line 16), terdaftar atau tidak.
6. Line 35: Apabila method/action yang direquest tidak ada, maka panggil fungsi untuk meresponse dengan fungsi "XMLRPC_method_not_found" supaya client tahu bahwa method/action yang dia request tidak ditemukan.
7. Line 41-45: Apabila Method ditemukan maka panggil alias fungsi alias dari method yang direquest oleh client beserta parameter yang dikirimkan.

Awalnya saya bingung bagaimana PHP bisa memanggil fungsi kalau kita tahu nama fungsinya dalam string seperti contoh di atas? Setelah mencari tahu, PHP memiliki keunikan yang bisa dibilang cukup praktis. cobalah coding berikut ini:

Cara ini selain dapat digunakan untuk function, dapat juga untuk classes dan juga variable sendiri

Apabila Anda mengaksesnya ke alamat: 'http://localhost/xmlrpc/server/' Maka Anda akan melihat seperti ini dalam browser Anda:

Okay, sampai sini XMLRPC server telah selesai kita buat, pada step berikutnya kita akan membuat Client yang merequest ke server ini.

CLIENT SIDE

Sisi Client adalah bagian yang mana nantinya akan merequest ke server berdasarkan method-method yang diijinkan oleh server. Untuk memulai membuat client, coopy-kan file "xmlrpc-func.php" ke folder client, kemudian buatlah sebuah file bernama "index.php" di folder client sehingga isi dari folder client kurang lebih sebagai berikut.

Bukalah file "index.php" kemudian isilah contentnya seperti berikut ini:

Keterangan file ini:

1. Line 7: Include Library yang dibutuhkan.
2. Line 9: Masukan alamat host server XMLRPC. tanpa prefix "http://", apabila tidak menggunakan port http default(80), tambahkan pula disini. Misalkan alamat XMLRPC servernya adalah "http://www.xmlrpc-server.com:8080" maka masukan valuenya "www.xmlrpc-server.com:8080"
3. Line 10: Masukan alamat tempat XMLRPC server berada, dalam kasus contoh tutorial ini: "/xmlrpc/server/index.php"
4. Line 12: Optional, set  ke 1 apabila ingin mengaktifkan fasilitas debuging. Untuk melakukan debug, Anda dapat memanggil fungsi "XMLRPC_debug_print()" setelah merequest sesuatu dari server. Funsgi ini sangat baik untuk melakukan tracing error saat server mengembalikan value yang tidak semestinya(entah blank atau mengembalikan value true tetapi return valuenya kosong).
5. Line 17-30: Contoh merequest method yang tidak mengirimkan parameter apapun, dan mengembalikan single value. pada Line 19: Melakukan request method/action 'exec.get_sum_data' dan menampung return value dalam variable. Return variable dari fungsi ini selalu berupa array berisi 2 index. Index pertama akan mengembalikan value sukses atau tidaknya pemanggilan request. Apabila error dari server karena mugnkin method tidak ada, maka index pertama ini akan mengembalikan value FALSE, apabila berhasil maka akan mengembalikan value TRUE.
   CATATAN: terkadang apabila Server sukses dihubungi tetapi mungkina da salah syntax error, maka fungsi ini akan mengembalikan TRUE pada index pertama. Gunakan fungsi debuging untuk melihat error-nya
6. Line 37-50: Melakukan request dengan mengirimkan satu parameter tunggal. Request contohnya ada di line: 38. Result return value akan berupa array.
7. Line 56-71: Contoh request method "exec.module_load_all_list_limit", dimana mengirimkan parameter berupa array. Value yang dikembalikan berupa array multidimensi.
8. Line 74-84: Contoh request method/action yang tidak terdaftar pada server, yang kemudian akan mengembalikan pesan error.

Apabila kita perhatikan dari contoh client ini, maka dapat dilihat untuk melakukan request ke server XMLRPC ini sungguh amat simple, yaitu hanya dengan memanggil sebuah fungsi bernama XMLRPC_requesst dengan detail:

XMLRPC_request ($site, $location, $methodName,[[ $params = NULL], $user_agent = NULL])

1. $site : Berjenis string, berisi alamat IP atau host dari XMLRPC server
2. $location: Berjenis string, berisi alamat ke XMLRPC server file. detailnya sbb:
   
3. $param: parameter yang dikirimkan, apabila berjenis array, gunakan fungsi “XMLRPC_prepare($arr_parameter_tobe_send)”
4. $user_agent: User Agent alias

Return value akan berupa array index pertama merupakan indikasi apakah request berhasil atau tidak.  Apabila berhasil, maka akan mengembalikan TRUE apabila tidak akan berisi FALSE*. Pada INdex berikutnya apabila berhasil, maka akan mengembalikan value yang dikembalikan dari XMLRPC server(dapat berupa string, integer, atau array, dll). Sedangkan apabila gagal akan mengembalikan array dengan 2 assosiasi index yang pertama adalah “faultCode” dan kedua adalah “faultString”

*Sekali lagi apabila request berhasil tetapi karena mungkin ada kesalah kode pada server sehingga terjadi error syntax, atau kita salah memasukan path Location, index pertama ini akan tetap mengembalikan BOOL TRUE. Tetapi index berikutnya return valuenya kosong. Gunakan Debuging function untuk memeriksa error ini.

Dalam prakteknya, XMLRPC tidak hanya saja untuk bertukar data berupa string seperti contoh di atas. Pada aplikasinya, saya juga menggunakannya untuk transfer data binnary(image, ms Word file, etc) yang berukuran kecil menengah(sekitar under 10MB). Caranya simple saja, kita hanya perlu membaca file yang hendak kita kirim (dengan menggunakan fungsi file_get_contents($filename) kemudian hasilnya kita encrypt dengan menggunakan base64_encode. kemudian string hasil encodingnya dikirim via XMLRPC, kemudian oleh XMLRPC server pada method penerima kita buat fungsi kecil untuk mendecrypt kembali base64 string dengan fungsi base64_decode kemudian hasil stringnya kita simpan ke dalam file dengan menggunankan fopen,fwrite,fclose seperti biasanya). Butuh diingat cara mengirim file binnary menggunakan XMLRPC tidaklah begitu optimal untuk file berukuran besar, terlebih karena melakukan enkripsi ke base64 akan membengkakan size-nya sekitar 30% lebih besar dari string aslinya. Sehingga apabila contohnya kita mengirim 10MB file maka dalam keadaan terenkripsi akan terkirim sekitar 13,5MB string file. tentunya ini dapat menyebabkan overload memory usage pada XMLRPC server. Tetapi apabila mengirim file berukuran kecil saya rasa XMLRPC dapat menghandlenya dengan baik(sekitar <3MB).

Yang perlu diperhatikan adalah transfer dalam XMLRPC, semua string akan dinormalisasi(menggunakan htmlentities), itulah sebabnya apabila kita mentransfer file binnary, kita harus mengencryptnya ke base64 terlebih dahulu agar string tidak dimodifikasi oleh XMLRPC library.

Sekian kiranya tutorial kali ini, semoga berguna, akhir kata, semua file dalam tutorial ini, dapat di download disini. Pastikan edit database connectionnya, serta di bagian client, edit  variable “$xmlrpc_server_host” dan “$xml_rpc_server_path”.

Thankyou

Update & addition

Beberapa pengunjung bertanya langsung pada saya karena program PHP meng-issue-kan warning saat XMLRPC dijalankan. Ini dikarenakan Call By reference pada PHP 5.3++ diberi label deprecated(will be removed in near future), tetapi bukan berarti error, PHP hanya memberitahukan bahwa pada versi-versi berikutnya(entah versi berapa) fasilitas ini akan dihilangkan. tetapi apabila Anda menggunakan library ini untuk urusan di website, Anda tidak perlu begitu kawatir, karena masih banyak yang menggunakan PHP 5.2 daripada PHP 5.3

Untuk menyelesaikan masalah ini, apabila Anda menggunakan PHP 5.3.x (terutama yang menggunakan XAMPP) , Anda perlu merubah 1 buah value di ‘php.ini‘ pada value ‘allow_call_time_pass_reference = off‘ Ubah menjadi ‘allow_call_time_pass_reference = On‘. Kemudian save file ‘php.ini‘ dan restart Apache.

Sudah 1 bulan rasanya tidak pernah nulis disini. Sibuk? mungkin agak sulit menemukan waktu yang tepat untuk sekedar menulis di Blog ini. Kesibukan pasti, sampai di rumah yang ada capek sendiri dan hanya tinggal melepas stress dan terlelap.

Akhir-akhir ini gw sendiri merasakan pengalaman yang tidak pernah gw rasakan sebelumnya dari jaman proyek semasa kuliah sampai 2 tahun lalu. Apabila banyak teman-teman gw yang berujung menjadi developer yang sifatnya ERP, atau website oriented, mungkin gw agak berbeda dengan mereka.

Memang ilmu gw juga ga sejauh mereka, sampai sekarang DBMS yang gw pake masih 2 saja, yaitu masih MySQL atau MSSQL server. Berbeda dengan kebanyakan teman-teman gw yang lain yang sudah menggunakan Oracle, sometimes Postgres SQL. Bahasa pemprograman juga masih ga berbeda, gw masih menggunakan my tiny cuttie PHP. Sesekali waktu gw pengen merambah ke Java, tetapi kondisi sepertinya tidak begitu memungkinkan. Mungkin juga karena salah otak gw yang selalu ingin terus menyempurnakan program yang pernah gw buat. terlebih, gw bukan orang jenius, hanya seorang yang “slow” dalam mengerti.

Kini proyek gw ga jauh dari workflow dan juga pencatatan, serta multiformat file dan lalu lalang file. Mungkin kalau mau sharing apa yang gw pikirkan akhir-khir ini:

Pertama, gw akhirnya melihat perbedaan speed untuk penggabungan antara  2 table atau lebih dengan menggunakan istilah “JOIN” dan Join barbar.

Sebutlah ini Join bar-bar:

SELECT a.field1, b.field1 FROM tbl1 a, tbl2 b WHERE a.id=b.tbl1_ID AND [condition_string]

Sebutlah ini menggunakan sistem JOIN biasa:

SELECT a.field1, b.field1 FROM tbl1 JOIN tbl2 ON tbl1.id = tbl2.tbl1_ID WHERE [condition_string]

Sewaktu kuliah dulu di mata kuliah Sistem Basis Data(atau dulu sama anak Binus disingkat SBD) pertama kali diajarkan adalah menggunakan JOIN bar-bar. Baru kemudian menggunakan JOIN.

Hanya saja pastinya karena namanya aja anak kuliah dan juga JOIN ada embel2nya(Inner, Outer, cross, etc) tentunya anak pemula akan memilih cara bar-bar. Suatu saat temen gw mengatakan bahwa penggunaan Join bar-Bar lebih dan jauh lebih lambat dari menggunakan syntax JOIN.

Tetapi tentu gw ga bisa membuktikan saat itu karena gw ga ada data yang cukup untuk membuktikan itu(males bener gw buat dummy data untuk join yang cukup banyak tablenya), tetapi memang gw pegang rinsip, menggunakan JOIN lebih baik, tetapi sampai sekitar 4 bulan lalu mungkin, saat teman dari Binus menjadi PKL di kantor gw dan mereka menggunakan cara join bar-bar dengan data +/- 13ribu di beberapa table dan gw baru melihat memang 100:1 kecepatannya, jauh lebih cepat JOIN, ga jarang menggunakan select JOIN bar-bar timeout di PHP.

Kedua, Pentingnya Denormalisasi. Oke sebelum beberapa teman gw mengatai gw gw coba jelaskan dulu. Gw bukan orang yang suka ngikutin teori(yeah teori normalisasi 1NF 2 NF dst), tetapi dari dulu gw selalu memisahkan apa yang gw pisah, tidak ada denormalisasi, karena gw males membuat fungsi yang otomatis diexecute saat value diupdate dan gw harus mengupdate juga field lain di table lain yang di denormalisasi(gw pelupa dan ga gitu teliti makanya sering kelupaan). Tetapi beberapa waktu lalu akhirnya gw menyerah dan banyak melakukan denormalisasi setelah menemukan bahwa 31.000 row data di join dengan 35.000 data dijoin lagi dengan sekitar 4-5 table yang rata-rata di atas 20.000 row data(Mysql Database). Walau dilimit sekitar 40 record per halaman, hasil reload halaman nyaris 20-30 detik untuk 1 halaman + beberapa sub query.

User mana yang mau menunggu selama itu, segala upaya indexing sudah dilakukan, tetap membutuhkan at last  sekitar 10-15 detik untuk melakukan load data. Hal yang cukup biadab apabila kita membiarkan user yang kadang tidak sabar untuk melihat dan duduk menunggu meload 1 halaman selama 15 detik.

Akhirnya beberapa bagian yang bisa dibuat denormalisasi, gw denormalisasikan. Bahkan gw menghilangkan beberapa JOIn dan menggunakan script yang dibilang agak konyol tetapi cukup efektif. sebut saja 1 row MemberDetail misalnya, memiliki JOIN sederhana seperti misalnya field “KOTA” yang terhubung ke ID table “CITY”, daripada gw join, lebih baik kalau kita mengurangi JOIN sederhana seperti ini kalau kita menghandle banyak data seperti ini, walau sedikit sumbangsih penambahan performance akan jauh lebih berharga

Pada contoh di atas, gw menggunakan 2 Query, pertama gw query-kan table City dan gw tampung ke Array dengan susunan indexnya berupa PK dari table “City” dengan Value nama kotanya. Pada Loop, untuk field  KOTA gw langsung mereplace ID yang terdapat disana dan mencarinya di di array yang memiliki key tsb dan hasilnya langsung di replace saja. Ini merupakan cara yang cukup sederhana tetapi cukup efektif untuk mengurangi load data berjoin  banyak. Apabila di logika daripada menjoin misalnya 31.000 data ke misalnya 100 data mending kita load 100 data sekali sisanya tinggal dicocokan di 31.000 data.

Ketiga, Sekarang gw melakukan hal yang ga pernah gw lakukan sebelumnya mungkin bsia disebut distributed Computing Level rendah. copntoh kasusnya adalah begini. Sejauh ini yang kita biasa lakukan adalah program rata-rata dilakukan dalam 1 buah mesin, dimana biasanya apabila ada tambahan modul kita biasa tempel dan tempel diintegrasikan. Tetapi yang terjadi di gw adalah Aplikasi Gw menjadi aplikasi Induk yang mana nantinya setiap grup user punya palikasi sendiri yang harus berkirim data untuk dimasukan ke dalam proses workflow yang berjalan di dalamnya.

Cara ini mungkin ga akan ribet kalau yang dikirim hanyalah data text, bisa menggunakan XMLRPC sederhana untuk komunikasinya. Tetapi nyatanya di perusahaan Media seperti gw kadang dari sisi user ga tau diri ngirim filenya, bisa sepaket TIFF image yang bisa sampai 200-500MB sekali transfer(It’s damn impossible to transfer file as big as 500MB encrypted in base64 karena dapat membengkak 30% alias bisa jadi sekitar 800MB ), sebagai anggapan itu kalau 1 user, bagaimana kalau di kantor gw terdapat 30 user Group yang suka kirim-kirim data secara bersamaan ??? Terlebih cara seperti ini agak mustahil ter-optimized dalam PHP.

Next adalah di kantor besar seperti kantor besar, terkadang ada kantor lain yang posisinya terpisah di lain gedung, malah di lain wilayah. Tantangannya adalah terkadang namanya services, seperti Fiber Optic connection saja bisa terputus, sehingga kita tidak mungkin membiarkan mereka yang dikantor terpisah itu menggunakan aplikasi yang tertanam di kantor gw. Sehingga harus ditaruh di kantor yang terpisah tersebut. Sama seperti sebelumnya gw harus melakukan archiving data mereka ke server yang ada di kantor gw. Lagi kalau tadi ibaratnya hanya 200-500MB/grup saat gw melakukan fetching binnary data jadi mereka bisa bergiga-giga. Dan Aplikasi gw harus bisa mengirimkan hal itu lengkap dengan text record dari Databasenya. Plus gw juga harus menjaga sinkronasi user profile diantara 2 aplikasi, sehingga apabila ada perubahan data data server pusat juga harus ikut berubah.

Oh well ini tantangan terbesar yang harus gw pecahkan di semester 2 2011 but worry not, gw sudah menemukan cara yang cukup baik, hanya saja gw butuh waktu untuk testingnya, terlebih setelah ini jadi gw harus menginsert/mengubah beberapa core fungction&Classes di aplikasi ini… cukup riskan >.<

Intinya ada 3 bagian besar dalam developing yang baru gw aamin setelah 2 tahun ini semasa kerja. Kedepannya entah apalagi yang harus gw hadapi. Tetapi memang gw lebih suka menganalisis demiian daripada suruh buat ngoding melulu… terus terang gw lemah kalau suru koding transaksi ini dan itu

Sudah berapa lama saya ga update blog ini? 1 bulan? maybe. Tidak terasa saya masuk di penghujung kontrak di perusahaan saya sekarang. Akhir tidaklah buruk, beberapa ilmu baru dari proyek terakhir terus berdatangan. Kali ini saya mencoba sharing sebuah extension PHP yang native dibuat oleh Microsoft sendiri, yaitu “sqlsrv”.

Beberapa waktu lalu, saya sempat mendownload versi XAMPP untuk developing(versi 1.7.4) niatnya untuk mengecek kompitabilitas program saya supaya selalu up to date, dan apabila terbentur suatu kondisi, saya bisa cepat memikirkan jalan keluarnya. Kebetulan tantangan langsung muncul. Yap, terhitung dari XAMPP versi 1.7.4 dengan PHP 5.3.5++ PHP sudah tidak menyediakan driver untuk SQL server lagi(sebelumnya ada ‘mssql.dll’ di folder “ext”, tetapi kini sudah tidak ada). Sehingga kalau tidak mau usaha, ok aplikasi saya akan stuck development di XAMPP 1.7.3 ke bawah. Atau menggunakan model ODBC( saya kurang suka pake ODBC walau Database Abstraction Layer saya mendukung hal itu).

Beberapa post sebelumnya, saya pernah menyinggung hal ini. Karena Microsoft mengembangkan sendiri drivernya, akhirnya PHP developer melepaskan dan mempercayakan kepada yang empunya DBMS Singkat kata Microsoft punya driver yang diberi nama “sqlsrv” atau native driver Ms SQL Server.

Installasinya karena “baunya” dari Microsoft saya pikir awalnya rumit( saya ga gitu banyak kenangan baik dengan devekloping tools Microsoft ). Ternyata kali ini lebih mudah dari install extension Imagemagick Kurang lebih beginilah caranya( saya coba di XAMPP versi 1.7.3):

1. Download Extensionnya di sini.
2. Pastikan PC dimana PHP terinstall memiliki “Microsoft SQL Server Native Client”(terutama SQL server 2008 Native Driver).
   Driver ini akan terinstall apabila di PC terinstall Visual Studio 2008(Baik express atau yang full package) atau SQL server 2008. Apabila tidak punya, bisa download di halaman ini(Scroll bagian bawah atau cari bagian “Microsoft SQL Server 2008 Native Client“), download sesuai arsitektur OS yang dipakai(32 atau 64 bit) kemudian Install.
3. Buka installer program SQL Server Extension for PHP yangs udah di download. Dia akan menanyakan hendak diekstract dimana file nantinya(dia hanya minta extract tidak ada proses install).
4. Buka folder dimana file ter-extract, maka akan banyak sekali file-file disana(terutama versi untuk dll file-nya). Seperti yang seharusnya diingat, bahwa apabila kita menggunakan APACHE sebagai web server, maka kita memilih extension yang di compile dengan Visual C versi 6(VC6), sedangkan apabila menggunakan IIS, kita menggunakan extension yang dicompile dengan Visual C versi 9.
   

   Mulai dari PHP 5.3.6 semua PHP menggunakan VC9, sehingga cek versi PHP Anda karena Apache 2 build baru juga telah menggunakan VC9(including latest XAMPP juga sudah menggunakan yang sudah di compile menggunakan VC9).

   

   Contoh PHP 5.3.8 Dijalankan di Apache 2 VC 9, statusnya dapat diliat di halaman phpinfo

   Apabila versi PHP Anda pilih yang menggunakan VC9 bukan yang VC6

   Dalam paketnya juga terdapat sebuah file help dokumentasi a’la dokumentasi PHP yang bisa digunakan untuk referensi fungsi-fungsi dalam extension sqlsrv.

   

   File hasiL Extract

5. Copy “php_sqlsrv_53_ts_vc6/9.dll” ke directory extension PHP(Semenjak XAMPP yang saya gunakan adalah versi 1.7.3 yang memiliki versi PHP 5.3.x maka yang dipilih adalah ‘php_sqlsrv_53_ts_vc6/9.dll’).
6. Buka file “php.ini” dalam folder PHP, tambahkan satu baris di bagian extension PHP untuk memanggil extension sqlsrv.Save kemudian Tutup file “php.ini”, kemudian restart Apache.
   

   Tambahkan Line untuk memanggil Extension SQLSrv

7. Pergilah ke halaman phpinfo(apabila menggunakan XAMPP) biasanya ada di alamat: ‘http://localhost/xampp/phpinfo.php’ carilah sqlsrv. Apabila Anda berhsail, maka akan muncul di dalam list extension PHP yang aktif
   

   Extension sqlsrv Aktif di halaman phpinfo

8. Coba jalankan beberapa code sqlsrv untuk test, simplenya saya gunakan code seperti ini
   

   Contoh Code Untuk mengetest

   Apabila hasilnya keluar tanpa ada error, maka Anda berhasil menginstall extension sqlsrv.

Yang perlu diperhatikan disini adalah Pada field/column yang berjenis DATETIME, akan dikembalikan dalam bentuk Object berisi value-nya sendiri, timezone type dan juga timezone-nya. Selain itu apabila Anda menggunakan ADODB sebagai abstraction layer untuk database, driver yang Anda bisa gunakan adalah “mssqlnative“.

Tetapi bukan tanpa pekerjaan, ADODB “mssqlnative” driver mengembalikan value tanpa array untuk jenis DATETIME, hanya saja di sisipi dengan huruf “T” sebagai seperasi pemisah antara tanggal dan waktu(biasanya spasi) dan diakhiri dengan huruf “Z”.

Intinya saya belum tahu apa maksudnya itu(maklum telmi), Anda bisa mengeditnya di file “adodb-mssqlnative.inc.php” di folder “drivers” di dalam folder ADODB. Sekitar line 788 hapus “\T” ganti dengan spasi dan juga hapus “\Z”.

Apabila Anda tidak menggunakan ADODB for PHP, dan Anda ingin agar return value kolom berjenis DATETIME di return sebagai string, maka tambahkan satu parameter di saat membuat koneksi ke sqlsrv. Contoh sbb:

[php highlight_lines="3"]
$serverName = "MyServer";
$connectionInfo = array( "Database"=>“AdventureWorks”, ‘ReturnDatesAsStrings ‘=> true);
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false )
{
echo “Could not connect.\n”;
die( print_r( sqlsrv_errors(), true));
}

sqlsrv_close( $conn);
?>
[/php]

SQL native driver ini menurut yang saya baca menggunakan odbc yang sudah dioptimalisasikan oleh Microsoft. Dan semenjak extension ini dibuat oleh Microsoft, sehingga akan dimaintain oleh Microsoft.

Untuk beberapa sumber bacaan yang menarik:

• mssql vs. sqlsrv: What’s the Difference? (Part 1)
• MSSQL vs. SQLSRV: What’s the Difference? (Part 2)

Sekian tutorial kali ini… semoga berguna

Tahun 2008 lalu gw membuat sebuah web-based image uploader yang gw pakai sampai tahun 2010 lalu. Aplikasi simple ini gw buat untuk kebutuhan bloging gw, walau WordPress sudah semakin canggih image managernya(croping, mirroring, rotating,etc), tapi ada satu miss yang sampai saat ini belum diberikan oleh wordpress(bahkan dari dulu tahun 2008) diantaranya adalah Watermark/Signaturing image. Sehingga tahun 2008 gw membuat aplikasi dengan pengetahuan seadanya untuk memenuhi kebutuhan gw saat itu.

Dua tahun berlalu, banyak yang ingin gw perbaiki. Tetapi seperti biasa, gw males liat coding gw dua tahun yang lalu sehingga gw memutuskan membuat baru dari awal. Dilengkapi dengan beberapa fitur baru dan beberapa pengurangan fitur yang gw anggap ga perlu, selain itu dengan hasil evaluasi kebutuhan selama 2 tahun akhirnya akhir tahun lalu gw meng-upgrade system image managernya. Sampai hari ini gw melakukan beberapa penyempurnaan dan penambahan sedikit fasilitas.

Download My ver.2

Fasilitas:

1. Image support jpg,gif, and PNG.
2. Proses Image dengan GD Library atau Image Magick.
3. 4 cara upload : Standart Multiple Upload, Flash Upload(seperti Image Manager di WordPress dapat memilih lebih dari satu file), URL Upload, Image in Zip pack Upload(Zip only ).
4. 3 type Thumbnail: Standart, Extra(sometimes you need a bigger thumbnail for main image in a post) dan Custom Thumbnail(With Area Croping).
5. Watermarking/Signaturing with Image(png only) dengan posisi yang bisa diatur dengan preset di tengah, kanan atas, kanan bawah, kiri atas, atau kiri bawah.
6. Derajat transparansi dari Watermark tetap bisa diatur
7. Default Size Thumbnail & Extra Thumbnail dapat di setting sendiri.
8. QuickTag, untuk mendapatkan tag untuk digunakan di forum atau blog tidak usah ke halaman detail tiap-tiap image.

System requirement:

• Webserver(tested on Apache 2)
• PHP 5,2 atau lebih(tested di PHP 5,3)
• Mysql 5 Database

Komponen eksternal yang dipakai:

• jQuery (make anything simpler )
• jQuery Lightbox (Some Decoration on previewing Thumbnail)
• jCrop (For Custom Thumbnail creator)
• swfUpload (For easy multi Upload )
• jQuery Tools (for HTML5 slider range input)
• ADODB for PHP (for Database Abstraction Layer )
• dUnzip Classes (For Unziping purpose )

Notes:

• Beberapa bagian aplikasi menggunakan AJAX dan beberapa bagian menggunakan element HTML5 gunakan browser yang mensupport AJAX atau HTML5 untuk hasil terbaik.
• Tested Browser: IE8+, Firefox 3.6, Google Chrome 8, Opera 10.

Untuk Installasinya:

1. Extract file yang sudah di download
2. Buat sebuah database di Mysql
3. Import file “my2-full.sql.gz” yang ada di dalam folder “DB_Drop“
4. cari file “config.php-sample” di rename menjadi “config.php“
5. Buka file “config.php“, edit DB connection seperti host,username, etc di bagian config tsb, kemudian ubah isi variable “$url” sesuai dengan URL tempat image manager akan diupload.
6. Upload Semua file ke server, pastikan CHMOD beberapa folder seperti “files“,”temp”, dan “tmp” supaya bisa ditulis.
7. Buka URL tempat Image Manager diupload, Login dengan default username dan password yaitu “admin” dan passwordnya “admin” tanpa tanda kutip.
8. Aplikasi siap dipakai

Berikut ini adalah beberapa contoh tampilan layarnya:

Login Page

Gallery Control

Flash Upload

Standart Upload

URL Upload

Zip upload

Image Properties

Custom Thumbnail Maker

Custom Thumbnail List

Watermark Option

Option

]]> http://neo.rizkhey.net/2011/01/3847-my-image-manager-ver-2/feed 4