dicarve

Instalasi Senayan Library Management System (SLiMS) di Mac OSX berikut dengan dukungan Z39.50 (Bagian 1)

2011-08-24T02:52:00.000-07:00

Sebenernya udah lama mau nulis tutorial ini, tapi karena "kesibukan" (#eaaa) yang mendera, baru kali ini kesampean, sekalian menyambut bulan Ramadhan yang penuh barokah dan kehadiran versi SLiMS terbaru Stable15 Matoa. Berhubung saya ini juga orang sangat pelupa, maka ada baiknya sekalian saya dokumentasikan cara instalasi SLiMS di Mac OSX, kali-kali aja di kemudian hari saya lupa :D. Untuk instalasi di Mac OSX sebenernya relatif mudah, beberapa prasyarat yang harus anda penuhi adalah:

Desktop MacPro, Imac, Macbook, MacbookPro atau Macbook Air! (YA IYAAALLLAH!!!).
Terinstall sistem operasi OSX minimal versi 10.4 (boleh Intel atau PPC) dan ke atasnya
Paket XAMPP for Mac terbaru
Paket Xcode. Xcode merupakan paket development Mac OSX yang didalamnya terdapat compiler gcc, g++, make, dll. yang kita butuhkan untuk meng-compile YAZ dan PHP-YAZ. Xcode biasanya disertakan pada setiap DVD instalasi Mac OSX, atau kalo DVD instalasinya udah raib alias hilang, download aja di website resmi Apple, gratis kok.
Paket SLiMS versi source (bukan psenayan/portable senayan) terbaru, misalnya pada saat tulisan ini dibuat SLiMS Stable15 (Matoa)

Untuk tutorial ini, saya menggunakan MacbookPro dengan Mac OSX versi 10.6.8 dan paket XAMPP for Mac yang saya gunakan adalah versi 1.7.3, berikut dengan paket XAMPP Dev (xampp-macosx-1.7.3-dev) dengan versi yang sama. XAMPP Dev merupakan paket tambahan opsional yang berisi file-file development header dari aplikasi-aplikasi yang terdapat di dalam XAMPP seperti PHP, MySQL, library-library, dsb.

Oke mari kita mulai proses instalasinya!

Unduh (download) paket XAMPP untuk Mac di laman (website) Apachefriends. Inget ya, yang versi Mac, jangan yang versi Linux, Solaris, apalagi Winslow ehhh, Windows. Silly maybe, but guess what? ada aja orang yang salah download!
Download file Universal binary dalam format .dmg yang disediakan. Jangan lupa download juga paket development-nya agar kita bisa meng-compile library YAZ dan PHP-YAZ nanti.
Setelah selesai di-download, klik dua kali pada file image .dmg XAMPP untuk membuka installer-nya. Drag folder XAMPP ke folder Applications untuk menginstall.
Selesai proses instalasi, sekarang giliran install paket .dmg XAMPP Dev-nya. Caranya hampir sama dengan instalasi XAMPP, buka paket .dmg-nya dan jalankan installer yang terdapat di dalamnya. Ikuti proses wizard instalasinya.
Masuk ke folder Applications dan cari folder XAMPP disitu. Jalankan program "XAMPP Control". Nanti akan ada jendela aplikasi kecil yang berisi tombol untuk menjalan Apache, MySQL dan FTP. Cukup jalankan Apache dan MySQL saja, FTP server-nya engga perlu.
Sekarang giliran instalasi SLiMS. Ekstrak paket SLiMS versi source yang sudah anda download dari situs resmi SLiMS, dan kemudian kopikan folder hasil ekstraksinya (misal nama foldernya s3st15_matoa) ke folder /Applications/XAMPP/htdocs/.
Buka browser web favorit anda, misalnya Safari, Firefox, Chrome atau Camino dan arahkan ke URL phpMyAdmin di http://127.0.0.1/phpMyAdmin untuk membuka program manajemen database MySQL berbasis web, phpMyAdmin yang kesohor itu. By default instalasi XAMPP, phpMyAdmin bisa diakses bebas tanpa harus memasukkan username dan password.
Buatlah sebuah database baru dengan nama "senayandb". Setelah database berhasil dibuat masuk ke menu tab "Import" dan pilih file "senayan.sql" yang terdapat di dalam folder "install" di source SLiMS hasil ekstraksi kita tadi. Setelah proses import berhasil maka kemudian pilih menu tab "SQL" dan jalankan perintah berikut: GRANT ALL ON senayandb.* TO 'senayanuser'@'localhost' IDENTIFIED BY 'password_senayanuser'; FLUSH PRIVILEGES;
Buka Tab baru pada browser web anda dan masukkan alamat: http://127.0.0.1/s3st15_matoa . VOILLAA SLiMS sudah terinstall di Mac OSX ente gan!

Okeh. Bagian 1 sampai disini dulu, besok bagian 2 dimana kita akan meng-compile YAZ dan PHP-YAZ agar fitur Z39.50 yang dahsyat itu bisa berjalan di Mac OSX, akan saya lanjutkan, selamat menggunakan SLiMS di Mac OSX anda! (Ane tunggu cendol-nya ya gan xixixiiiii)

Tips dan Trik Pemeliharaan a.k.a Maintenance Senayan Library Management System (SLiMS)

2011-08-05T16:00:00.000-07:00

Beberapa teman pengguna SLiMS sering bertanya kepada saya, apa saja tips dan trik dalam pemeliharaan SLiMS, terutama bagi yang menggunakan versi Portable Senayan (psenayan). OK, kalau begitu sekalian aja biar ga lupa kita dokumentasikan di posting blog saya yang jarang sekali dimutakhirkan/update ini (heheheeee):

Tips 1:

Hapus semua file image barcode secara rutin

Setelah sekian lama menggunakan SLiMS kemudian sering membuat barcode untuk data Item/Copies koleksi, maka file-file image barcode hasil generate cetak barcode akan menumpuk di folder "lokasi_source_slims/images/barcodes". Walaupun besar file-nya kecil-kecil tetapi cukup mengganggu juga kalau jumlah sudah ribuan, terutama bagi mereka yang pakai webhosting dengan space harddisk pas-pasan. Oleh karena itu bagi mereka yang sering mencetak barcode koleksi atau kartu anggota dengan SLiMS paling tidak sebulan sekali silahkan itu semua file image .png barcode di folder "lokasi_source_slims/images/barcodes" dibabat abissss!

Tips 2:

Cek file access.log dan error.log web server Apache di psenayan

Ada kaskus, ehhh... :p kasus dimana pengguna psenayan bingung setengah hidup ketika melihat ukuran folder psenayan mereka menggelembung atau bahasa kerennya, BLOATED, menjadi 3-5 Gigabyte padahal mereka tidak mengupload file-file digital ke SLiMS. Penyebab hal ini ternyata adalah file log milik web server Apache, yaitu error.log dan access.log yang menjadi semakin besar seiring pemakaian psenayan. Bagi anda yang belum tahu fungsinya, file access.log menyimpan semua informasi request HTTP yang dilakukan ke web server Apache, sedangkan error.log menyimpan semua error/galat yang terjadi pada request HTTP, error yang terjadi pada program Apache itu sendiri, error pada SSL, dan error-error lainnya. Letaknya ada di direktori "/psenayan/apache/logs". Nah solusi masalah ini ada 3 alternatifnya:

Solusi 1: Kosongkan kedua file tersebut, atau hapus apabila terlalu besar untuk dibuka dengan Notepad dan kemudian buat kembali file teks kosong dengan nama yang sama. Solusi ini berlaku bagi mereka yang mengganggap tidak perlu mengetahui apa isi dari log web server Apache

Solusi 2: Compress dalam format zip atau rar kedua file tersebut dan backup ke tempat lain kemudian buat kembali file teks kosong dengan nama yang sama. Solusi ini berlaku bagi mereka yang mengganggap penting untuk mengetahui apa isi dari log web server Apache, biasanya admin jaringan perlu menganalisa isi dari log ini, terutama apabila terjadi hacking, cracking, deface, dll pada website

Solusi 3: Gunakan fasilitas Log Rotation yang disediakan oleh Apache untuk merotasi isi log secara otomatis dan periodik. Untuk lebih lengkapnya silahkan ikuti petunjuknya disini Log Rotation. Atau bisa juga gunakan fitur Piped Logs

Tips 3:

Backup psenayan dan database secara rutin

Bagi pengguna psenayan lakukan backup satu folder psenayan secara rutin dengan melakukan dua tips sebelumnya terlebih dahulu agar ukuran backup tidak terlalu besar dan kemudian kompresi folder psenayan dalam format zip atau rar (mau lebih kecil lagi? pake format 7z atau lzma sekalian :D). Beri nama file kompresi tersebut misalnya psenayan-20110817.zip biar kita lebih mudah mengidentifikasi kapan tanggal pembuatan backup tersebut.
Untuk membackup database, gunakan fasilitas "Database Backup" yang terdapat pada modul "System" di SLiMS. Sebelumnya pastikan bahwa sudah tidak ada warning mysqldump di halaman awal admin SLiMS. Jangan lupa juga untuk memindahkan semua file hasil backup SLiMS (.sql atau .sql.gz) yang terletak di direktori "lokasi_source_slims/files/backup" ke tempat lain.

Tips 4:

Optimasikan database SLiMS

Bagi anda pengguna SLiMS yang sering kali melakukan proses update data dan penghapusan data, ada baiknya lakukan proses optimisasi database SLiMS. Untuk optimasi database SLiMS gunakan saja phpMyAdmin atau kalo mau lebih hardcore login ke database server MySQL pake terminal/commandline. Dengan phpMyAdmin masuk ke database yang digunakan SLiMS (biasanya di psenayan namanya "senayandb"), dan kemudian masuk ke tab menu SQL dan masukkan perintah berikut:
OPTIMIZE TABLE `biblio` , `biblio_attachment` , `biblio_author` , `biblio_topic` , `files` , `item` , `member` , `mst_author` , `mst_label` , `mst_topic`;

Tips 5:

Backup dan kosongkan System Logs SLiMS secara rutin

Lakukan proses backup dengan mendownload log System SLiMS dengan menggunakan fasilitas yang sudah disediakan dan kemudian kosongkan System Log SLiMS. Lakukan ini secara berkala setiap bulan.

Kira-kira begitulah tips dan trik dalam proses maintenance SLiMS yang bisa saya share kepada rekan-rekan pengguna SLiMS, ditunggu masukkan tips dan trik yang lainnya dari rekan-rekan semua. Semoga bermanfaat :)

Kompilasi HandBrake di Ubuntu 10.04 Lucid Lynx

2010-08-22T23:13:00.000-07:00

Mungkin sebagian dari Anda pengguna Ubuntu, sudah tahu bahwa HandBrake tidak keluar versi binary untuk distro Ubuntu dan Fedora. Padahal HandBrake menurut saya adalah salah satu aplikasi terbaik buat nge-rip DVD/encode video ke format MKV atau MP4. Alasan resmi dari developernya adalah:

"0.9.4 is no longer available due to compatibility issues with the newer version of gnome. "

Ada juga cara dengan mendownload Nightly build-nya di Launchpad-nya John Stebbins. Buat yang demen cara susah, biar keliatan lebih geek, bisa juga install dengan kompilasi dari Source Code. Sebelumnya coba cara susah ini, pastiin komputer anda terkoneksi ke Internet dan pastikan paket-paket development berikut ini sudah terinstall:

yasm
build-essential
autoconf
libtool
zlib1g-dev
libbz2-dev
intltool
libglib2.0-dev
libdbus-glib-1-dev
libgtk2.0-dev
libgudev-1.0-dev
libwebkit-dev
libnotify-dev
libgstreamer0.10-dev
libgstreamer-plugins-base0.10-dev

Bagaimana cara installnya? buka console, lalu seperti biasa ketikkan perintah:


sudo apt-get install yasm build-essential
autoconf libtool zlib1g-dev libbz2-dev intltool libglib2.0-dev
libdbus-glib-1-dev libgtk2.0-dev libgudev-1.0-dev
libwebkit-dev libnotify-dev libgstreamer0.10-dev
libgstreamer-plugins-base0.10-dev

Setelah paket-paket tersebut sudah terinstall dengan baik, maka lakukan langkah-langkah sebagai berikut:

Download source code HandBrake (Ya iya lahh!!!) (Pada saat tulisan ini dibuat HandBrake berada pada versi 0.9.4)
Buka console kesayangan anda dan arahkan ke direktori tempat anda mendowload source code HandBrake tadi.
Extract file tarball source code HandBrake dengan perintah: tar xvf HandBrake-0.9.4.tar.bz2
masuk ke direktori hasil ekstraksi tadi dengan perintah: cd HandBrake-0.9.4/
Jalankan perintah: ./configure --prefix=/usr/local
Setelah proses selesai, lalu masuk ke direktori build dengan perintah: cd ./build
Jalankan make dengan perintah: make
Tunggu proses-nya yang cukup lama selesai (tergantung spesifikasi komputer Anda), dan beberapa dependancies akan didownload otomatis ketika proses berjalan, seperti faac, faad, ffmpeg, dsb.
Setelah proses kompilasi selesai tanpa error, jalankan perintah install: sudo make install
Untuk mencoba apakah HandBrake sudah berjalan coba jalankan perintah: HandBrakeCLI untuk versi command line-nya dan juga ghb untuk versi dengan GUI GTK2.0-nya
Bagi yang masih penasaran mengenai cara kompilasinya, silahkan baca manual kompilasi aslinya di Compiling HandBrake on GNU/Linux.

Selamat! sekarang HandBrake sudah bisa digunakan untuk me-rip DVD kesayangan anda dalam format MKV atau MP4, bisa lewat GUI ataupun kalo mau merasa lebih geeky lagi buang jauh-jauh GUI, pake versi command line-nya :P :D!!

Mengatasi problem "wget" ketika mendownload di balik proxy (Ubuntu Lucid Lynx)

2010-05-25T20:32:00.000-07:00

Beberapa waktu yang lalu saya meng-upgrade OS GNU/Linux Ubuntu Karmic Koala (9.10) di MacbookPro saya ke versi LTS terbaru, Lucid Lynx (10.04). Saya upgrade menggunakan versi alternate yang saya download dari Kambing. Semua proses berjalan lancar, Lucid terinstall dengan ciamik-nya di MacbookPro dan hampir semua tombol fungsi spesial di Mac berjalan dengan baik.

Masalah muncul ketika saya akan mendownload website untuk mirroring dengan program command-line favorit saya, wget. Kantor saya menggunakan proxy untuk koneksi Internet, sehingga untuk menjalankan perintah-perintah dari console yang menjalankan download seperti apt-get install atau apt-get update misalnya kita harus men-set environment variable http_proxy dan ftp_proxy terlebih dahulu. Pada desktop GNOME sudah disediakan aplikasi "Network Proxy" yang terletak di System->Preferences, yang memudahkan kita mengubah setting proxy jaringan. Enaknya lagi program ini mendukung multiple profile proxy yang memudahkan kita untuk menyimpan lebih dari satu setting proxy, kemudian tinggal mengubahnya sesuai dengan kebutuhan kita.

Sayangnya, pada Ubuntu Lucid Lynx, entah kenapa wget tidak terpengaruh dengan setting proxy ini, tetapi tools apt dan yang lainnya terpengaruh. Setelah berkeliling internet mencari-cari solusinya, dan akhirnya menemukan solusinya di Lauchpad, ternyata masalahnya sangat simple!!! Ternyata masalahnya ada di environment variable no_proxy yang secara "tidak sengaja" menaruh karakter "," (koma) di bagian akhir!!! PLLOOOKKKK!!! (tepok jidat)

Solusinya adalah dengan menghilangkan tanda koma di bagian akhir tersebut, dengan cara men-set ulang variable no_proxy di console: $export no_proxy=daftar-alamat-tidak-kena-proxy1,daftar-alamat-tidak-kena-proxy2,daftar-alamat-tidak-kena-proxy3 dan kemudian wget bisa berjalan dengan normal kembali seperti biasa walau ada proxy. Jangan lupa juga cek file konfigurasi wget yang terletak di "/etc/wgetrc" dan pastikan setting use_proxy=on aktif dan setting no_proxy ditulis dengan benar (bila ada).

Compile Sphinx indexing engine di Mac OSX 10.6.3

2010-04-29T03:16:00.000-07:00

Cari solusi indexing database standalone yang handal? Salah satu solusinya adalah Sphinx. Sphinx adalah engine pengindeksan full-text yang didesain untuk terintegrasi dengan baik ke RDBMS-RDBMS macem MySQL dan PostgreSQL, dan yang asiknya laginya Sphinx sudah menyediakan API ke bahasa-bahasa scripting populer macem PHP, Python, Perl dan Ruby.
Karena saya develop aplikasi pake bahasa skripting PHP, maka Sphinx merupakan solusi yang pas untuk saya. Salah satu fitur yang bikin saya ngiler adalah statement berikut ini:

"high search speed (avg query is under 0.1 sec on 2-4 GB text collections)"

Wuiidddiihhh kalo dibandingin sama indexing native mysql, 100 ribu records yang besarnya sekitar 30MB aje ude empot-empotan!!! Statement berikutnya juga bikin ileran

"high scalability (upto 100 GB of text, upto 100 M documents on a single CPU)"

Saat tulisan ini dibuat, saya develop aplikasi web pake Macbook Pro, OS Snow Leopard 10.6.3, dan karena saya males compile-compile Apache, MySQL dan PHP (kecuali di OS GNU/Linux entah kenapa kurang apdol rasanya kalo ga di-compile sendiri heheheheee *kabboorr*), jadilah saya pake XAMPP for Mac OSX versi 1.7.2.
Karena binary Sphinx kage ade buat Mac OSX, cuman ade buat "Mikocok Winslow", maka itu berarti kite harus compile sendiri Sphinx. ALHAMDULILLAH WA SYUKURILLAH! OSX udah nyedian Xcode yang didalemnya udah ada semua tool development UNIX macem gcc, g++, make, automake, autoconf, you name it lah! GRATIS lagi! *Getokin Apple kalo sampe paket XCode dibikin berbayar*. ALHAMDULILLAH lagi, karena Mac OSX basisnya UNIX juga (Darwin+FreeBSD), maka console dengan shell prompt Bash yang kesohor itupun ude ade by default di OSX *ffiuuuuhhhhh, can't live without those consoles*. ALHAMDULILLAH lagi! struktur direktori Mac OSX yang kaga jauh beda sama UNIX atau GNU/Linux!
Jadilah saya "iseng-iseng berhadiah" compile Sphinx di Macbook Pro saya. Yang pasti sebelum mulai compile Sphinx, download dan install dahulu library-library berikut ini (beserta dengan header-header developmentnya!! kudu, wajib!!):

Source code terbaru Sphinx
Source code libstemmer
Source code dan file-file header MySQL kalo kita mau integrasikan Sphinx dengan MySQL
Source code dan file-file header PostgreSQL kalo kita mau integrasikan Sphinx dengan PostgreSQL
Bagi yang menggunakan XAMPP bisa lebih mudah, download paket XAMPP-Dev yang sesuai dengan versi yang kita pake

Proses instalasinya kira-kira begini:

Buka aplikasi "Terminal", kalo belom tau coba cari di /Applications/Utilities/
Ekstrak file distribusi Sphinx pake perintah: tar xvf sphinx-0.9.9.tar.gz
Ekstrak file distribusi libstemmer dan kopikan folder ekstraksi libstemmer ke dalam folder source Sphinx yang baru saja kita ekstrak pake perintah: cp -r ./libstemmer_c sphinx-0.9.9
Masuk ke direktori hasil ekstraksi pake perintah: cd sphinx-0.9.9
Karena saya pake XAMPP Mac OSX perintah configure saya seperti ini: Dicarve@Macbook sphinx-0.9.9$ CFLAGS="-O -arch i386" CXXFLAGS="-O -arch i386 -I/Applications/XAMPP/xamppfiles/include/ -I/Applications/XAMPP/xamppfiles/include/mysql" LDFLAGS="-arch i386 -L/Applications/XAMPP/xamppfiles/lib" ./configure --prefix=/usr/local/ --with-mysql -with-libstemmer --with-mysql-includes=/Applications/XAMPP/xamppfiles/include/mysql --with-mysql-libs=/Applications/XAMPP/xamppfiles/lib/mysql Saya sempet agak-agak stress karena diawal-awal proses kompilasi gagal melulu! setelah baca-baca keliling Internet dan baca disini, ternyata sphinx-nye harus di-compile di mode 32 bit! *karena by default gcc di Mac OSX compile di mode 64 bit*
Apabila proses konfigurasi berjalan lancar tanpa masalah, maka lanjutkan dengan perintah berikut secara berurutan: $ make $ sudo make install

Horreee Sphinx berhasil diinstall!!!! Yiiihhuuu!!! Selanjutnya tinggal konfigurasi Sphinx biar bisa "bicara" sama MySQL atau PostgreSQL, selamat mencoba, dan jangan lupa baca dokumentasi sphinx di website resminya, RTFM!

Emang Enak Kepentok Proxy!!!

2010-01-06T23:48:00.001-08:00

Mengembangkan software dengan menggunakan aplikasi source code management (SCM) emang enak. Kami, developer SENAYAN Library Management System (SLiMS) pake git buat source code versioningnya. Asiknya pake git dibandingkan dengan aplikasi SCM lain adalah git menerapkan model ter-distribusi, tidak centralize seperti cvs. Asyiknya lagi pake git, kita ga harus terkoneksi ke server, kita bisa pake lingkungan hard disk lokal untuk buat branch-branch dari project kita.

Saya ga akan ngebahas cara make git disini, tapi saya ngebahas bagaimana kalau kita mau push dan pull request dari server repository git di internet, tapi kepentok sama proxy jaringan dan firewall yang biasanya cuman ngebolehin port 80 atau 3182.

Tapi itulah keindahan dunia open source, "That's The Beauty of Open Source", udah ada aplikasi yang bisa bantu kita tunneling data dari git, yang by default pake protokol SSL. aplikasi command line ini namanya Corkscrew, dan tersedia untuk semua varian GNU/Linux, UNIX, BSD, Mac OSX dan MS Windows (tapi mesti install Cygwin dulu, HAHAHHAHAHA!!! EMANG ENAKK!!!!). Apa pulak "Corkscrew" ini? ngutip langsung dari websitenya :

"Corkscrew is a tool for tunneling SSH through HTTP proxies."

Versi terakhir ketika tulisan ini diketik dan dipikirkan adalah versi 2.0.

Buat make Corkscrew, caranya gampang banget, kalo ga bisa dibilang susah :D, cukup download source code-nya dan kemudian compile deh pake compiler C favorit anda hehehheeheee..... Kalau anda pake GNU/Linux, biasanya gcc by default ude keinstall, kalo enggak yang nasib, hehheheee.... becanda! kalo ga ada gcc ya install lah dari repo distro anda :)). Step instalasinya setelah download kira-kira seperti ini :

Buka console/terminal kesayangan anda (pliss, jangan buka DOS atau Command Prompt!!)
Extract file hasil download Corkscrew pake perintah: tar xvzf corkscrew-2.0.tar.gz
Masuk ke dalam direktori hasil ekstract: cd corkscrew-2.0
Jalankan perintah berikut secara berurutan:

./configure --prefix=/usr/local

make

sudo make install

Setelah instalasi Corkscrew berhasil, maka langkah selanjutnya adalah mengkonfigurasi ssh agar bisa tunneling SSL lewat proxy. Buka file yang namanya "config", yang ada di folder ".ssh" di home directory user. Misalnya home directory saya di "/home/dicarve" maka berarti letaknya ada di "/home/dicarve/.ssh/". Kalo file "config" belom ada.......... ya dibuatlah pake text editor, pake vi, pake vim, pake emacs, pake nano (halahhhh). Edit file config tersebut dan isikan kira-kira seperti ini :

Host gitproxy 
    User git
    HostName ssh.github.com
    Port 443
    ProxyCommand /usr/local/bin/corkscrew alamat-atau-no-IP-proxy port-proxy %h %p
    IdentityFile /home/dicarve/.ssh/id_dsa

Jangan lupa di-save!! :D

Setelah semua itu selesai, maka nanti ketika kita mau pull atau push data ke repository server git, misalnya SLiMS di repo-kan di github/slims, perintah git yang kita lakukan bukannya begini:

git pull git@github.com:slims/s3st13.git master

Tapi jadi begini:

git pull git@gitproxy:slims/s3st13.git master

atau kalo mau push

git push git@gitproxy:slims/s3st13.git master

Workshop Nasional SENAYAN Library Management System!!!

2009-12-03T17:23:00.000-08:00

SENAYAN DEVELOPER COMMUNITY (SDC) kembali akan ngadain Workshop Nasional SENAYAN Library Management System (SLiMS), yang tepatnya akan dilaksanakan di Hotel Paragon Jakarta (daerah Menteng, Jakarta Pusat), pada tanggal 14 – 17 Desember 2009. Pastinya karena Workshop ini diadakan selama 4 hari 3 malam full, jadi materi yang diberikan juga akan sangat banyak dan men-detail.

Workshop ini ditujukan kepada para pustakawan atau perorangan yang ingin memanfaatkan SLiMS untuk mengelola koleksi ditempat kerja. Materi workshop dirancang untuk membantu para peserta agar dapat segera mengaplikasikan SLiMS di tempat masing-masing. Dibagi dalam 10 (Sepuluh) modul dasar ditambah materi kustomisasi dan konversi data, pengetahuan dasar perpustakaan akan sangat membantu peserta memahami materi dan panduan yang di sampaikan. Dalam pelatihan, peserta akan menggunakan versi terbaru SLiMS – atau juga dikenal dengan SENAYAN 3 stable 12.

Untuk brosur pendaftaran serta surat undangan bisa di-unduh (download) di Workshop SLIMS.

Untuk anda yang ingin belajar menggunakan SENAYAN, ngoprek, nginstall SENAYAN di GNU/Linux macem Ubuntu, Fedora atau OpenSUSE, pengen belajar cara konversi data dari database ISIS, Athenaeum atau database lainnya, jangan lewatin Workshop SLiMS ini. Trainer-nya juga langsung para Developer ASELI SLiMS!!!.

jQuery, I Love You Full!

2009-08-26T21:28:00.000-07:00

Di postingan sebelumnya saya membahas Prototype, sebuah framework Javascript ciamik untuk manipulasi DOM dan AJAX. Kali ini saya iseng-iseng coba sebuah framework Javascript yang sudah kesohor juga yaitu jQuery. kalau menurut hemat saya, jQuery punya model syntax yang lebih elegan dibandingkan dengan Prototype, hal ini bisa kita lihat dalam model object jQuery yang lebih simple, terutama dalam penanganan event. Penanganan event di jQuery nemungkinkan kita benar-benar memisahkan antara layer tampilan dengan layer logic pemrograman javascript.

Perbedaan mendasar antara jQuery dengan Prototype adalah, fungsi $ pada jQuery menerima argumen string Selector CSS atau XPath dan selalu mengembalikan objek jQuery dalam bentuk Array atau List, sedang pada Prototype fungsi $ hanya menerima string ID dari element yang akan kita manipulasi dan mengembalikan object DOM yang sudah di-extend oleh metode-metode Prototype (walaupun sebenarnya Prototype punya fungsi yang serupa dengan $-nya jQuery, yaitu fungsi $$ dan juga metode class Element, select, yang juga menerima argument string Selector CSS atau XPath). IMHO hal ini membuat jQuery menjadi lebih efisien, karena semua metode jQuery (dan juga semua metode plugins-nya) sudah pasti mengolah Array atau List objek DOM jQuery.

Contohnya, untuk me-register event memunculkan box alert apabila ada link dengan id 'klikSaya' di-klik, kita cukup menulis kode seperti ini pada bagian HEAD dokumen HTML kita atau bisa juga pada bagian awal BODY dokumen HTML :

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<script type="text/javascript">
$(document).ready(function() {
    $('#klikSaya').click(function(evt) {
        alert('Hallooowww anda telah meng-klik saya!');
    });
});
</script>
</head>

Dan pada BODY dokumen HTML, kita cukup menuliskan kode seperti ini :

<body>
<a id="klikSaya" href="#">Klik Saya Donk Ahhh!</a>
</body>
</html>

Apalah artinya aplikasi Web 2.0 tanpa AJAX, rasanya kurang lengkap tanpa metode nyang satu ini. jQuery menyediakan API AJAX yang cukup lengkap untuk AJAX. Contoh di BODY dokumen HTML kita punya seperti ini:

<body>
<a id="klikAJAX" href="#">Klik Saya Buat Munculin Konten dari AJAX di bawah ini :</a>
<div id="ajaxContainer">&nbsp;</div>
</body>
</html>

Maka di bagian HEAD kita bisa menuliskan kode Javascript seperti ini :

$(document).ready(function() {
    $('#klikAJAX').click(function(evt) {
        var content = $.ajax({ url: "kontenAJAX.php", async: false }).responseText;
        // perhatikan opsi 'async', apabila diset false, maka semua event lain di browser di-block
        // sehingga tidak ada proses AJAX dilakukan bersamaan
        $('#ajaxContainer').html(content);
    });
});

Sangat mudah bukan?

jQuery juga sudah menyediakan metode-metode untuk animasi dasar, seperti fadeIn, FadeOut, pullDown, pullUp, hide, show dan animate. Contohnya bisa dilihat sebagai berikut :

Klik Saya Donk!

Makkkk!!! gampang kali!! kode untuk efek animasi di atas hanya begini saja :

$(document).ready(function() {
    $('a.show-hidden').click(function(evt) {
        evt.preventDefault();
        $('.hidden-object').slideDown("normal");
    });
 
 
    $('a.hide-hidden').click(function(evt) {
        evt.preventDefault();
        $('.hidden-object').slideUp("normal");
    });
});

Seperti halnya Prototype, jQuery didesain agar penulisan kode semakin ringkas dan elegan, yang pada akhirnya bisa memperkecil ukuran file kode Javascript kita. Hal ini didapat dengan penerapan Command Chaining. Setiap hasil fungsi $ bisa di-chaing atau digabung dengan fungsi-fungsi jQuery lain. Misalnya bisa kita lihat pada contoh kode berikut :

// temukan semua tag 'A' dibawah element DOM dengan ID 'menu'
// dan daftarkan event 'click' sekaligus event 'mouseover'
// dan juga sekaligus set style CSS dari setiap tag 'A' yang ditemukan
// dengan display = block
$('#menu').find('a').click(function(evt) {
    // lakukan sesuatu untuk setiap tag 'A' disini
    // ketika di-klik
}).mouseover(function(evt) {
    // lakukan sesuatu untuk setiap tag 'A' disini
    // ketika cursor melewati tag 'A'
}).css('display', 'block');

Gampang yak? :D

Instalasi library YAZ di PHP

2009-07-15T22:23:00.000-07:00

Pada SENAYAN 3 Stable 10, saya menambahkan kemampuan untuk mengambil data melalui protokol Z39.50 pada modul Bibliography (Pengatalogan). Fitur ini memanfaatkan library PHP YAZ. YAZ sendiri adalah sebuah library untuk bahasa C yang dapat digunakan untuk membangun aplikasi server dan klien protokol Z39.50/SRW/SRU. Untuk lebih lengkapnya silahkan anda arahkan browser kesayangan anda ke laman resmi YAZ. Fitur Z39.50 di SENAYAN 3 Stable 10 diharapkan akan semakin memudahkan pustakawan untuk mengambil data langsung ke database online Library of Congress yang kesohor itu. Cukup masukan nomor ISBN, tunggu proses pengambilan data selesai, apabila berhasil anda tinggal memilih data mana yang akan dimasukkan ke dalam database SENAYAN anda. Hidup pustakawan semakin mudah kalau pakai SENAYAN hehheeheee :).

Untuk yang belum mengetahui apa itu protokol Z39.50, Z39.50 adalah protokol klien server berstandar internasional (ISO 23950) untuk penelusuran dan temu kembali informasi antar komputer. Penerapan protokol ini memungkinkan beberapa institusi untuk saling bertukar data, menelusur dan menemukan kembali data (biasanya rekod bibliografis/katalog koleksi perpustakaan) dengan antar muka yang sama dan teknik penelusuran yang sama.

Untungnya pengembang YAZ juga mengembangkan extension library YAZ untuk PHP. Untuk menginstall dan mengaktifkan library YAZ di PHP caranya cukup mudah :

Windows

Unduh/download versi terakhir php_yaz.dll di repositori PHP YAZ dan kopi ke folder/direktori extension PHP anda. Misal anda menginstall PHP di C:\php, maka kopi file php_yaz.dll ke direktori C:\php\ext.
Unduh/download versi terakhir YAZ toolkit dan lakukan instalasi.
Masuk ke direktori instalasi YAZ anda (biasanya terletak di C:\Program Files\YAZ\bin) dan kopi 4 file DLL (atau biar gampang semua file DLL juga boleh :D) yang ada di dalamnya ke direktori C:\WINDOWS\system32 dan C:\WINDOWS\system. Bisa juga apabila anda menggunakan web server Apache, kopikan semua DLL-nya YAZ ke folder bin-nya instalasi Apache.
Buka file konfigurasi PHP anda (php.ini) dan tambahkan atau hilangkan tanda ;(titik koma) baris yang bertuliskan seperti ini :
extension=php_yaz.dll
Restart web server anda untuk menyelesaikan proses instalasi dan setup dan kemudian cek dengan script apakah library YAZ sudah terinstall dengan baik.

GNU/Linux atau varian UNIX

Download source code rilis stable YAZ terbaru.
Download source code rilis PHP YAZ terbaru.
Pastikan compiler GCC, make, libtool dan tools development lainnya sudah terinstall di sistem anda.
Buka console/terminal, ekstrak file tarball YAZ dengan menggunakan perintah tar xvzf yaz-3.0.47.tar.gz dan kemudian masuk dalam direktori hasil ekstraksi YAZ dengan perintah cd yaz-3.0.47.

Jalankan perintah-perintah berikut secara berurutan :


./configure --prefix=/usr
make
sudo make install

Ekstrak tarball PHP YAZ dengan perintah tar xvzf php-yaz-1.0.14.tar.gz dan kemudian masuk ke direktori hasil ekstraksi dengan perintah cd php-yaz-1.0.14.
Pastikan anda memiliki program phpize, bila tidak silahkan lakukan instalasi melalui perintah sudo apt-get install php-dev untuk distro Debian dan turunannya atau yum install php-dev untuk distro distro turunan Red Hat. Jalankan perintah-perintah berikut secara berurutan :
```
phpize
./configure --with-php-config=/usr/bin/php-config
make
sudo make install
```
Buka file konfigurasi PHP anda (php.ini) dengan editor teks favorit anda dan tambahkan atau hilangkan tanda ;(titik koma) pada baris yang bertuliskan seperti ini :
extension=yaz.so
Restart service web server anda dengan menjalankan perintah service apache restart sebagai user ROOT atau kalau tidak bisa coba jalankan perintah /etc/init.d/httpd restart.
Cek dengan script apakah library YAZ sudah terinstall dengan baik.

Alya Bakhita

2008-11-18T05:52:00.000-08:00

Alya Bakhita. Yang Tinggi dan Beruntung. Anak dan putri pertama-ku dengan istri tercinta, Lia.

Alya Bakhita

Alya Pake Baju Kodok

Alya Bakhita, Bunda dan Ayah

Anak Pertama-ku Telah Lahir!

2008-11-06T16:25:00.000-08:00

Alhamdulillah Wa Syukurillah, ALLAH SWT telah melengkapi kehidupan keluarga saya dan istri, dengan memberikan amanah-nya yang paling menakjubkan di alam semesta, seorang anak. ALLAH SWT telah meng-karuniai kami seorang putri yang cantik pada tanggal 5 november 2008, pukul 8.30 WIB, dengan berat 3,37 kg dan panjang 50 cm. Hingga tulisan ini dibuat belum diputuskan namanya (hehheeehee... kandidat si udah ada tapi belum diputuskan).

Sedikit berbagi kebahagian berikut adalah foto-foto yang saya ambil beberapa jam setelah "ade" dilahirkan ke dunia :

Bikin Search Engine FullText dengan Zend Search Lucene - Searching/Pencarian

2008-08-31T19:50:00.000-07:00

Pada posting sebelumnya saya sudah sedikit memaparkan bagaimana cara membuat dan menambahkan indeks database dokumen fulltext dengan menggunakan Zend Search Lucene. Sekarang saya akan sedikit memaparkan bagaimana cara untuk melakukan pencarian ke dalam indeks yang telah dibuat dengan menggunakan Zend Search Lucene.

Untuk melakukan pencarian, Zend Search Lucene menyediakan beberapa metode, tetapi yang paling simpel adalah menggunakan metode find(), dari objek INDEX (instance fungsi factory Zend_Search_Lucene::open). Metode find() mempunyai 2 argumen, argumen pertama adalah kata kunci/keyword yang ingin kita query, dan argumen kedua adalah default field metadata yang akan di-coba temukan oleh indexer. HATI-HATI DENGAN QUERY WILDCARD (*)! Listing programnya kira-kira seperti ini :

<?php
// include paging class
require 'lib/simbio_paging.inc.php';
require 'lib/utils.inc.php';
// get keywords
$keywords = trim($_GET['keywords']);
if ($keywords AND $keywords != '*') {
    // search the index
    $matches = $index->find($keywords, 'title');
    if ($num_matches = count($matches)) {
        // slice the array
        if ($num_matches > $config['recs_each_page']) {
            // get page number from http get var
            $page = 1;
            if (isset($_GET['page']) AND $_GET['page'] > 1) {
                $page = (integer)$_GET['page'];
            }
            // count the row offset
            $remove_offset = $config['recs_each_page'];
            if ($page > 1) {
                $remove_offset = ($page*$config['recs_each_page']);
                // slice from first element of array
                array_splice($matches, 0, ($remove_offset-$config['recs_each_page']));
            }
            // slice the rest elements of array
            array_splice($matches, $config['recs_each_page']);
        }
        echo 'Found <b>'.$num_matches.'</b> document matches your keyword : <hr size="1" />'."\n";
        foreach ($matches as $doc) {
            echo '<div style="clear: both: margin: 5px; margin-bottom: 20px;">'
                .'<div style="font-weight: bold;">'.$doc->title.'</div>'
                .'<div style="margin-left: 10px;">'.$doc->author.'</div>'
                .'<div style="margin-left: 10px;"><a href="?mod=search&action=action&docID='.urlencode($doc->checksum).'" target="_blank">'.basename($doc->file_name).'</a></div>'
                .'</div>';
        }
    }
    // paging
    if ($num_matches > $config['recs_each_page']) {
        echo simbio_paging::paging($num_matches, $config['recs_each_page'], 10);
    }
} else {
    echo utils::showError('No Keywords Entered!');
}
?>

Yang agak rumit mungkin adalah paging search resultnya. Zend Search Lucene kaga nyediain tuh yang namanya klausa "LIMIT", "OFFSET", "TOP" kaya di RDBMS-RDBMS populer, agak-agak tricky si caranya, tapi "it works". Ini saya langsung kasih juga script pagingnya yang saya ambil dari library development PHP, SIMBIO 2 yang selalu saya gunakan dalam mengembangkan aplikasi.

<?php
/**
 * simbio_paging
 * Paging Generator class
 *
 * Copyright (C) 2007,2008  Arie Nugraha (dicarve@yahoo.com)
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 *
 */
 
class simbio_paging
{
    /**
     * Static Method to print out the paging list
     *
     * @param   integer $int_all_recs_num
     * @param   integer $int_recs_each_page
     * @param   integer $int_pages_each_set
     * @param   string  $str_fragment
     * @param   string  $str_target_frame
     * @return  string
     */
    public static function paging($int_all_recs_num, $int_recs_each_page, $int_pages_each_set = 10, $str_fragment = '', $str_target_frame = '_self')
    {
        // check for wrong arguments
        if ($int_recs_each_page > $int_all_recs_num) {
            return;
        }
 
        // total number of pages
        $_num_page_total = ceil($int_all_recs_num/$int_recs_each_page);
 
        if ($_num_page_total < 2) {
            return;
        }
 
        // total number of pager set
        $_pager_set_num = ceil($_num_page_total/$int_pages_each_set);
 
        // check the current page number
        if (isset($_GET['page']) AND $_GET['page'] > 1) {
            $_page = (integer)$_GET['page'];
        } else {$_page = 1;}
 
        // check the query string
        if (isset($_SERVER['QUERY_STRING']) AND !empty($_SERVER['QUERY_STRING'])) {
            parse_str($_SERVER['QUERY_STRING'], $arr_query_var);
            // rebuild query str without "page" var
            $_query_str_page = '';
            foreach ($arr_query_var as $varname => $varvalue) {
                $varvalue = urlencode($varvalue);
                if ($varname != 'page') {
                    $_query_str_page .= $varname.'='.$varvalue.'&';
                }
            }
            // append "page" var at the end
            $_query_str_page .= 'page=';
            // create full URL
            $_current_page = $_SERVER['PHP_SELF'].'?'.$_query_str_page;
        } else {
            $_current_page = $_SERVER['PHP_SELF'].'?page=';
        }
 
        // target frame
        $str_target_frame = 'target="'.$str_target_frame.'"';
 
        // init the return string
        $_buffer = '<span class="pagingList">';
        $_stopper = 1;
 
        // count the offset of paging
        if (($_page > 5) AND ($_page%5 == 1)) {
            $_lowest = $_page-5;
            if ($_page == $_lowest) {
                $_pager_offset = $_lowest;
            } else {
                $_pager_offset = $_page;
            }
        } else if (($_page > 5) AND (($_page*2)%5 == 0)) {
            $_lowest = $_page-5;
            $_pager_offset = $_lowest+1;
        } else if (($_page > 5) AND ($_page%5 > 1)) {
            $_rest = $_page%5;
            $_pager_offset = $_page-($_rest-1);
        } else {
            $_pager_offset = 1;
        }
 
        // Previous page link
        if (defined('lang_sys_common_paging_first')) {
            $_first = lang_sys_common_paging_first;
        } else {
            $_first = 'First Page';
        }
 
        if (defined('lang_sys_common_paging_prev')) {
            $_prev = lang_sys_common_paging_prev;
        } else {
            $_prev = 'Previous Page';
        }
 
        if ($_page > 1) {
            $_buffer .= ' &nbsp;';
            $_buffer .= '<a href="'.$_current_page.(1).$str_fragment.'" '.$str_target_frame.'>'.$_first.'</a>&nbsp; '."\n";
            $_buffer .= ' &nbsp;';
            $_buffer .= '<a href="'.$_current_page.($_page-1).$str_fragment.'" '.$str_target_frame.'>'.$_prev.'</a>&nbsp; '."\n";
        }
 
        for ($p = $_pager_offset; ($p <= $_num_page_total) AND ($_stopper < $int_pages_each_set+1); $p++) {
            if ($p == $_page) {
                $_buffer .= ' &nbsp;<b>'.$p.'</b>&nbsp; '."\n";
            } else {
                $_buffer .= ' &nbsp;';
                $_buffer .= '<a href="'.$_current_page.$p.$str_fragment.'" '.$str_target_frame.'>'.$p.'</a>&nbsp; '."\n";
            }
 
            $_stopper++;
        }
 
        // Next page link
        if (defined('lang_sys_common_paging_next')) {
            $_next = lang_sys_common_paging_next;
        } else {
            $_next = 'Next';
        }
 
        if (($_pager_offset != $_num_page_total-4) AND ($_page != $_num_page_total)) {
            $_buffer .= ' &nbsp;';
            $_buffer .= '<a href="'.$_current_page.($_page+1).$str_fragment.'" '.$str_target_frame.'>'.$_next.'</a>&nbsp; '."\n";
        }
 
        // Last page link
        if (defined('lang_sys_common_paging_last')) {
            $_last = lang_sys_common_paging_last;
        } else {
            $_last = 'Last Page';
        }
 
        if ($_page < $_num_page_total) {
            $_buffer .= ' &nbsp;';
            $_buffer .= '<a href="'.$_current_page.($_num_page_total).$str_fragment.'" '.$str_target_frame.'>'.$_last.'</a>&nbsp; '."\n";
        }
 
        $_buffer .= '</span>';
 
        return $_buffer;
    }
}
?>

Nah begitulah kira-kira sedikit mengenai penggunaan Zend Search Lucene untuk membuat indeks dokumen fulltext. Dari sini kita bisa saja kembangkan untuk membuat search engine kecil-kecilan yang bermanfaat buat kita, contohnya saya meng-indeks manual PHP offline HTML agar saya bisa dengan cepat menemukan topik yang saya ingin baca.

Untuk peng-indeksan skala besar (jumlah dokumen dalam ukuran giga atau tera), saya menyarankan untuk menggunakan engine-engine indexing yang sudah mumpuni seperti Lucene (java), Clucene (C++), Swish-e, Lemur, Terrier, Xapian dll. Semoga artikel ini bermanfaat untuk anda yang membacanya.

Bikin Search Engine FullText dengan Zend Search Lucene

2008-08-29T00:26:00.000-07:00

Zend Framework merupakan salah satu framework pengembangan aplikasi PHP yang canggih dan populer (ya iyaaalah yang buat developer di Zend, secara Zend yang buat engine pre-prosesor PHP). Framework ini tidak hanya menyediakan library-library yang memudahkan dalam pengembangan aplikasi yang modular dan kompleks, tetapi juga menyediakan fondasi pengembangan aplikasi model MVC (Model View Controller) yang sangat "sophisticated".

Salah satu library dari Zend Framework yang sangat bermanfaat untuk pengembangan mesin pencari/search engine adalah library Zend Search Lucene. Zend Search Lucene adalah porting dari Apache Lucene, engine Java untuk peng-indeksan dokumen full-text yang sangat canggih saat ini dan masih terus dikembangkan. Hebatnya, hasil index dari Zend Search Lucene bisa dipake juga oleh Lucene dan juga sebaliknya! Perlu diingat secara default Lucene dan turunannya hanya meng-indeks file-file teks biasa seperti HTML, XML, TXT dll. Untuk mengindeks file-file PDF, WORD, Excel, Powerpoint diperlukan eksternal parser yang berfungsi mengubah file-file dalam format tersebut ke dalam bentuk teks biasa. Kalo di platform Linux/UNIX untuk meng-indeks file WORD, Powerpoint dan Excel saya pake program command-line catdoc. Sedangkan untuk file-file PDF kita bisa menggunakan program xpdf untuk mem-parsing menjadi teks.

Sekarang kita langsung aja ke pratik-nya, bagaimana gunain Zend Search Lucene di program kita. Langkah pertama pastinya ada menginstall terlebih dahulu Zend Framework. Download versi terbaru dari Zend Framework di website resmi-nya lalu ikuti instruksi install-nya yang bisa dilihat pada dokumentasi resmi-nya. Setelah kita ter-install dengan baik, maka kita sudah bisa menggunakan library Zend Search Lucene dengan menambahkan baris :

<?php require 'Zend/Search/Lucene.php'; ?>

pada skrip PHP kita. Kalau saya menempatkan file tersebut pada file konfigurasi global aplikasi yang pasti selalu ter-include di hampir semua skrip aplikasi. Contohnya seperti ini :

<?php
/**
 * Arie Nugraha 2008
 * ZLucene config file
 *
 */
 
// Required Library
require 'Zend/Search/Lucene.php';
require 'lib/utils.inc.php';
 
ini_set('display_errors', false);
 
// Constant
define('INDEXES_DIR', 'indexes');
define('INDEXES_BASE_DIR', INDEXES_DIR.DIRECTORY_SEPARATOR.'index');
define('DOCS_DIR', 'docs');
define('DOCS_BASE_DIR', '.'.DIRECTORY_SEPARATOR.DOCS_DIR);
?>

Langkah selanjutnya adalah membuat yang namanya INDEX. INDEX mudahnya adalah database metadata dari semua keyword yang berada pada repository dokumen kita. Untuk membuat INDEX caranya seperti ini :

<?php
// check if the index is already available
try {
    if (file_exists(INDEXES_BASE_DIR)) {
        // open the index
        $index = Zend_Search_Lucene::open(INDEXES_BASE_DIR);
    } else {
        // create the index
        $index = Zend_Search_Lucene::create(INDEXES_BASE_DIR);
        define('NEW_INDEX_CREATED', 'New Indexes Created at '.INDEXES_BASE_DIR);
    }
    // set search result limit
    // Zend_Search_Lucene::setResultSetLimit(30);
    // set default search field
    Zend_Search_Lucene::setDefaultSearchField('content');
} catch (Zend_Search_Lucene_Exception $exc) {
    define('ERROR_OPEN_CREATE_INDEXES', 'Failed to open or create indexes file with error : '.$exc->getMessage());
}
?>

Setelah berhasil membuat INDEX, maka instance/objek hasil dari fungsi factory Zend_Search_Lucene::open (variable $index), bisa kita lakukan untuk melakukan berbagai macam manipulasi INDEX, seperti pencarian, manipulasi field metadata INDEX, dsb. Sebagai mana halnya kita membuat database biasa, metadata dari INDEX harus kita tentukan field-fieldnya. Untuk memudah manipulasi field metadata di kemudian waktu, maka saya membuat definisi field dalam bentuk array yang fleksibel :

<?php
// metadata field definition
$config['md_field']['indexed'][] = 'title';
$config['md_field']['indexed'][] = 'author';
$config['md_field']['unindexed'][] = 'file_name';
$config['md_field']['unindexed'][] = 'file_mime_type';
$config['md_field']['unindexed'][] = 'file_size';
$config['md_field']['unindexed'][] = 'input_date';
$config['md_field']['unindexed'][] = 'last_update';
$config['md_field']['unindexed'][] = 'checksum';
$config['md_field']['unstored'][] = 'content';
 
// metadata ID for document delete/update purpose
$config['md_id_field'] = 'checksum';
$config['md_id_checksumed_field'] = 'file_name';
$config['md_field']['keyword'][] = $config['md_id_field'];
?>

Ada beberapa tipe field metadata yang harus kita kenal di Zend Search Lucene :

Text
Tipe field yang di-indeks, disimpan pada INDEX dan di-tokenize (dipecah-pecah per-kata). Sangat berguna untuk menyimpan data-data seperti Subjek/Topik dokumen, Pengarang dan Judul dokumen.
Keyword
Tipe field yang di-indeks, disimpan pada INDEX tetapi tidak di-tokenize. Berguna untuk menyimpan istilah yang mengandung lebih dari satu kata dan tidak terpisahkan.
Unindexed
Tipe field yang tidak di-indeks, tetapi tersimpan dalam INDEX dan bisa dimunculkan pada hasil pencarian.
UnStored
Tipe field yang di-indeks dan di-tokenize, tetapi tidak tersimpan dalam INDEX. Tipe field ini bisa digunakan untuk menyimpan indeks konten/isi dokumen yang besar.

Untuk memudahkan dalam melakukan proses peng-indeksan saya membuat sebuah kelas yang berfungsi sebagai wrapper proses peng-indeksan. Kelas ini dilengkapi metode-metode tambahan untuk melakukan peng-indeksan isi directory secara recursif. Untuk saat ini, kelas ini hanya bisa melakukan peng-indeksan pada dokumen-dokumen text biasa seperti HTML, XML dan TXT. Definisi kelasnya sebagai berikut :

<?php
/**
 * Arie Nugraha 2008
 * A Zend Search Lucene Indexer Wrapper
 *
 */
 
class ZLucene_Indexer
{
    const AUTO_COMMIT_AFTER_INDEX = 1;
    private $zend_search_lucene = false;
    private $indexed_file_type = array('html', 'htm', 'xml', 'txt');
    private $recursive_index = false;
    private $doc_id_field = 'checksum';
    private $doc_id_checksumed_field = 'checksum';
    protected $md_fields = array();
 
    /**
     * Class Constructor
     *
     * @param   object  $obj_zend_search_lucene
     * @param   array   $array_md_fields
     */
    public function __construct($obj_zend_search_lucene, $array_md_fields)
    {
        if (!$obj_zend_search_lucene instanceof Zend_Search_Lucene_Proxy) {
            die('Please supply ZLucene_Indexer with valid Zend_Search_Lucene index instance');
        }
        $this->zend_search_lucene = $obj_zend_search_lucene;
        $this->md_fields = $array_md_fields;
    }
 
 
    /**
     * Method to set document ID field
     *
     * @param   string  $str_doc_id_field
     * @param   string  $str_doc_id_checksumed_field
     */
    public function setDocID($str_doc_id_field, $str_doc_id_checksumed_field)
    {
        $this->doc_id_field = $str_doc_id_field;
        $this->doc_id_checksumed_field = $str_doc_id_checksumed_field;
    }
 
 
    /**
     * Method to set recursive directory indexing for indexDirectory method
     *
     */
    public function setRecursiveIndex()
    {
        $this->recursive_index = true;
    }
 
 
    /**
     * Method to add one document to index
     *
     * @param   object  $obj_zend_search_document
     * @param   array   $array_field_data
     * @param   integer $int_zlucene_const
     */
    public function indexDoc($obj_zend_search_document, $array_field_data, $int_zlucene_const = 0)
    {
        // delete document from indexes first
        $deleted_term = new Zend_Search_Lucene_Index_Term($array_field_data[$this->doc_id_field], $this->doc_id_field);
        $deleted = new Zend_Search_Lucene_Search_Query_Term($deleted_term);
        $matches = $this->zend_search_lucene->find($deleted);
        if ($matches) {
            foreach ($matches as $doc) {
                $this->zend_search_lucene->delete($doc->id);
                // echo $doc->id.' deleted!<br />';
            }
        }
        // iterate trough metadata fields
        foreach ($this->md_fields as $field_type => $fields) {
            foreach ($fields as $field) {
                if ($field_type == 'indexed') {
                    if (isset($array_field_data[$field])) {
                        $obj_zend_search_document->addField(Zend_Search_Lucene_Field::Text($field, $array_field_data[$field]));
                        // echo $array_field_data[$field].' indexed!<br />';
                    }
                } else if ($field_type == 'unindexed') {
                    if (isset($array_field_data[$field])) {
                        $obj_zend_search_document->addField(Zend_Search_Lucene_Field::UnIndexed($field, $array_field_data[$field]));
                        // echo $array_field_data[$field].' unindexed!<br />';
                    }
                } else if ($field_type == 'unstored') {
                    if (isset($array_field_data[$field])) {
                        $obj_zend_search_document->addField(Zend_Search_Lucene_Field::UnStored($field, $array_field_data[$field]));
                        // echo $array_field_data[$field].' unstored!<br />';
                    }
                } else {
                    if (isset($array_field_data[$field])) {
                        $obj_zend_search_document->addField(Zend_Search_Lucene_Field::Keyword($field, $array_field_data[$field]));
                        // echo $array_field_data[$field].' keyword stored!<br />';
                    }
                }
            }
        }
        // add to index
        $this->zend_search_lucene->addDocument($obj_zend_search_document);
        // commit index change
        if ($int_zlucene_const === self::AUTO_COMMIT_AFTER_INDEX) {
             $this->zend_search_lucene->commit();
        }
    }
 
 
    /**
     * Method to index directory content
     *
     * @param   string  $str_dir_path
     * @param   array   $array_default_field_data
     */
    public function indexDirectory($str_dir_path, $array_default_field_data)
    {
        // check if directory exists
        if (!file_exists($str_dir_path)) {
            echo 'Directory '.$str_dir_path.' not exists!'."\n";
            return;
        }
        // open directory
        if ($directory = opendir($str_dir_path)) {
            // number of document indexed
            $doc_count = 0;
            // read directory content
            while (false !== ($file = readdir($directory))) {
                // ignore dots
                if ($file != '.' AND $file != '..') {
                    // current file
                    $file_path = $str_dir_path.DIRECTORY_SEPARATOR.$file;
                    // check if the $file is file or directory
                    if (is_dir($file_path) AND $this->recursive_index) {
                        $doc_count += self::indexDirectory($file_path, $array_default_field_data);
                    } else {
                        preg_match('@\.(html|htm|txt|xml)$@i', $file, $file_ext);
                        if (!empty($file_ext[1]) AND in_array($file_ext[1], $this->indexed_file_type)) {
                            // reset title field value
                            $metadata['title'] = null;
                            // set default mimetype
                            $file_mime_type = 'text/plain';
                            // get file content
                            $content = file_get_contents($file_path);
                            // get value of HTML title tags
                            if ($file_ext[1] == 'html' OR $file_ext[1] == 'htm' OR $file_ext[1] == 'xml') {
                                preg_match('@<title>(.+)<\/title>@i', $content, $title);
                                $file_ext[1] = ($file_ext[1] == 'htm')?'html':$file_ext[1];
                                $file_mime_type = 'text/'.$file_ext[1];
                                $metadata['title'] = !empty($title[1])?trim($title[1]):null;
                                // echo $title[1].'<br />';
                            } else if ($file_ext[1] == 'doc' OR $file_ext[1] == 'rtf') {
 
                            }
                            // set filename as a title field value
                            if (!$metadata['title']) {
                                $uc_file_name = ucwords(str_replace(array('-', '_'), ' ', $file));
                                // replace last file name extension
                                $metadata['title'] = preg_replace('@\.[^\.]+$@i', '', $uc_file_name);
                            }
                            $metadata['content'] = strip_tags($content);
                            $metadata['author'] = 'dicarve@yahoo.com';
                            $metadata['file_name'] = $file_path;
                            $metadata['file_size'] = filesize($file_path);
                            $metadata['file_mime_type'] = $file_mime_type;
                            // create checksum as an ID
                            $metadata['checksum'] = md5($metadata[$this->doc_id_checksumed_field]);
                            self::indexDoc(new Zend_Search_Lucene_Document(), $metadata);
                            $doc_count++;
                            // echo $metadata['title'].' succesfully indexed!<br />';
                        }
                    }
                }
            }
            // close directory handle
            closedir($directory);
            // commit index changes
            $this->zend_search_lucene->commit();
            // optimize the index
            $this->zend_search_lucene->optimize();
            return $doc_count;
        } else {
            die('Directory '.$str_dir_path.' is not readable. Please check directory permission!');
        }
    }
 
 
    /**
     * Method to parse Microsoft Word *.doc file with catdoc
     *
     * @param   string  $str_docfile_path
     * @return  string
     */
    public function parseMSWord($str_docfile_path, $str_catdoc_path = '/usr/bin/catdoc')
    {
        if (!file_exists($str_docfile_path)) {
            echo $str_docfile_path.' not found!'."<br />\n";
            return null;
        }
        if (!file_exists($str_catdoc_path) OR !is_executable($str_catdoc_path)) {
            echo $str_catdoc_path.' not found or not executable!'."<br />\n";
            return null;
        }
        $outputs = array();
        // execute catdoc
        @exec($str_catdoc_path, $outputs, $status);
 
    }
}
?>

Penggunaan kelas Zlucene_Indexer ini cukup mudah. Skrip untuk meng-indeks konten direktori /var/www/html/docs kira-kira seperti ini :

<?php
/**
 * Arie Nugraha 2008
 *
 */
 
// index directory content recursively
// set PHP script time limit
set_time_limit(0);
$start = microtime(true);
$dir_to_index = '/var/www/html/docs';
$ZLucene_Indexer = new ZLucene_Indexer($index, $config['md_field']);
// recursively index directory contents
$ZLucene_Indexer->setRecursiveIndex();
// set ID field
$ZLucene_Indexer->setDocID($config['md_id_field'], $config['md_id_checksumed_field']);
// array containing default metadata content
$doc_default_metadata= array();
// index directory contents
$num_indexed = $ZLucene_Indexer->indexDirectory($dir_to_index, $doc_default_metadata);
$end = microtime(true);
$index_time = $end-$start;
echo '<strong>'.$num_indexed.'</strong> documents indexed on <strong>'.$dir_to_index.'</strong> directory in '.$index_time.' seconds!'."\n";
?>

Sebagai catatan tambahan, Zend Search Lucene punya beberapa keterbatasan yaitu besar file INDEX maksimal hanya 2GB pada sistem operasi 32 Bit, proses peng-indeksan cenderung lambat terlebih apabila ukuran dan jumlah file besar (saya pernah mencoba mengindeks kurang lebih 11.000 dokumen HTML dan baru selesai dalam waktu setengah jam!).

Nah sekian dulu sampe disini pembahasan mengenai peng-indeksan dokumen full-text dengan menggunakan Zend Search Lucene. Pada posting blog yang akan datang saya akan membahas juga mengenai cara pencarian dokumen pada Zend Search Lucene.

var Prototype.js ={efek : 'Javascript Semakin Mudah!'}

2008-07-24T19:26:00.000-07:00

Dengan semakin booming-nya (baca: Meledak) Web 2.0, saat ini banyak sekali bermunculan library-library Javascript yang menawarkan kemudahan untuk DHTML dan AJAX seperti JQuery, Prototype, Script.acu.lo.us, openRico, Dojo dan masih banyak lagi yang lainnya. Ketika saya mulai mengembangkan Senayan, aplikasi berbasis web untuk automasi perpustakaan, saya mulai mendalami lagi Javascript dan salah satu library Javascript yang bikin saya "kepincut" dan saya gunakan pada Senayan adalah Prototype yang dikembangkan pertama kali oleh Sam Stephenson.

Jujur saya tertarik pertama kali dengan Prototype karena kemudahan dalam pemrosesan request AJAX-nya. Yang kedua dan tidak kalah pentingnya adalah kemampuannya yang Cross-Browser, ga perlu repot-repot lagi kita nambahin logic untuk nge-cek browser yang ribet. Prototype compatible dengan hampir semua browser populer yang ada di muka bumi ini macam Mozilla Firefox, Opera, Konqueror, Safari, dan juga browser paling "menakjubkan" (baca: Suckss!) di muka bumi ini, Internet Explorer.

Dulu saya berpikir Javascript tu bahasa pemrograman paling "dodol" a.k.a "nyebelin" a.k.a "brengsek". Tetapi sejak munculnya library Prototype dan dukungan DOM serta AJAX pada semua browser sudah menjadi standar perlahan-lahan saya berubah pikiran, "Javascript Semakin Cakep dan Sangat Diperlukan untuk semakin membuat aplikasi web setara dengan aplikasi Desktop". Dengan adanyan Prototype hidup semakin mudah, pemrosesan DHTML yang Cross-Browser juga menjadi sangat mudah dilakukan. Kita bisa dengan mudah me-modifikasi style CSS pada suatu element secara interaktif lalu mengubah konten element tersebut secara interaktif dengan mudah hanya dengan menggunakan 1 baris kode!

Tentunya ga enak kalo saya sesumbar disini tapi ga ngasih contoh. Aturan utama untuk menggunakan Prototype adalah meng-include file library Prototype terlebih dahulu di halaman HTML kita (sangat disarankan di dalam tag HEAD).

<html><head>
<script type="text/javascript" src="libjs/prototype.js"></script>
</head>

Sekarang kita coba melakukan Request AJAX dengan menggunakan Prototype:

<div id="ajaxContainer">&nbsp;</div>
<script type="text/javascript">
// URL request AJAX yang kita ingin ambil datanya
var ajaxURL = 'ajax_response.php';
// lakukan request AJAX dengan membuat instance Ajax.Request
new Ajax.Request(url, { method: 'get',
  onSuccess: function(ajaxObject) {
    // ambil text hasil response AJAX
    var ajaxResponseText = ajaxObject.responseText;
    // Prototype memudahkan kita dalam mengupdate konten suatu element dengan method "update". Dibawah ini element <div> dengan id "ajaxContainer" akan diupdate konten-nya dengan hasil response AJAX
    var ajaxContainer = $('ajaxContainer').update(ajaxResponseText);
  },
  onFailure: function(ajaxObject) {
    alert('Terjadi Error pada Request AJAX ke URL : ' + ajaxURL);
  } 
});
</script>

Pada kode di atas apabila request AJAX berhasil dilakukan maka element <div> akan diisikan dengan text response AJAX, tetapi apabila request AJAX gagal dilakukan (onFailure), maka akan muncul alert yang memberitahu bahwa request AJAX gagal dilakukan. Sangat mudah bukan? Wow tapi nanti dulu!! masih ada yang lebih keren! bagaimana kalau kita mau hasil dari AJAX-nya bukan teks biasa tetapi hasilnya berupa HTML yang akan langsung kita include-kan di halaman web kita? Disinilah fungsi kelas Ajax.Updater akan sangat menolong hidup kita (ciaaa.. illaahh) :

<div id="ajaxContainer">&nbsp;</div>
<script type="text/javascript">
// URL untuk request AJAX
varajaxURL = "ajax_updater_response.php"
// parameter GET atau POST yang ingin kita sertakan pada request
var reqParams = "param1=Nilai+Param+1&param2=Nilai+Param+2"
// method pengiriman request, bisa GET, POST atau bahkan PUT
var reqMethod = 'post';
// ID element yang akan menampung HTML hasil response Ajax.Updater
var ajaxContainer = 'ajaxContainer';
// Buat instance Ajax.Updater
new Ajax.Updater(ajaxContainer, ajaxURL, {
  method: reqMethod, parameters: reqParams
});
</script>

Misalkan pada file "ajax_updater_response.php" mengandung kode PHP yang menghasilkan HTML seperti ini :

<?php
// pastikan bener-bener hasilnya HTML
header("Content-type: text/html");
$sql_q = $mysql->query("SELECT * FROM someSQLtable WHERE name LIKE '%".$mysql->escape_string($_POST['param1'])."%'
   LIMIT 100");
// loop data dan tampilkan dalam tabel HTML
echo '<table class="datalist">';
while ($sql_d = $sql_q->fetch_row()) {
    echo '<tr>';
    echo '<td>'.$sql_d[0].'</td>';
    echo '<td>'.$sql_d[1].'</td>';
    echo '<td>'.$sql_d[2].'</td>';
    echo '</tr>';

}
echo '</table>';
?>

Mantapp! Gampang bener yak!! Trus, trus bagaimana kalo gw mau hasil respons AJAX-nya berupa JSON biar gw bisa proses lagi rie? Yahhhhh itu mah gampang!! begini caranyan :

<div id="ajaxContainer">&nbsp;</div>
<script type="text/javascript">
// URL request AJAX yang kita ingin ambil datanya
var ajaxURL = 'ajax_response.php';
// lakukan request AJAX dengan membuat instance Ajax.Request
new Ajax.Request(url, { method: 'get',
  onSuccess: function(ajaxObject) {
    // ambil text hasil response AJAX dan strip space di kiri dan kanan string biar ga ganggu
    var ajaxResponseText = ajaxObject.responseText.strip();
    // Convert hasil response AJAX ke objek JSON dengan menggunakan method evalJSON() milik Prototype!
    var ajaxJSON = ajaxResponseText.evalJSON();
    // Proses object JSON anda di bawah ini
    ...
  },
  onFailure: function(ajaxObject) {
    alert('Terjadi Error pada Request AJAX ke URL : ' + ajaxURL);
  } 
});
</script>

Pada halaman response AJAX "ajax_response.php" mengandung kode seperti ini :

<?php
header("Content-type: text/javascript");
$sql_q = $mysql->query("SELECT * FROM someSQLtable WHERE name LIKE '%".$mysql->escape_string($_POST['param1'])."%'
   LIMIT 100");
// loop data dan simpan dalam Array
$array_rows = array();
while ($sql_d = $sql_q->fetch_row()) {
    $array_rows[] = $sql_d;
}
// encode ke dalam bentuk JSON
echo json_encode($array_rows);
?>

Oke segitu dulu deh posting saya mengenai AJAX di Prototype, insya ALLAH nanti akan saya bahas lebih lanjut lagi penggunaan Prototype untuk membuat dynamic AJAX drop-down yang populer itu. Silahkan anda mendownload dan coba menggunakan Prototype sekarang juga, "Javascript never been these easy!!".

Kembali Ke Linux!!

2007-10-30T08:06:00.000-07:00

Kalo kata Tukul :
"Kembali Ke Laptop!!"
Kalo kata gw :
"Kembali Ke Linux!!"

Yahh betul, memang agak cukup memalukan, setelah sebelumnya gw "mendeklarasikan" diri sebagai pengguna si "setan merah" (baca: FreeBSD), akhirnya gw kembali switch ke Linux. Pilihan jatuh kepada distro turunan "slackware", Zenwalk Linux. Udah hampir setaon gw nginstall Zenwalk di laptop gw, sejak versi 4.4, dan baru-baru ini gw upgrade ke rilis stable terbaru, versi 4.8 .


Desktop Zenwalk Linux baru gw

Kenapa gw akhirnya milih Zenwalk, yang notabene turunan Slackware (yang konon katanya instalasinya susah, karena masih pake "curses" alias berbasis teks biasa)? Ada beberapa alasan :

Instalasinya menantang!! (ga penting), partisi hard disknya berbasis teks pake cfdisk!!, tapi cepet bro proses instalasinya, ga nyampe setengah jam Zenwalk is ready to rocks!!
Slackware itu agak-agak mirip FreeBSD desainnya, simple, fast dan secure
Performance, gw butuh performance yang kenceng dari sebuah Linux di laptop gw dan Zenwalk yang di-desain untuk kelas Pentium III adalah pilihan pas (laptop gw pake Intel Centrino, RAM 768, VGA Intel 915 Onboard)
Software bawaan default Zenwalk udah asoy banget dan cukup lengkap, tools development kaya GCC, glibc, make dll udah ada, untuk multimedia hampir semua codec video dan format file musik bisa "langsung" dimaenin
Init scriptnya gampang dimodifikasi, tinggal cemplungin aje script kita ke dir /etc/rc.d/, trus buat filenya executable, langsung dah script kita jalan pas booting
Udah pake Kernel 2.6.22, udah ada wireless stacknya dan wireless card udah langsung ke-detect, tinggal install driver-nya atawa pake "ndiswrapper"
Untuk update package/software udah ada software xnetpkg, mirip2 sama synaptic gicuu dech
Desktop defaultnya XFCE 4, which is very light, fast, simple and easy. I Loveee the XFCE file manager, Thunar, very fastttttttt......
Untuk urusan "desktop eye candy", semua icons dan themes punya GNOME bisa kita pake di XFCE (secara mereka punya fondasi yang sama)

MySQL Improved alias MySQLI!

2007-04-03T20:27:00.000-07:00

Sejak PHP 5 dirilis, muncul extension baru sebagai API ke RDBMS MySQL. Extension baru ini dinamakan MySQLI atau MySQL Improved. MySQLI memperkenalkan cara baru dalam berinteraksi dengan database server MySQL melalui PHP (dan konon lebih cepat dan lebih secure, walaupun gw sendiri belum pernah melakukan benchmark).

Yang paling keren menurut gw adalah model OOP baru dari MySQLI ini. Jadi di MySQLI kita bisa menggunakan 2 style coding, OOP ataupun prosedural. Model OOP-nya asyyiik banget dan lengkap.

Untuk nginstall extension MySQLI di Linux cukup gampang, cari aja paket-paket binary yang udah disediain ma distro masing-masing atau kalo kita biasa compile sendiri maka kita harus nambahin flag :

--with-mysqli=shared,/usr/local/mysql/bin/mysql-config

pada command configure kita
Kalo di Windows lebih gampang lagi, cukup tambahin baris :

extension=php_mysqli.dll

pada deretan module-module extension yang laennya di file php.ini. Trus restart deh Web Server-nya.

Langsung aja kita liat contoh implementasi extension MySQLI di source code PHP kita, begini nih caranye :

<?php
 
// buat constant 
define('DB_HOST', 'localhost');
define('DB_USER', 'dicarve');
define('DB_PASS', 'dicarvepass');
define('DB_NAME', 'dicarvedb');
define('DB_PORT', '3306');
 
// cek dulu apa extensionnya dah aktif pa belom?
if (!extension_loaded('mysqli')) {

    echo 'Extension MySQLI belum terinstall dengan benar. check php.ini';
    exit();
}
 
// buat objek mysqli
$mysqli_obj = new mysqli(DB_HOST, DB_USER, DB_PASS, DB_NAME, DB_PORT);

 
/* cek apakah koneksi berhasil dilakukan */
if (mysqli_connect_errno()) {
    echo 'Koneksi gagal dilakukan dengan alasan : '.mysqli_connect_error();
    exit();
} else {

    echo 'Koneksi berhasil dilakukan<br />'."\n";
    echo 'Versi Server MySQL : '.$mysqli_obj->server_info."<br />\n";

}
 
 
/* tutup koneksi ke db server */
$mysqli_obj->close();
?>

Ya ampuunn, ternyata gampang bener yah!! Weiittsss nanti dulu, itu baru koneksi-nya aja gimana untuk ngirim query ke database server-nya? ini sedikit contoh query SELECT yang menghasilkan resultset (atau recordset, whatever lahh) :

<?php
 
// include file source code koneksi database sebelumnya
// yang misalnya udah kita kasih nama 'mysqli.inc.php';
require 'mysqli.inc.php';
 
// untuk melakukan query kita menggunakan 
// metode 'query' milik kelas mysqli

// hasil dari pemanggilan metode ini nantinya akan
// menghasilkan sebuah objek baru milik kelas mysqli_result
$result_obj = $mysqli->query("SELECT nama FROM tabel_dicarve");
 
// cek apakah query berhasil dilakukan
if ($result_obj) {

    // gunakan properti publik 'num_rows' milik kelas mysqli_result
    // untuk mengetahui jumlah baris hasil query
    echo 'Ditemukan '.$result_obj->num_rows.' baris data<br /><br />';

 
    echo 'Data-data yang ditemukan adalah sbb : <br />';
 
    // gunakan metode 'fetch_row' untuk mengambil data baris demi baris dari resultset
    while ($data = $result_obj->fetch_row()) {

        echo $data[0].'<br />'."\n";
    }
 
    // bebaskan memory resultset

    $result_obj->close();
}
 
$mysqli_obj->close();
?>

Lohh?? Cuman segitu doank toh MySQLI? Tau gitu mah gw mendingan pake extension MySQL biasa aja dechh (cappeee dehh!!). Ya Enggak Lah!!! ada beberapa fitur baru yang menarik di MySQLI selaen koneksi dan query sederhana, misalnya meng-execute query SQL secara multiple dengan langsung dalam satu statement (bukan dengan pemanggilan metode 'query' berulang-ulang). Coba liat contoh berikut ini deh :

<?php
 
// include file source code koneksi database sebelumnya
// yang misalnya udah kita kasih nama 'mysqli.inc.php';
require 'mysqli.inc.php';
 
// setiap query SQL kita pisahkan dengan semi-colon atawa titik koma
$queries  = "SELECT gmd FROM tabel_gmd;";

$queries .= "SELECT nama FROM tabel_dicarve;";
$queries .= "SELECT judul FROM tabel_biblio";
 
// gunakan metode 'multi_query'
// untuk meng-execute string query SQL multiple secara simultan
$multi_query_obj = $mysqli_obj->multi_query($queries);

 
/* execute multi query */
if ($multi_query_obj) {
    // loop masing-masing result-nya
    while (true) {

        // ambil result set multiple query dengan metode 'store_result'
        if ($result = $mysqli_obj->store_result()) {
            while ($row = $result->fetch_row()) {

                echo $row[0]."<br />\n";
            }
 
            // bebasin memory resultset
            $result->close();
        }        

 
        // apakah masih ada resultset lagi?
        // kalau udah abis kita stop loop-nya
        if (!$mysqli_obj->more_results()) {
            break;
        } else {

            // kita buat pemisah antar resultset dengan garis horizontal HTML <hr>
            echo "<hr>\n";
        }
    }
}
 
/* tutup koneksi ke server */

$mysqli_obj->close();
?>

Nah itu dia sekilas penggunaan extension MySQLI di PHP, masih banyak fitur lain yang saya ga bisa jelasin satu persatu di sini (takutnya blog ini malah isinya MySQLI melulu). Buat programmer PHP yang demen pake model OOP, MySQLI cocok banget untuk digunain sebagai bagian dari kode-kode mereka. SELAMAT MENCOBA!!

Virtual Machine, OS di dalem OS?? Lohh!!??

2006-05-07T07:48:00.000-07:00

Perkembangan Open Source Software (OSS) kayanya makin gila dan asik aja belakangan ini, walaupun saya rada sebel ngeliat distro-distro Penguin (baca: LINUX) yang semakin bervariasi dan makin banyak jenisnya itu. Akhirnya sekarang saya ngekor Hendro Wicaksono, ikut-ikutan pake FreeBSD. Ternyata asiikk juga pake Operating System (OS) yang satu ini, BELOM terlalu banyak variannya trus nawarin konsep port, instalasi aplikasi 3rd party lansung dari source code tapi udah di-patch sama orang-orang di freebsd.org biar kompilasinya bisa sesuai sama FreeBSD. Udah gitu banyak belajar konsep network security juga dari FreeBSD, karna OS yang satu ini menurut developer-nya udah "secure by default". At least setelah melalui journey mencari OS berbasis *NIX yang ingin saya dalami, saya menjatuhkan pilihan pada FreeBSD dengan logonya si Daemon yang imut itu (goodbye Ubuntu, that doesn't mean i hate you).

Lohh kok jadi curhat masalah OS, bukan masalah ini yang saya pengen omongin tapi saya mau ngomongin mengenai teknologi software yang lagi anget-angetnya saat ini yaitu Virtual Machine. Apaan lagi tuh Virtual Machine (kita singkat aja dia VM)? Gampangnya VM adalah sebuah aplikasi yang memungkinkan kita menjalankan sebuah atau beberapa OS lainnya di dalam sebuah OS. Gila yah? iya emang gila saya juga bingung kok bisa-bisanya (lagi-lagi saya senyum sendiri dan geleng-geleng kepala ngeliat programmer Open Source). Dengan VM kita bisa menjalankan 2, 3, 4, 5 atau 6 OS sekaligus dalam SATU komputer yang berperan sebagai Host OS. Dalam domain VM ada dua istilah penting, Host OS dan Guest OS. Host OS adalah OS yang yang menjadi induk utama bagi OS-OS virtual lainnya. OS-OS virtual ini disebut juga Guest OS atau OS tamu (bisa yah OS namu, silaturahmi ke OS lainnya). Saya dah mencoba salah satu VM yang sekarang cukup populer di dunia OSS saat ini yaitu QEMU (baca: kiemu). QEMU berlisensi GPL kecuali untuk modul akselerasi kernel-nya yang free tapi Closed Source namanya KQEMU. Saya install QEMU di FreeBSD saya, awalnya saya coba compile sendiri (saya coba apply patch FreeBSD ke source code asli-nye) tapi pada akhirnya karna gagal trus pas proses kompilasi sampe saya gedegg banget. Akhirnya saya install ajah yang binary-nye yang udah mateng tinggal dilahap. Trus saya install module kernel-nya pake ports FreeBSD (alhamdulillah lancar) dan VOIILLAA!!! saya nginstall FreeBSD 5.4, 6.0 sama Ubuntu di dalem OS FreeBSD 5.4 saya.

Klik pada screenshot buat memperbesar :

FreeBSD 6.0 dengan desktop KDE di atas FreeBSD 5.4

Ubuntu 5.10 di atas FreeBSD 5.4 (sambil dengerin MP3)

Lagi-lagi FreeBSD 6.0 dengan desktop KDE di atas FreeBSD 5.4 (ngetik di Koffice)

QEMU sedang mem-boot FreeBSD 5.4

QEMU sedang menjalankan FreeBSD 5.4 dan 6.0 dalam mode teks

Saya tertarik sama QEMU karena VM ini memungkinkan kita membangun virtual network, jadi saya yang masih awam network ini bisa belajar networking tanpa harus punya banyak PC! Gila! si QEMU ini ternyata bisa juga mem-virtualkan network, bahkan antar sesama Guest OS-pun bisa saling dihubungkan dalam sebuah virtual network. QEMU ternyata mensimulasikan kartu network virtual untuk setiap Guest OS (saya lupa tipe-nya apa kalo ga salah Novell deh). Kebetulan komputer di rumah RAM-nya agak gede 768 MB, jadi saya agak bebas eksperimen nginstall 2 sampe 3 Guest OS.

QEMU bisa mem-virtualisasikan hampir semua OS yang ada di muka bumi saat ini tidak terbatas pada OS-OS berarsitektur X86 saja, tapi Mac, OS X yang berbasis PowerPC pun bisa divirtualkan. menurut Fabrice Bellard, sang pembuat QEMU, Modul kernel KQEMU dikatakan bisa mempercepat proses virtualisasi Guest OS hingga mendekati kecepatan native (seperti menjalankan OS langsung). Hal ini bisa terjadi karena KQEMU memungkinkan kode-kode Guest OS dijalankan langsung ke prosesor.

Untuk menjalankan Guest OS dibutuhkan image dari Guest OS atau kita bisa membuat sebuah image kosong dengan menggunakan tool command-line qemu-img. Image kosong ini nantinya kita akan isikan dengan Guest OS, misalnya Kubuntu, Fedora ataupun Windows XP. Cara membuatnya adalah dengan mengetikan perintah berikut ini pada console :

qemu-img create kubuntu.img 2G

Perintah di atas akan membuat sebuah image kosong dengan nama kubuntu.img, berukuran 2 Giga. Sekarang bagaimana cara kita untuk mengisikan Guest OS Kubuntu linux kita ke dalam image kosong tadi? Caranya mudah, masukan CD instalasi Kubuntu ke dalam drive CD (ga perlu di mount CD-nya) dan periksa nama device CD-nya (biasanya /dev/acd0) dan kemudian jalankan perintah berikut ini :

qemu -dummy-net -m 256 -boot d -cdrom /dev/acd0 -hda /home/dicarve/kubuntu.img

perintah di atas akan menjalankan QEMU untuk memboot CD dari /dev/acd0 dan kemudian memulai proses instalasi ke dalam image kubuntu.img. Ikutin aja proses instalasinya kaya kita lagi nginstall OS biasa sampe selesai.

Apabila CD instalasi OS kita lebih dari satu maka untuk meng-eject CD dari CD Drive kita harus masuk ke dalam QEMU Monitor dengan menekan [Ctrl]+[Alt]+[2]. QEMU Monitor adalah shell khusus QEMU yang berguna untuk misalnya mem-pause proses emulasi, mengeluarkan CD dari CD Drive, me-reboot ulang Guest OS, mengganti drive CD dan lain-lain. Untuk mengganti CD pada Guest OS jalankan perintah berikut pada QEMU monitor :

qemu> stop
qemu> eject cdrom

lalu keluarkan CD dari CD Drive dan masukan CD berikutnya
qemu> change cdrom /dev/acd0 (pada FreeBSD drive CD pertama berada pada /dev/acd0)
qemu> continue Kembali ke Guest OS dengan menekan [Ctrl]+[Alt]+[1]

Proses instalasi windows XP dengan QEMU

Windows 2000 dijalankan dengan QEMU pada Linux

Di web juga banyak yang nyediain image-image OS yang tinggal di pake. Coba kunjungin qemu.org.

VM bisa menjadi solusi bagi server-server kecil yang ingin memisahkan fungsi-fungsi seperti Web Server, Mail Server, Firewall dsb. Masing-masing bisa diinstalasikan pada Guest OS yang berbeda dan dihubungkan dengan virtual LAN. Hal ini tentunya juga dimungkinkan apabila hardware server mendukung. Pertimbangan memakai QEMU utamanya adalah memaksimalkan penggunaan resource hardware yang ada. Untuk apa membeli server baru hanya untuk firewall apabila, server yang sudah ada hanya menggunakan 25% resource komputer. Selain QEMU saat ini juga ada beberapa VM lainnya seperti Xen yang terkenal karena kehebatannya menjalankan Guest OS dengan kemampuan native. Xen bahkan sudah disertakan secara default pada distro-distro Linux besar seperti Suse dan Fedora. VMware adalah VM komersial yang terkenal karena kemudahan instalasi dan konfigurasinya.

Nginstall Apache, MySQL dan PHP di Linux

2006-04-26T01:18:00.000-07:00

Pernah coba install Apache, MySQL dan PHP di Linux (LAMP), 4 sekawan sakti yang paling banyak dipake di Internet saat ini? atau pengen coba tapi udah jiper duluan karena keliatannya susah? Semoga pengalaman saya nginstall di Ubuntu Linux bisa jadi batu loncatan buat belajar nginstall AMP di Linux. Sebenarnya install AMP di Linux itu kalo mau nyoba dan usaha ga susah (kalo belajar maunya gampang doank ga dapet ilmu apa-apaan donk!!), intinya "keep trying". Semua proses instalasi dilakukan dengan menggunakan source code Apache, MySQL dan PHP.

Source code ini bisa didownload di website resmi masing-masing :

Biar lebih cepat proses download-nya, cari mirror-mirror download yang berada di Indonesia, atau kalau tidak ada cari mirror terdekat, seperti Singapura atau Australia (itung-itung menghemat bandwidth Internet ke luar negeri).

Semua proses instalasi dan kompilasi dilakukan pada console atau terminal dan juga pastikan gcc, glibc, g++ sudah terinstall (kalo ga punya g++, gcc juga bisa dipake buat compile c++, tinggal tambahin : CXX=gcc sebelum perintah ./configure), karena tanpa ketiga aplikasi ini kita tidak bisa melakukan kompilasi source code. Untuk melakukan proses instalasi hingga tuntas maka kita menggunakan user tertinggi di Linux yaitu root. Untuk meng-kompilasi PHP pastikan bahwa parser Bison GNU (versi-versi terbaru kalo bisa -- kalo engga ada Bison parser Yacc juga bisa diterima) dan juga Flex.

Untuk ngecheck-nya apakah Bison dan Flex udah ke-install apa belum lakuin perintah berikut ini :

which bison
which flex

kalo engga ada juga gimana? jangan menyerah, download aja versi pre-compiled (tergantung distribusi Linux apa yang diinstall), di Ubuntu saya cari pre-compiled binary Bison yang khusus Debian Ubuntu.

Yang pertama saya install biasanya adalah Apache, kedua MySQL dan terakhir baru PHP. Kenapa saya pake urutan begini? karena untuk install PHP sebagai module apache dan gunain client library MySQL di PHP kita butuh Apache dan MySQL yang sudah terinstall sebelumnya.

Extract source Apache dengan melakukan perintah sebagai berikut :

tar -xvzf httpd-2.2.x.tar.gz

masuk ke dalam direktori httpd-2.2.x dengan menjalankan perintah berikut :

cd httpd-2.2.x

di dalam direktori ini lakukan perintah berikut :

./configure --prefix=/opt/apache2/ --enable-so -- tunggu sampai proses konfigurasi selesai --

setelah proses konfigurasi instalasi selesai tanpa masalah (biasanya kalau ada masalah proses akan berhenti di tengah jalan dan akan mengeluarkan error) maka jalankan perintah berikut untuk memulai proses kompilasi apache :

make -- tunggu sampai proses kompilasi selesai --

apabila proses kompilasi berjalan lancar tanpa error maka selanjutnya adalah melakukan perintah berikut untuk menginstall apache ke tempat yang sudah kita tentukan (dalam hal ini adalah /opt/apache2/ ) :

make install

sekarang web server apache kita sudah terinstall di /opt/apache2/. Untuk mencoba menjalankan daemon apache maka lakukan perintah berikut ini :

/opt/apache2/bin/apachectl start -- untuk saat ini abaikan saja warning-warning yang keluar, kecuali ERROR -- cek apakah apache sudah benar-benar berjalan dengan melakukan perintah berikut ini :

ps ax | grep httpd -- apabila berjalan maka akan tampil daftar proses milik apache yaitu httpd --

Agar lebih secure, buat group dan user baru dengan nama sama yaitu apache. Bisa dilakukan dengan menjalankan perintah berikut ini :

addgroup apache
adduser -s --no-create-home -G apache apache

Sekarang langkah selanjutnya adalah melakukan kompilasi source code MySQL. Download saja MySQL versi 4.1.x. Extract source MySQL dengan melakukan perintah sebagai berikut :

tar -xvzf mysql-4.1.x.tar.gz

masuk ke dalam direktori mysql-4.1.x dengan menjalankan perintah berikut :

cd mysql-4.1.x

di dalam direktori ini lakukan perintah berikut :

./configure --prefix=/opt/mysql4/ -- tunggu sampai proses konfigurasi selesai --

setelah proses konfigurasi instalasi selesai tanpa masalah (biasanya kalau ada masalah proses akan berhenti di tengah jalan dan akan mengeluarkan error) maka jalankan perintah berikut untuk memulai proses kompilasi mysql :

make -- tunggu sampai proses kompilasi selesai --

apabila proses kompilasi berjalan lancar tanpa error maka selanjutnya adalah melakukan perintah berikut untuk menginstall mysql ke tempat yang sudah kita tentukan (dalam hal ini adalah /opt/mysql4/ ) :

make install

sekarang MySQL sudah terinstall di /opt/mysql4/. Untuk mulai menggunakan server MySQL kita harus melakukan inisialisasi GRANT TABLE milik MySQL. Inisialisasi GRANT TABLE bisa dilakukan dengan menggunakan perintah :

/opt/mysql4/bin/mysql_install_db

selanjutnya adalah kopi file my-medium.cnf yang terletak pada direktori /opt/mysql4/share/mysql/ ke direktori /etc/ dengan merubah namanya menjadi my.cnf. Perintahnya adalah seperti ini :

cp /opt/mysql4/share/mysql/my-medium.cnf /etc/my.cnf

buat user baru khusus untuk MySQL dengan melakukan perintah berikut :

addgroup mysql
adduser -s --no-create-home -G mysql mysql

setelah itu coba jalankan server MySQL dengan melakukan perintah berikut ini :

/opt/mysql4/share/mysql/mysql.server start

apabila berhasil maka akan muncul status seperti ini "Starting MySQL..... [OK]" dan selanjutnya sudah bisa melakukan query-query kepada server dengan masuk ke dalam program client command-line mysql :

/opt/mysql4/bin/mysql -- apabila berhasil maka akan dibawa masuk ke dalam program dan ada greetings "Welcome to MySQL ....." --

Sekarang last but NOT LAST adalah meng-kompilasi bahasa pemrograman favorit saya, yaitu PHP. Extract source code PHP dengan melakukan :

tar -xvzf php-4.4.x.tar.gz

masuk ke dalam direktori php-4.4.x dengan menjalankan perintah berikut :

cd mysql-4.4.x

di dalam direktori ini lakukan perintah berikut :

./configure --prefix=/opt/php4/ --with-config-file-path=/etc/php/ --with-config-file-scan-dir=/etc/php/ --with-apxs2=/opt/apache2/bin/apxs --with-mysql=/opt/mysql4/ --enable-mbstring -- tunggu sampai proses konfigurasi selesai --

setelah proses konfigurasi instalasi selesai tanpa masalah (biasanya kalau ada masalah proses akan berhenti di tengah jalan dan akan mengeluarkan error) maka jalankan perintah berikut untuk memulai proses kompilasi php :

make -- tunggu sampai proses kompilasi selesai --

lalu jalankan :

make install

sekarang lengkap sudah AMP kita di Linux. Tapi tunggu!!?? bagaimana caranya agar web server kita bisa ngerti PHP? apa otomatis gitu aja? engga juga. Sekarang kita harus buka file /opt/apache2/conf/httpd.conf dan memodifikasi-nya sedikit. Buka saja dengan vi atau apabila sudah menggunakan desktop GNOME misalnya, buka saja dengan menggunakan gedit. Yang harus diubah adalah :

User nobody
Group -1

ganti dengan :

User apache
Group apache

lalu tambahkan pada baris terakhir :

# PHP
AddType application/x-httpd-php .php

Untuk testing apakah sudah berjalan dengan baik, maka buat sebuah file php di dalam /opt/apache2/htdocs/ dengan nama test.php dan isikan dengan :

<?php phpinfo(); ?>

save file dan keluar. Restart web server apache agar apache membaca ulang file konfigurasi yang baru diubah dengan menjalankan perintah :

/opt/apache2/bin/apachectl restart

buka browser dan ketikan http://localhost/test.php pada kotak URL, dan lihat apakah skrip PHP yang baru kita buat sudah terinstall.

Full Open Source Web Design and Programming. Kata siapa ga mungkin?

2006-04-12T02:44:00.000-07:00

Mayoritas web designer dan web programmer di Indonesia (koreksi apabila saya salah) masih sangat tergantung pada software-software proprietary/shareware dalam mendesain dan merancang web. Daya beli masyarakat kita yang rendah pada akhirnya mendorong penggunaan software-software bajakan seperti Macromedia Dreamweaver, Adobe Photoshop, Adobe Illustrator, Macromedia Flash dsb. 5 atau 4 tahun yang lalu mungkin akan sangat sulit untuk mencari aplikasi-aplikasi Open Source untuk menandingi software-software proprietary tersebut, tetapi seiring perkembangan OSS (Open Source Software) yang sangat pesat beberapa tahun belakangan seperti Inkscape, GIMP, Sodipodi, Eclipse, Quanta Plus dan belakangan ini Xara Xtreme merupakan isyarat bagi web designer dan web programmer untuk segera bermigrasi penuh ke OSS.

Dari pengalaman saya sendiri dalam membangun beberapa aplikasi berbasis web (yang saya juga bertindak sebagai designer interface-nya), ternyata tidak memerlukan waktu yang lama untuk membiasakan diri menggunakan OSS secara penuh dalam men-develop sebuah aplikasi berbasis web. Ketika saya menggunakan desktop Ubuntu linux pertama kalinya saya juga sempat bingung mau memakai software apa untuk mendesain interface aplikasi nantinya. Terima kasih kepada komunitas Open Source yang tidak kenal lelah telah menghasilkan software-software pengolah vektor seperti Inkscape dan XaraXtreme, serta untuk image editing, GIMP yang telah matang di versi ke 2 ini.

2 Aplikasi web based yang saya bangun dengan Full OSS

Inkscape on Action

Untuk ilustrasi saya sudah terlanjur jatuh cinta pada inkscape (alhamdulillah telah tersedia untuk versi windows-nya) dan untuk editing image saya menggunakan GIMP versi 2.2.10. Kedua software tersebut apabila digabungkan penggunaannya ternyata cukup dahsyat dalam menghasilkan design mock-up web. Apalagi bila kita sudah faseh terhadap semua tools yang ada pada Inkscape dan GIMP (yang saya yakin baru memaksimalkannya paling-paling 10%). Intinya dalam menguasai sebuah software grafis adalah explorasi dan maksimalisasi tools yang ada. Bagi mereka yang terbiasa menggunakan photoshop mungkin akan sedikit sulit saat menggunakan GIMP, karena windowing system-nya yang terbilang cukup merepotkan, tetapi semua itu hanya butuh adaptasi saja (alah bisa karena biasa). Inkscape juga menawarkan perbedaan dibandingkan dengan aplikasi pengolah vektor lainnya, karena Inkscape menggunakan format SVG (Scalable Vector Graphics) sebagai format native-nya. Hal ini tentunya merupakan sebuah inovasi yang brilian, karena dengan built-in XML editornya kita bisa saja "menggambar dengan tidak menggambar". Apa maksudnya?? apabila kita telah terbiasa dengan spesifikasi XML SVG, maka bisa saja kita menggambar dengan menuliskan kode XML SVG saja dan langsung melihat hasilnya di Inkscape. Kekurangan dari Inkscape adalah pada Eksport-nya yang masih terbatas pada PNG saja (tetapi tidak terlalu menjadi masalah, karena hasilnya eksport-nya bisa kita eksport kembali dalam bentuk lainnya dengan menggunakan GIMP).

Untuk IDE (coding PHP dan HTML) di Linux, saya menggunakan Eclipse dengan ekstensi PHP-Eclipse. Eclipse merupakan IDE berbasis Java yang sangat populer dan sudah sangat matang serta masih terus dikembangkan hingga saat ini. Yang paling saya suka adalah fitur auto-completion-nya yang cukup lengkap (terutama kalau lagi lupa fungsi-fungsi PHP). Sebelum Eclipse saya pernah menggunakan Quanta Plus, tetapi karena Quanta didisain spesifik untuk desktop KDE (dimana banyak sekali library dependancies yang bikin saya malas), akhirnya saya menjatuhkan pilihan ke Eclipse yang fasilitasnya sudah sangat lengkap.

Jadi, Web Designer dan web programmer? Uninstall semua program web authoring bajakan anda dan migrasi penuh ke OSS!! I bet we can do it.

Kenapa coding OOP ?

2006-04-12T00:35:00.000-07:00

Saya mengenal Object Oriented Programming sekitar 1,5 tahun yang lalu, ketika saya mulai coba-coba coding OOP untuk salah satu project sistem informasi berbasis web di salah satu departemen pemerintahan (menggunakan PHP 4). Pada awalnya saya menggunakan OOP hanya untuk mencari cara bagaimana agar kode-kode yang saya buat bisa digunakan kembali dengan cepat tanpa harus cape-cape menulis prosedural yang rumit, ternyata semakin hari semakin terasa kenyamanan coding dengan style OOP.

Menurut pengalaman saya, beberapa kenyamanan yang saya dapat melalui coding OOP ini adalah :

Kode menjadi lebih bersih
Alur pemrograman menjadi lebih terstruktur
Reusability (penggunaan ulang) yang tinggi
Berkurangnya ketergantungan antar program karena setiap objek bekerja sendiri-sendiri, tetapi saling bekerja sama satu sama lain
Adanya inherintance antar kelas yang memungkinkan kita memperpanjang fungsi dan manfaat dari kelas yang sudah ada, tanpa harus menulis ulang kelas sebelumnya
Kelas memungkinkan kita mengelompokan/mengklasifikasikan properti dan metode-metode yang serupa fungsinya
Dalam lingkungan yang Open Source diperlukan kode-kode pemrograman yang juga readable oleh pemrograman lainnya. OOP bisa menjadi solusi untuk hal ini
Mempelajari OOP di PHP 5, membuat saya lebih mudah untuk mencoba OOP di Java karena modelnya hampir serupa

Tetapi OOP juga mempunyai kekurangan yaitu dalam hal eksekusi skrip. OOP seperti saya pernah baca pada buku Core PHP Programming, karangan Leon Atkinson, eksekusi skrip yang menggunakan OOP bisa berkurang kecepatannya hingga 20%, dibandingkan dengan menggunakan style prosedural biasa.

IHMO OOP merupakan sebuah pilihan bagi programmer. Mereka yang mementingkan kecepatan performa aplikasi akan cenderung memilih style prosedural, sedangkan mereka yang lebih mementingkan modularitas dan keterbacaan kode aplikasi akan cenderung memilih OOP. Saya sendiri tidak strict ke satu style, seperti yang pernah Rasmus Lerdorf (PHP Founding Father) katakan,

"Gunakan OOP di saat yang betul-betul diperlukan, dan gunakan prosedural di sisi yang lain".

Object Oriented Programming PHP 5 - Bagian 1

2006-04-11T04:01:00.000-07:00

PHP merupakan server-side scripting untuk membangun halaman web dinamis yang sangat populer saat ini dan powerful. Keunggulan PHP adalah pada kemudahan dalam penulisan program dan dukungan extension library yang sangat banyak terutama dalam hal koneksi database. Salah satu keunggulan PHP yang lain adalah penulisan kode dalam style Object Oriented Programming atau biasa juga disingkat OOP. Style OOP sudah didukung sejak PHP 3, tetapi mulai versi 5 style OOP PHP ditulis ulang kembali agar lebih mendekati kepada prinsip-prinsip OOP yang sebenarnya seperti munculnya modifier public, protected, private, abstract dsb. OOP pada PHP 5 mirip dengan OOP pada Java.

Apa sih Object Oriented Programming itu? OOP mudahnya adalah membangun sebuah aplikasi dengan menggunakan object (objek). Mari kita analogikan sebuah aplikasi sebagai sebuah Mobil. Mobil dibangun oleh komponen-komponen pendukungnya (objek) seperti ban, mesin, rangka mobil, setir dan komponen-komponen lainnya. Setiap komponen mempunyai fungsinya masing-masing dan saling mendukung satu sama lain, agar sebuah mobil dapat berjalan dengan baik. Hal seperti ini kemudian kita implementasikan dalam pembangunan aplikasi dimana kita membangun aplikasi dengan menggunakan objek-objek yang telah kita buat sebelumnya. Pengenalan lebih lanjut mengenai konsep OOP dapat dilihat di sini.

Untuk membuat sebuah objek maka kita harus mendeklarasikan terlebih dahulu Blue-Print atau prototype dari object tersebut. Prototype dari sebuah objek dalam terminologi pemrograman disebut class (kelas). Di bawah ini adalah contoh sebuah deklarasi kelas dengan sebuah variabel dan sebuah metode.

<?php
 
class kelasKucing
{
    var nama_kucing = '';
 
    // metode untuk memberikan nama pada kucing

    function setNamaKucing($isi_nama_kucing)
    {
         $this->nama_kucing = $isi_nama_kucing;
    }

 
    // metode untuk mengetahui nama kucing 
    function getNamaKucing()
    {
         return $this->nama_kucing;
    }

}
 
?>

Source code di atas mendeklarasikan sebuah kelas (Blue-Print) dengan nama kelasKucing. Kelas ini nantinya akan menghasilkan sebuah objek "kucing". Salah satu metode kelas ini adalah metodeSetNamaKucing yang fungsinya adalah memberikan nama untuk objek kucing nantinya. WARNING!! Jangan samakan kelas dengan objek, objek merupakan hasil cetakan dari sebuah kelas.

Untuk membuat sebuah objek dari dari kelasKucing, maka kita harus meng-instantiate kelasKucing atau mudahnya mencetak sebuah objek dari kelasKucing. Contohnya bisa dilihat pada contoh di bawah ini :

<?php
 
require 'kelasKucing.inc.php';
 
// buat objek kucing pertama
$blacky = new kelasKucing();
 // kasih nama buat kucing baru kita

 $blacky->setNamaKucing('blacky');
 // siapakah nama kucing yang baru kita buat
 echo "Nama kucing pertama kita adalah : ".$blacky->getNamaKucing;

 
// buat objek kucing kedua
$kitty = new kelasKucing();
 // kasih nama buat kucing baru kedua kita
 $kitty->setNamaKucing('kitty');
 // siapakah nama kucing yang baru kita buat

echo "Nama kucing kedua kita adalah : ".$kitty->getNamaKucing;
 
?>

Perbedaan paling mendasar pada OOP di PHP 5 dengan versi PHP sebelumnya adalah pada akses kepada properti dan metode dari kelas. Pada PHP 4, semua properti kelas bisa diakses secara public (dari manapun) dan semua metode kelas bisa diakses secara static tanpa harus membuat objek dari kelas terlebih dahulu. Pada PHP 5 sudah diperkenalkan modifier-modifier properti dan metode seperti halnya Java dan C++. Beberapa diantaranya yang penting adalah :

PUBLIC Ini artinya setiap properti atau metode bisa diakses secara langsung oleh program lain diluar kelas.
PROTECTED Ini artinya setiap properti atau metode hanya bisa diakses oleh kelas itu sendiri dan bisa diakses oleh kelas lain yang meng-inherit kelas tersebut.
PRIVATE Ini artinya setiap properti atau metode hanya bisa diakses oleh kelas itu sendiri.

Contoh implementasi modifier ini bisa dilihat pada source code di bawah ini :

<?php
 
class kelasKucing
{
 private nama_kucing = '';
 private tahun_lahir_kucing;
 protected usia_kucing;
 public gender_kucing = '';

 
 public function setNamaKucing($isi_nama_kucing)
 {
     $this->nama_kucing = $isi_nama_kucing;
 }

 
 public function setTahunLahirKucing($isi_tahun_lahir_kucing)
 {
     $this->tahun_lahir_kucing = $isi_tahun_lahir_kucing;
 }

 
 protected function hitungUsiaKucing()
 {
     if ($this->tahun_lahir_kucing AND ) {

         $this->usia_kucing = (integer)date("Y") - $this->tahun_lahir_kucing
     }

 }
 
 
}
 
// buat objek kucing
$arie = new kelasKucing();
// metode setNamaKucing dan setTahunLahir bisa dipanggil

// langsung oleh objek karena sifatnya public
 // kasih nama untuk si kucing
 $arie->setNamaKucing("arie");
 // tahun lahir si kucing
 $arie->setTahunLahir(1982);

 
// syntax di bawah ini benar
// karena properti gender_kucing bersifat public
$arie->gender_kucing = "laki-laki"
 
// syntax di bawah ini salah dan akan memunculkan error
// properti usia_kucing bersifat private

$arie->usia_kucing = 20;
// properti nama_kucing bersifat private
echo "Nama kucing kita adalah : ".$arie->nama_kucing;

 
?>

Bisa dilihat bahwa implementasi OOP pada PHP 5 sudah sangat advanced dan pada kenyataan sudah banyak extension library ataupun fungsi-fungsi di PHP 5 yang menggunakan model OOP untuk penggunaannya. Salah satunya adalah fungsi mysql improved (mysqli) yang menyediakan style komunikasi database mysql dalam bentuk OOP. Sampai sini dulu pengenalan pada OOP PHP 5, see you on next articles with same topics.