คู่มือติดตั้ง WSO2-WSF บนลินุกซ์

1. 1
คู่มือการติดตั้ง WSO2 WSF/PHP สำาหรับลินุกซ์
WSO2 WSF/PHP เป็นโอเพนซอร์ส เว็บเซอร์วิสเฟรมเวิร์กซึ่งรองรับภาษาโปรแกรมหลายภาษา เช่น PHP,
Python, C# ซึ่งในที่นี้จะใช้เวอร์ชันสำาหรับ PHP ซึ่งมีขั้นตอนการติดตั้งบนลินุกซ์ดังนี้
1. เข้าไปดาวน์โหลดโปรแกรมที่ http://wso2.org/downloads/wsf/php เลือกแบบซอร์สโค้ด (ดังรูปที่ 1)
เนื่องจากในเว็บไม่มีเวอร์ชันที่เป็นไบนารีสำาหรับลินุกซ์
รูปที่ 1 ลิงก์สำาหรับดาวน์โหลดซอร์สโค้ด
2. เมื่อดาวน์โหลดเสร็จแล้วให้แตกไฟล์ไปยังไดเรกทอรีที่ต้องการ เช่น
/home/korkeat/Software/tools เป็นต้น ซึ่งจะได้ไดเรกทอรีชื่อ wso2-wsf-php-src-2.0.0 และอาจเปลี่ยนชื่อให้สั้นลง
เพื่อให้ง่ายแก่การจดจำา เช่น wso2
รูปที่ 2 ตำาแหน่งไดเรกทอรี
KORKEAT WANNAPAT

2. 2
3. เปิดโปรแกรม terminal จากนั้น cd เข้าไปยังไดเรกทอรีที่ได้แตกไฟล์ไว้
cd /home/korkeat/wso2
4. โปรแกรม WSO2 WSF/PHP ต้องการแพ็คเกจดังต่อไปนี้
- php5-dev
- php5-xsl
- libxml2
- libxml2-dev
การติดตั้งแพ็คเกจดังกล่าวมีคำาสั่งแตกต่างกันขึ้นอยู่กับลินุกซ์ดิสทริบิวชันที่ใช้ ซึ่งในที่นี้จะใช้Ubuntu
(bases-on Debian Linux) ซึ่งมีโปรแกรมสำาหรับจัดการแพ็คเกจชื่อ aptitude
การติดตั้งจำาเป็นต้องใช้สิทธิ root หรือเทียบเท่า จะได้คำาสั่งเป็น
sudo aptitude insatll php5-dev php5-xsl libxml2 libxml2-dev
5. หากยังไม่เคยคอมไพล์โปรแกรมใดๆ อาจจะต้องติดตั้งแพ็คเกจที่จำาเป็นในการคอมไพล์ด้วย เช่น
- gcc
- build-essential
6. ขั้นตอนการคอมไพล์ซอร์สโค้ดมีหลักการและ คำาสั่งหลักๆ ดังนี้
./configure
make
make install
• ตรวจสอบให้แน่ใจก่อนว่าอยู่ในไดเรกทอรีของโปรแกรมที่ต้องการคอมไพล์หรือไม่
• ใช้คำาสั่ง './configure' ซึ่งเป็นการตรวจสอบและตั้งค่าต่างๆ เช่น ตำาแหน่งที่จะติดตั้งโปรแกรม, การ
เลือกเวอร์ชันคอมไพล์เลอร์ที่จะใช้กรณีที่มีการติดตั้งไว้หลายเวอร์ชัน สามารถเรียกดูอ็อปชันเพิ่ม
เติมได้โดยใช้คำาสั่ง './configure --help' หากเกิด error ระหว่างการทำางานอาจเกิดจากติดตั้งไม่ครบ
ให้ติดตั้งตามที่โปรแกรมแจ้งเตือน
• คำาสั่ง 'make' เป็นคำาสั่งในการคอมไพล์
• เมื่อคอมไพล์เสร็จ สามารถติดตั้งโปรแกรมด้วยคำาสั่ง 'make install' ซึ่งการติดตั้งจะต้องใช้สิทธิ
root หรือเทียบเท่า จะได้คำาสั่งเป็น 'sudo make install'
7. เมื่อติดตั้งเสร็จ ต้องทำาการตั้งค่าเพื่อให้ PHP สามารถใช้งานร่วมกับ WSO2 WSF/PHP ได้โดยการปรับ
KORKEAT WANNAPAT

3. 3
แต่งไฟล์ php.ini ซึ่งในที่นี้ไฟล์ php.ini จะอยู่ที่ /etc/php5/apache2/php.ini การแก้ไขจะต้องใช้สิทธิ root หรือเทียบ
เท่าจะได้คำาสั่งดังต่อไปนี้
sudo nano /etc/php5/apache2/php.ini
8. ปรับแต่งค่าดังนี้
• เอาเครื่องหมาย ';' หน้าบรรทัด include_path ออก (ประมาณบรรทัด 486) จากนั้นเพิ่มตำาแหน่ง
สคริปต์ ซึ่งมีมีรูปแบบ include_path = "<your path>/scripts" ตัวอย่างเช่น
include_path = ".:/home/korkeat/Software/wso2/scripts"
• เอาเครื่องหมาย ';' หน้าบรรทัด extension_dir ออก (ประมาณบรรทัด 503) เพิ่มตำาแหน่งที่เก็บ
extension ของ PHP5 มีรูปแบบเป็น extension_dir = "/usr/lib/php5/20060613+lsf" ตำาแหน่งดัง
กล่าวขึ้นอยู่กับเวอร์ชันของ PHP ที่ติดตั้ง
• เพิ่มบรรทัดต่อไปนี้ลงในไฟล์
extension=wsf.so
wsf.home ="/home/korkeat/Software/wso2/wsf_c"
wsf.log_level = 3
wsf.log_path=/tmp
extension=xsl.so
ค่าของ wdf.home จะต้องอ้างอิงถึงตำาแหน่งที่ติดตั้งไว้ในเครื่อง
• หากรัน Apache อยู่ต้องรีสตาร์ท Apache ก่อนเพื่อโหลดค่าที่เพิ่งปรับแต่งใหม่ โดยใช้คำาสั่ง
sudo /etc/init.d/apache2 force-reload
หรือทำาการ stop แล้ว start ใหม่
sudo /etc/init.d/apache2 stop
sudo /etc/init.d/apache2 start
• เรียกดูคุณสมบัติ และข้อมูลของ PHP โดยเรียกไฟล์ phpinfo.php ผ่านเว็บเบราว์เซอร์ที่
http://localhost/phpinfo.php หากไม่มีไฟล์ดังกล่าวให้สร้างขึ้นใหม่โดยมีเนื้อหาไฟล์ดังนี้
<?php phpinfo(); ?>
• ในบางครั้งอาจจะต้องโหลดโมดูลบางตัวเข้ามาทำางานด้วย เช่น OpenSSL โดยปกติหากติดตั้ง
KORKEAT WANNAPAT

4. 4
Apache และ PHP5 ผ่านโปรแกรม aptitude จะมีไว้ให้แล้วแต่ยังไม่เปิดการใช้งานต้องเปิดใช้งาน
ก่อนโดยใช้คำาสั่งต่อไปนี้
sudo a2enmod ssl
หรือจะเข้าไปแก้ในไฟล์ php.ini โดยการเอาคอมเม้นท์ออกก็ได้
• หากติดตั้งสำาเร็จจะได้ดังรูปที่ 3, 4, 5, 6
รูปที่ 3 OpenSSL extention
รูปที่ 4 LibXML extension
รูปที่ 5 XSL extension
KORKEAT WANNAPAT

5. 5
รูปที่ 6 WSO2 WSF/PHP extension
• หากต้องการทดสอบว่า WSO2 WSF/PHP สามารถใช้งานได้หรือไม่ ให้ คัดลอกไดเรกทอรี
samples ซึ่งในที่นี้จะอยู่ที่ /home/korkeat/Software/tools/wso2/scripts ไปไว้ที่ /var/www ซึ่งเป็น
รูทไดเรกทอรีสำาหรับ Apache
KORKEAT WANNAPAT