การจัดการ URL และการใช้งาน URI Library ใน CodeIgniter 4

บทความใหม่ ปีนี้ โดย Ninenik Narkdee
uri codeigniter 4 url codeigniter

คำสั่ง การ กำหนด รูปแบบ ตัวอย่าง เทคนิค ลูกเล่น การประยุกต์ การใช้งาน เกี่ยวกับ uri codeigniter 4 url codeigniter



เนื้อหาตอนต่อไปนี้เราจะมาดูเกี่ยวกับการจัดการ URL และ
การใช้งาน URI Library สำหรับจัดการ URL ใน CI4  ซึ่งเกี่ยวกับ
URL เบื้องต้นเราได้อธิบายไปเล็กน้อยบ้างแล้วในหัวข้อบทความ
URI Routing สามารถทบทวนได้ที่
    ทำความรู้จักกับ URL และ URI Routing ใน CodeIgniter 4 http://niik.in/996 
 
 
 

การใช้งาน URL ใน CI4

    ใน CI4 เราสามารถจัดการ URL เบื้องต้น ไม่ว่าจะเป็นการกำหนดรูปแบบ URL หรือลิ้งค์ การทำ popup
หรือการระบุ path ของตำแหน่งไฟล์ต่างๆ เช่น css js หรือ image เหล่านี้ โดยสามารถเรียกใช้งาน URL Helper 
ซึ่งเป็นส่วนที่ถูกโหลดอัตโนมัติในทุก request อยู่แล้ว
    ใน URL Helper จะประกอบด้วยฟังก์ชั่นต่างๆ ให้เราเลือกใช้งาน สัมพันธ์กับการตั้งค่าในไฟล์ App.php ใน
app/Config โดยเฉพาะสองค่าหลักนี้คือ
 
    app/Congif/App.php
 
/*
|--------------------------------------------------------------------------
| Base Site URL
|--------------------------------------------------------------------------
*/
public $baseURL = 'https://www.mysslweb.com/';

/*
|--------------------------------------------------------------------------
| Index File
|--------------------------------------------------------------------------
*/
public $indexPage = 'index.php';
 
    ก่อนไปดูตัวอย่างการใช้งาน ให้เราเตรียม Controller สำหรับประกอบการทำความเข้าใจ ในที่นี้ใช้ไฟล์ Helloworld.php
เป็นรูปแบบอย่างง่ายดังนี้
 
    app/Controllers/Helloworld.php
 
<?php namespace App\Controllers; 
use CodeIgniter\Controller; // เรียกใช้งาน Controller class 
class Helloworld extends Controller 
{
    public function index() 
    {       

    }
}
 
 
 

การใช้งานฟังก์ชั่นใน URL Helper

    สำหรับ URL Helper ใน CI4 เราสามารถเรียกใช้งานฟังก์ชั่นได้เลย โดยไม่ต้องการทำการโหลด เพราะตัว CI
โหลดส่วนของ URL Helper ให้อัตโนมัติ
    เราสามารถใช้ฟังก์ชั่นต่างๆ ได้ดังนี้
 
    

    site_url()

    base_url()

    ฟังก์ชั่นทั้งสอง มีรูปแบบการทำงานเหมือนกัน อ้างอิงค่าจากตัวแปร $baseURL และ  $indexPage ที่กำหนดในไฟล์ 
app/Config/App.php รองรับ parameter แรกเป็น URI segment หรือ path ที่ต้องการ และ parameter ที่สองรองรับ
การกำหนด protocal เช่น http https ftp เหล่านี้เป็นต้น หากไม่กำหนดจะอิงจากค่าปัจจุบัน มาดูตัวอย่างผลลัพธ์ที่ได้
 
    app/Controllers/Helloworld.php
 
<?php namespace App\Controllers; 
use CodeIgniter\Controller; // เรียกใช้งาน Controller class
class Helloworld extends Controller 
{
    public function index() 
    {       
		echo site_url(); // https://www.mysslweb.com/index.php
		echo "<hr>";
		echo site_url('helloworld'); // https://www.mysslweb.com/index.php/helloworld
		echo "<hr>";
		echo base_url(); // https://www.mysslweb.com
		echo "<hr>";
		echo base_url('helloworld');// https://www.mysslweb.com/helloworld		
    }
}
 
    เมื่อเราเรียกใช้งานไปยัง url 'https://www.mysslweb.com/helloworld' ผลลัพธ๊ค่าก็จะแสดงตามค่า ที่ comment 
ดัานบน สังเกตว่า คำสั่ง site_url() จะมีส่วนของ indexPage มาด้วย ในขณะที่คำสั่ง base_url() จะไม่แสดง indexPage
คำสั่งข้างต้น หากไม่ระบุ URI segment ก็จะใช้ค่าจากที่กำหนดใน baseURL 
    และเนื่้องจากเราเรียกผ่าน https จะเห็นว่าค่า protocal ก็จะเป็น https ไปด้วย หากเราต้องการให้เป็น http ก็สามารถ
เปลี่ยนโดยเพิ่ม parameter  ตัวที่ 2 ตามต้องการ เช่น
 
echo base_url('helloworld','http');// http://www.mysslweb.com/helloworld
 
    การกำหนด segment นอกจากเราจะกำหนดเป็น string path ที่ต้องกรแล้ว เรายังสามารถกำหนดในรูปแบบ array ก็ได้
ตัวฟังก์ชั่นจะทำการจัดรูปแบบ URI segment ให้อัตโนมัติ สมมติเช่น เรามีไฟล์รูปอยู่ที่โฟลเดอร์ images/phone/iphon.png
เราสามารถกำหนดเป็น 
 
echo base_url('images/phone/iphon.png');
// https://www.mysslweb.com/images/phone/iphon.png
 
    หรือแบบ array ก็จะเป็น
 
$segment = ['images','phone','iphone.png'];
echo base_url($segment);	
// https://www.mysslweb.com/images/phone/iphon.png ได้ผลลัพธ์เหมือนกัน
 
    หลักๆ แล้วคำสั่งที่ถูกใช้งานบ่อยจะเป็น base_url() เช่นใช้ในการกำหนด path ของไฟล์ css js image เป็นต้น
ตัวอย่างการใช้งานในส่วนของ view
 
<!doctype html>
<html lang="th">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> 
    <title>Document</title> 
    <link rel="stylesheet" href="<?= base_url('bootstrap@4.5.0/dist/css/bootstrap.min.css') ?>" >
</head>
<body>
 
 
<script src="<?= base_url('jquery@3.3.1/dist/jquery.min.js') ?>"></script>
<script src="<?= base_url('bootstrap@4.5.0/dist/js/bootstrap.min.js') ?>"></script>
<script type="text/javascript">
$(function(){
     
});
</script>
</body>
</html>
 
    โดย path ของไฟล์ที่เรากำหนดก็จะมี URL แบบเต็มเป็นดังนี้
 
https://www.mysslweb.com/bootstrap@4.5.0/dist/css/bootstrap.min.css
https://www.mysslweb.com/jquery@3.3.1/dist/jquery.min.js
https://www.mysslweb.com/bootstrap@4.5.0/dist/js/bootstrap.min.js
 
 

    current_url()

    เป็นคำสั่งที่คืนค่าเป็น url ปัจจุบัน ที่กำลังใช้งานอยู่ สมมติเราเรียกใช้งานที url เป็นดังนี้
 
https://www.mysslweb.com/helloworld/index?a=1&b=2
 
    คำสั่ง current_url() จะคืนค่าเป็น URL และมี segment ต่างๆ ของหน้าที่กำลังเปิดอยู่ 
* ทบทวนคำว่า segment ก็คือ ส่วนที่อยู้ใน url และแบ่งหรือคั่นด้วย / เรียกว่า segment
    ดังนั้นจะได้ผลลัพธ์เป็นดังนี้
 
echo current_url(); // คืนค่าเป็น String
// https://www.mysslweb.com/helloworld/index
 
    จะไม่มีตัว query string มาด้วย
    กรณีเราต้องการให้คืนค่าเป็น URI instance เราสามารถกำหนด  parameter เป็น true ได้ดังนี้
 
$uri = current_url(true); // คืนค่าเป็น URI instance
 
    ค่า URI instance สามารถแปลงเป็น string ด้วยคำสั่ง echo แล้วก็จะแสดง url แบบเต็มและมี query string มาด้วย
 
echo current_url(true); // คืนค่าเป็น String
// https://www.mysslweb.com/helloworld/index?a=1&b=2
 
    หรือจะแปลงเป็น string ด้วยคำสั่ง (string) ก็ได้ผลลัพธ์เหมือนกัน
 
$uri = current_url(true);
echo (string)$uri; // https://www.mysslweb.com/helloworld/index?a=1&b=2
 
    การแสดง url ของหน้าปัจจุบัน เรายังสามารถแสดงได้จากการใช้งาน $request object ของ Controller ดังนี้ได้ด้วย
 
$uri = $this->request->uri; 
echo (string)$uri; // https://www.mysslweb.com/helloworld/index?a=1&b=2	
 
    คำสั่งที่ให้ผลลัพธ์ เหมือนกับ current_url() คือ base_url(uri_string());
 
echo current_url(); // https://www.mysslweb.com/helloworld/index
echo base_url(uri_string()); //  https://www.mysslweb.com/helloworld/index
 
 

    previous_url()

    เป็นคำสั่งที่คืนค่าเป็น url ของหน้าก่อนหน้า หรือ referer page ใช้งานเหมือนคำสั่ง current_url() สามารถกำหนด
parameter แรกเป็น true จะคืนค่าเป็น URI instance 
    ปกติเราน่าจะคุ้นกับค่า HTTP_REFERER ของตัวแปร $_SERVER แต่ใน CI จะใช้ค่าที่เก็บผ่านตัวแปร session เก็บค่า
URL หน้าเพจที่แสดงก่อนหน้า เพื่อให้มั่นใจว่าได้เป็นข้อมูลที่ถูกต้อง แต่ถ้าไม่มีการใช้งาน session ตัว CI ก็จะยังใช้เป็น
ค่าเดียวกับตัวแปร $_SERVER['HTTP_REFERER']
 
// สมมติเราอยู่หน้า https://www.mysslweb.com/helloworld/prev?a=1&b=2
// แล้วกดลิ้งค์มาหน้า https://www.mysslweb.com/helloworld/index
 echo previous_url(); // จะได้ค่าเป็น https://www.mysslweb.com/helloworld/prev?a=1&b=2
 
     ข้อแตกต่างระหว่าง current_url() กับ previous_url() คือ ค่าของ url ของคำสั่ง previous_url() จะหมายถึง
url เต็มที่แสดงใน address bar ซึ่งหากมี query string ด้วยก็จะแสดง แต่ในคำสั่ง current_url() จะแสดงเฉพาะ
ส่วนของ segment ซึ่งหากต้องการให้แสดงแบบเต็ม ก็ต้องกำหนด parameter แรกเป็น true ตามที่ได้อธิบายไปแล้ว
 
    เราสามารถกำหนด parameter ให้กับคำสั่ง previous_url() เป็น true หากต้องการ URI instance สำหรับจัดการค่า
ต่างๆ ของ URL เช่น อยากเอามาแยกค่า segment เป็นต้น เกี่ยวกับ URL instance เราจะอธิบายเพิ่มในหัวข้อด้านล่าง
เกี่ยวกับการใช้งาน URI Library
 
$pre_uri = previous_url(true);
$segments = $pre_uri->getSegments();		
print_r($segments);		
/*
Array
(
    [0] => helloworld
    [1] => prev
)	
*/
 
 

    uri_string()

    เป็นคำสั่งที่คืนค่า URL ในส่วนที่เป็นเฉพาะ segment ไม่รวมส่วนที่เป็น baseURL หรือก็คือส่วนที่เป็น relative path 
ของ baseURL ดูตัวอย่างประกอบ
 
// สมมติ url ปัจจุบันเป็น https://www.mysslweb.com/helloworld/index
echo uri_string(); // จะได้ค่าเป็น helloworld/index
 
 

    anchor()

    เป็นคำสั่งสำหรับสร้าง HTML ลิ้งค์ รองรับ parameter ตามรูปแบบดังนี้
 
anchor([$uri = ''[, $title = ''[, $attributes = ''[, $altConfig = NULL]]]])
 
    Parameters:	
        $uri (mixed) – กำหนด URL string หรือ array ค่า URI segments ก็ได้
        $title (string) – ข้อความแสดงในลิ้งค์
        $attributes (mixed) – กำหนด attritube เป็น array หรือ string ก็ได้
        $altConfig (\Config\App) – การปรับแต่งด้วยการตั้งค่าอื่น ถ้ามี
 
    หลักๆ ก็จะเป็นการสร้าง HTML ลิ้งค์ทั่วไป อาจจะกำหนดเป็น url เต็มของเว็บอื่นๆ หรือกำหนดเป็น relative path
ซึ่งจะเติมส่วนของ baseURL ให้ก็ได้ กรณีเป็นโดเมนเดียวกัน ดูตัวอย่างการกำหนด ผลลัพธ์ที่ได้
 
echo anchor('news/local/123', 'My News', 'title="News title"');	
// <a href="https://www.mysslweb.com/index.php/news/local/123" title="News title">My News</a>
echo anchor('news/local/123', 'My News', ['title' => 'The best news!']);
// <a href="https://www.mysslweb.com/index.php/news/local/123" 
// title="The&#x20;best&#x20;news&#x21;">My News</a>
echo anchor('', 'Click here');
// <a href="https://www.mysslweb.com/index.php">Click here</a>
echo anchor('https://www.ninenik.com', 'Click here');
// <a href="https://www.ninenik.com">Click here</a>
 
    ค่า attribute ที่ส่งเข้าปกำหนดค่าจะถูก escape ค่าอัตโนมัติเพื่อป้องกัน XSS attacks
    สำหรับกรณีใช้เป้นลิ้งค์ภายใน จะมีส่วนของไฟล์ index.php มาด้วย หากเราไม่การค่านี้ ในส่วนของการ
กำหนด url ให้เราใช้ฟังก์ชั่น base_url() ร่วมเข้าไปด้วย ยกตัวอย่างเช่น
 
echo anchor(base_url('news/local/123'), 'My News', 'title="News title"');	
echo anchor(base_url('news/local/123'), 'My News', ['title' => 'The best news!','target' =>'_blank']);
echo anchor(base_url(), 'Click here');
 
 

    anchor_popup()

    เป็นคำสั่งสำหรับสร้าง HTML ลิ้งค์ แบบ JavaScript ที่เปิดหน้าต่าง popup window รองรับ parameter ตามรูปแบบดังนี้
 
anchor_popup([$uri = ''[, $title = ''[, $attributes = FALSE[, $altConfig = NULL]]]])
 
    Parameters:	
        $uri (mixed) – กำหนด URL string หรือ array ค่า URI segments ก็ได้
        $title (string) – ข้อความแสดงในลิ้งค์
        $attributes (mixed) – กำหนด attritube เป็น array หรือ string ก็ได้
        $altConfig (\Config\App) – การปรับแต่งด้วยการตั้งค่าอื่น ถ้ามี
 
    การตั้งค่าหลักๆ จะอยู่ที่การกำหนด attribute ดูตัวอย่างประกอบ
 
$atts = [
    'width'       => 800,
    'height'      => 600,
    'scrollbars'  => 'yes',
    'status'      => 'yes',
    'resizable'   => 'yes',
    'screenx'     => 0,
    'screeny'     => 0,
    'window_name' => '_blank'
];
echo anchor_popup('news/local/123', 'Click Me!', $atts);
/*
<a href="https://www.mysslweb.com/index.php/news/local/123" 
onclick="window.open('https://www.mysslweb.com/index.php/news/local/123', '_blank', 
'width=800,height=600,scrollbars=yes,menubar=no,status=yes,resizable=yes,screenx=0,screeny=0'); 
return false;">Click Me!</a>
*/
 
    เช่นกันถ้าต้องการตัด index.php ก็ครอบด้วยคำสั่ง base_url() 
    หากต้องการลิ้งค์ไปยังหน้าต่าง iframe ที่ต้องการก็ให้กำหนดตรงชื่อ window_name เป็นชื่อของ iframe ที่จะแสดง
 
 

    mailto()

    เป็นคำสั่งสำหรับสร้าง HTML ลิ้งค์ สำหรับส่งอีเมล ปกติถ้าใช้ผ่านมือถือก็จะขึ้นแอปส่งเมลพร้อมข้อมูลเบื้องต้น ที่เราสามารถ
กำหนดข้อความเพิ่มเติมได้ รองรับ parameter ตามรูปแบบดังนี้
 
mailto($email[, $title = ''[, $attributes = '']])
 
    Parameters:	
        $email (string) – E-mail address
        $title (string) – ข้อความลิ้งค์
        $attributes (mixed) – กำหนด attritube เป็น array หรือ string ก็ได้
 
    ดูตัวอย่างประกอบ
 
echo mailto('me@my-site.com', 'Click Here to Contact Me');
// <a href="mailto:me@my-site.com">Click Here to Contact Me</a>
$attributes = ['title' => 'Mail me'];
echo mailto('me@my-site.com', 'Contact Me', $attributes);
// <a href="mailto:me@my-site.com" title="Mail&#x20;me">Contact Me</a>
 
    เราสามารถป้องกันอีเมล จาก bot โดยเปลี่ยนเป็นคำสั่ง safe_mailto() แทนได้ และมีรูปแบบการใช้งานเหมือนเดิม
เพียงแค่อีเมลจะอยู่ในรูปแบบป้องกัน
 
 

    auto_link()

    เป็นคำสั่งสำหรับสร้าง HTML ลิ้งค์ จากการค้นหา url ในข้อความ แล้วปรับให้เป็น ลิ้งค์ ให้อัตโนมัติ รองรับ parameter 
ตามรูปแบบดังนี้
 
auto_link($str[, $type = 'both'[, $popup = FALSE]])
 
    Parameters:	
        $str (string) – ข้อความหรือตัวแปรข้อความที่มีลิ้งค์ url
        $type (string) – ประเภทลิ้งค์ที่ต้องการแปลง (‘email’, ‘url’ or ‘both’)
        $popup (bool) – แสดงเป็นแบบหน้าต่างใหม่ หรือไม่ กำหนด้วย true / false
 
    ดูตัวอย่าง
 
$my_string_contents = '
admin@mysslweb.com
การใช้งาน Pagination หรือการแบ่งหน้าใน CodeIgniter 4 http://niik.in/1005 
https://www.ninenik.com/content.php?arti_id=1005 via @ninenik
';
echo auto_link($my_string_contents);
 
    หากเรากำหนดเฉพาะ ข้อความที่ต้องการ ประเภทของลิ้งค์ทั้งหมดจะถูกแปลงอัตโนมัติทั้งอีเมล และ ลิ้งค์ปกติ
    กรณีต้องการให้แสดงเป็นแบบหน้าต่างใหม่ ก็สามารถกำหนดดังนี้
 
echo auto_link($my_string_contents,'both',true);
 
     อย่างไรก็ตาม จะมีข้อจำกัดอยู่ที่ว่า ถ้าหากว่าในข้อความนั้นมีโครงสร้างลิ้งค์ html บางลิ้งค์อยู่ จะเกิดการสร้างลิ้งค์ที่ผิดพลาด
ขึ้นได้ ยกตัวอย่างรูปแบบข้อความที่มีลิ้งค์อยู่บางค่า
 
$my_string_contents = '
admin@mysslweb.com
การใช้งาน Pagination หรือการแบ่งหน้าใน CodeIgniter 4 
<a href="http://niik.in/1005">http://niik.in/1005</a> 
https://www.ninenik.com/content.php?arti_id=1005 via @ninenik
';
 
    วิธีแก้คือให้เราทำการใช้คำสั่ง strip_tags() เพื่อยกเลิก html แท็กทั้งหมดให้เหลือเฉพาะข้อความ ก็จะสามารถใช้คำสั่ง auto_link()
ได้ และไม่เกิดข้อผิดพลาด หรือกรณีมีบางแท็ก ไม่ต้องการตัดก็กำหนด แท็กที่อนุญาตได้ เช่น
 
$my_string_contents = '
<span>admin@mysslweb.com</span>
การใช้งาน Pagination หรือการแบ่งหน้าใน CodeIgniter 4 
<a href="http://niik.in/1005">http://niik.in/1005</a> 
https://www.ninenik.com/content.php?arti_id=1005 via <strong>@ninenik</strong>
';
echo auto_link(strip_tags($my_string_contents,'<span><strong>'),'both',true);

// แบบ strip ทั้งหมด echo auto_link(strip_tags($my_string_contents),'both',true);
 
 

    url_title()

    เป็นคำสั่งสำหรับสร้างรูปแบบ URL ในลักษณะ human-friendly หรือ seo-engine-friendly รองรับ parameter ตามรูปแบบดังนี้
 
url_title($str[, $separator = '-'[, $lowercase = FALSE]])
 
    Parameters:	
        $str (string) – ข้อความที่ต้องการ
        $separator (string) – ตัวอักขระแบ่ง ปกติใช้  ‘-‘ หรือ ‘_’
        $lowercase (bool) – ต้องการแปลงเป็นตัวพิมพ์เล็กหรือไม่ กำหนด true / false
 
    ถ้าคุ้นเคยการลิ้งค์บทความหรือบล็อก เราจะพบบ่อยว่าส่วนใหญ่แล้วจะเอาหัวข้อมากำหนดเป็น url ซึ่งหัวข้อก็มักจะมีช่องว่าง
ระหว่างคำ การจะทำให้เป็นรูปแบบ url ก็จำเป็นต้องจัดการโดยการเปลี่ยนช่องว่างเป็นค่าที่สามารถใช้งานใน url ได้ ซึ่งก็จะใช้เป็น
- (dash) หรือ _ (underscore) ที่พบบ่อยจะเเป็น - ขีดกลาง (dash)
    ดูตัวอย่างการใช้งาน
 
$title     = "What's wrong with CSS?";
$url_title = url_title($title, '_');
//  Whats_wrong_with_CSS

$title     = "What's wrong with CSS?";
$url_title = url_title($title, '-', TRUE);
// whats-wrong-with-css
 
    เวลากำหนดใช้งานกับ url เต็ม ก็จะใช้ร่วมกับฟังก์ชั่นอื่นๆ เข่น
 
$category = "learning";
$title     = "What's wrong with CSS?";
echo base_url([$category, url_title($title, '-', TRUE)]);
// https://www.mysslweb.com/learning/whats-wrong-with-css
 
    กรณีใช้กับข้อความภาษาไทย และไม่ต้องการให้เข้ารหัสข้อความ ก็จะใช้เป็นดังนี้
 
$category = "learning";
$title     = "ทดสอบ ข้อความ ภาษาไทย";
echo urldecode(base_url([$category, url_title($title, '-')]));
// https://www.mysslweb.com/learning/ทดสอบ-ขอความ-ภาษาไทย
 
    กรณีต้องการให้รองรับตัว accented characters (ตัวอักษรโรมันที่มีจุดมีขีด) ก็สามารถใช้เป็น mb_url_title() 
มีรูปแบบการใช้งานเหมือนกัน
 
 
 

การใช้งาน URI Library

    นอกจากเราจะสามารถใช้ฟังก์ชั่นจัดรูปแบบของ URL ได้แล้ว CI ยังรองรับรูปแบบการจัดการ URL แบบ Object ผ่าน 
URI Library เพื่อให้มั่นใจว่ารูปแบบของ URL ที่ใช้งานมีความถูกต้องมากยิ่งขึ้น อีกทั้งยังใช้เป็นตัวกำหนดเงื่อน หรือการ
ทำงานบางอย่างได้อีกด้วย
 
 

    การสร้าง URI Instance

    เราสามารถสร้าง URI Instance เพื่อใช้งาน URL แบบ Object ได้ 2 รูปแบบคือ
 
// แบบกำหนดโดยตรงผ่าน class name
$uri = new \CodeIgniter\HTTP\URI();

// แบบใช้งาน service ฟังก์ชั่น
$uri = service('uri');
 
     URI Instance ข้างต้น เราไม่ได้กำหนด URL ดังนั้น จะเป็นการอ้างอิงกับ URL ปัจจุบันที่ใช้งานอยู่ หากเราทำการ echo
จะเหมือนเป็นการแปลง URI Instance เป็น String ก็จะแสดงเป็น URL ของหน้าปัจจุบันแบบเต็มรูปแบบ รองรับทั้ง segment
และ query string
 
// สมมติเปิดหน้า https://www.mysslweb.com/helloworld/index?a=1&b=2
$uri = service('uri'); // URI Instance
echo $uri; // คืนค่าเป็น String https://www.mysslweb.com/helloworld/index?a=1&b=2
 
    แต่ถ้าเราต้องการระบุไปเลยว่า ต้องการจัดการกับ URL ไหนผ่าน URI Instance ก็สามารถระบุ URL เข้าไปด้วยได้ดังนี้
 
// แบบกำหนดโดยตรงผ่าน class name
$uri = new \CodeIgniter\HTTP\URI('http://www.example.com/some/path');

// แบบใช้งาน service ฟังก์ชั่น
$uri = service('uri', 'http://www.example.com/some/path');
 
 

    การจัดการ URL หน้าปัจจุบัน

    ปกติถ้าเราเรียกใช้งาน URI Instance โดยไม่ระบุ URL ก็จะหมายถึงกำลังจัดการกับ URL หน้าปัจจุบันที่เรียกใช้งานอยู่ ตามที่
อธิบายไปแล้วด้านบน 
    นอกจากนั้นเรายังสามารถเรียก URI instance ของหน้าปัจจุบันผ่าน request object ของ Controller ดังนี้ได้
 
$uri = $this->request->uri; // URI Instance หนัาปัจจุบัน
 
    หรือจะใช้ฟังก์ชั่นจากหัวข้อ URL Helper ตามที่อธิบายไปแล้วก็ได้
 
$uri = current_url(true);  // URI Instance หนัาปัจจุบัน
 
 

    การแสดง URI String

    เราสามารถแปลง URI Instance เป็น URL string หากต้องการแสดงค่าเลย โดยใช้คำสั่ง echo หรือหากต้องการ นำไปกำหนดใน
ตัวแปรอื่นๆ ก็สามารถใช้รูปแบบการแปลงเป็น string ได้ดังนี้
 
$uri = current_url(true); // URI Instance 
$page_url = (string)$uri;  // URI String https://www.mysslweb.com/helloworld/index?a=1&b=2
 
    ในกรณีที่เรารู้ค่า ส่วนต่างๆ ของ URL เราสามารถสร้าง URI String โดยใช้ URI Class ผ่าน static method ที่ชื่อ 
createURIString() ได้ดังนี้
 
<?php namespace App\Controllers; 
use CodeIgniter\Controller; // เรียกใช้งาน Controller class
use CodeIgniter\HTTP\URI; // ใช้งาน URI class 
class Helloworld extends Controller 
{
    public function index() 
    {	
	// รูปแบบการเรียกใช้งาน  static method createURIString() :
	// $uriString = URI::createURIString($scheme, $authority, $path, $query, $fragment);

	echo URI::createURIString('http', 'example.com', 'some/path', 'foo=bar', 'first-heading');
	// http://exmample.com/some/path?foo=bar#first-heading
    }
}
 
 

    การจัดการ URI Part

    เราสามารถกำหนดและแสดงส่วนต่างๆ ของ URI ผ่าน URI Instance โดยรูปแบบการกำหนด และการอ่านค่าก็จะใช้คำว่า set
และ get ตามด้วยส่วนของ URL ที่จะจัดการ 
    เรามาดูแต่ละส่วนของ URI ตามลำดับดังนี้
 
 

    Scheme

    ปกติจะเป็นค่า 'http' หรือ 'https' แต่ก็รองรับทุกๆ scheme ด้วย เช่น 'mailto' 'file' เป็นต้น 
    ดูตัวอย่างการใช้งาน
 
// $uri = new \CodeIgniter\HTTP\URI('http://www.example.com/some/path');
$uri = service('uri', 'http://www.example.com/some/path');

echo $uri->getScheme(); // 'http'
$uri->setScheme('https'); // เปลี่ยนเป็น 'https'
 
 

    Authority

    ในบางรูปแบบของ URL เช่่นการใช้งาน ftp จะมีส่วนของ Authority ที่ประกอบไปด้วยข้อมุลของผู้ใช้ UserInfo ,Host และ Port
เราสามารถแสดงข้อมูล Authority ด้วยคำสั่ง getAuthority() ดูตัวอย่าง
 
$uri = new \CodeIgniter\HTTP\URI('ftp://user:password@example.com:21/some/path');

echo $uri->getAuthority();  // user@example.com:21
 
    โดยค่าเริ่มต้น จะไม่แสดง password แต่ถ้าต้องการแสดงรหัสผ่าน เราสามารถกำหนดคำสั่ง showPassword() ตามรุปแบบดังนี้
 
echo $uri->getAuthority();  // user@example.com:21 // ไม่แสดง password
echo $uri->showPassword()->getAuthority();   // user:password@example.com:21 // แสดง password

// ปิดการแสดง password
$uri->showPassword(false);
 
    หากไม่ต้องการแสดงเลข Port ให้กำหนด true เป็น parameter แรกเข้าไปดังนี้
 
echo $uri->getAuthority(true);  // user@example.com
 
    อย่างไรก็ตาม หากเป็น port มาตรฐานอยู่แล้ว จะไม่แสดงตัวเลข port เช่น 80 21 443 เหล่านี้เป็นต้น
 
 

    Userinfo

    เป็นส่วนข้อมูลของผู้ใช้ URL จะเป็นรูปแบบเดียวกันกับที่อธิบายด้านบน หรือที่เรียกว่า FTP URI แต่กรณีนี้ จะไม่แสดงค่า
Host และ Port  จะแสดงเฉพาะค่า user และ password  โดยค่า password ต้องกำหนดด้วยคำสั่ง showPassword() ก่อนถึงจะ
แสดง ดูตัวอย่างประกอบ
 
$uri = new \CodeIgniter\HTTP\URI('ftp://user:password@example.com:21/some/path');
echo $uri->getUserInfo();   // user
echo $uri->showPassword()->getUserInfo();   // user:password
$uri->showPassword(false);
 
 

    Host

    ปกติแล้วเป็นชื่อ domain ของ URI สามารถกำหนดค่า หรือแสดงค่าด้วยคำสั่ง setHost() และ getHost() ตามลำดับ
 
$uri = new \CodeIgniter\HTTP\URI('http://www.example.com/some/path');

echo $uri->getHost();   // www.example.com
echo $uri->setHost('anotherexample.com')->getHost();    // anotherexample.com
 
 

    Path

    เป็นส่วนของ segment ทั้งหมด ของ URI สามารถกำหนดค่า หรือแสดงค่าด้วยคำสั่ง setPath() และ getPath() ตามลำดับ
 
$uri = new \CodeIgniter\HTTP\URI('http://www.example.com/some/path');

echo $uri->getPath();   // 'some/path'
echo $uri->setPath('another/path')->getPath();  // 'another/path'
 
 

    Query

    เป็นส่วนของข้อมูล query string ทั้งหมด ดูตัวอย่าง
 
//$uri = new \CodeIgniter\HTTP\URI('https://www.mysslweb.com/helloworld/index?a=1&b=2');
$uri = service('uri','https://www.mysslweb.com/helloworld/index?a=1&b=2');
echo $uri->getQuery(); // a=1&b=2
$uri->setQuery('foo=bar&bar=baz');
echo $uri->getQuery(); // foo=bar&bar=baz
 
    ค่าที่เป็น value จะไม่สามารถเป็น fregment ได้ หรือจะต้องไม่มี # หากมีค่าที่กำหนดด้วย # จะเกิด error ขึ้น
 
    เราสามารถกำหนดค่า โดยใช้รูปแบบ array ดังนี้ได้
 
$uri->setQueryArray(['foo' => 'bar', 'bar' => 'baz']); // foo=bar&bar=baz
 
    การกำหนดค่าด้วยคำสั่ง setQuery() และ setQueryArray() จะเป็นการเขียนทับค่าเดิม หรือ Override ค่าเก่า 
แต่ถ้าเราต้องการเพิ่มค่าใหม่เข้าไป ต่อจากค่าเดิม และคงค่าเดิมไว้ ให้ใช้คำสั่งเป็น addQuery() ดังนี้
 
$uri = service('uri','https://www.mysslweb.com/helloworld/index?a=1&b=2');
echo $uri->getQuery();// a=1&b=2
$uri->addQuery('foo', 'bar');
$uri->addQuery('bar', 'baz');
echo $uri->getQuery(); // a=1&b=2&foo=bar&bar=baz
 
    การกรองค่า Query Values
    เราสามารถกรองค่า หรือทำการ filter ค่า query value โดยใช้คำสั่งเหล่านี้ได้
 
$uri = new \CodeIgniter\HTTP\URI('http://www.example.com?foo=bar&bar=baz&baz=foz');

//  foo=bar
echo $uri->getQuery(['only' => ['foo']); // แสดงเฉพาะที่กำหนด

// foo=bar&baz=foz
echo $uri->getQuery(['except' => ['bar']]); // แสดงทุกอันยกเว้นที่กำหนด ไม่ต้องแสดง

// เหลือเฉพาะ 'baz' คืนค่าเป็น baz=foz
$uri->stripQuery('foo', 'bar'); // ตัดค่าที่กำหนด แสดงค่าที่เหลือ

// เหลือเฉพาะ 'foo' คืนค่าเป็น foo=bar
$uri->keepQuery('foo'); // แสดงเฉพาะค่าที่กำหนด
 
 

    Fragment

    เป็นส่วนที่อยู่หลังสุดของ URL แบ่งหรือคั่นด้วยเครื่องหมาย # หากตัว # อยู่ตำแหน่งใด ส่วนหลังจากนี้คือ fregment ทั้งหมด
    ดูตัวอย่างการกำหนด
 
$uri = new \CodeIgniter\HTTP\URI('http://www.example.com/some/path#first-heading');

echo $uri->getFragment();   // 'first-heading'
echo $uri->setFragment('second-heading')->getFragment();    // 'second-heading'
 
 
 

การจัดการ URI Segments

    segment คือส่วนของ path ที่แบ่งหรือคั่นด้วยเครื่องหมาย / เราสามารถอ่านค่าของแต่ละ segment โดยจัดการผ่าน URI Instance
ด้วยรูปแบบคำสั่งต่างๆ ตามตัวอย่างดังนี้
 
// URI = http://example.com/users/15/profile

if ($uri->getSegment(1) == 'users')
{
        echo $uri->getSegment(2); //  '15'
}
 
    ตัวอย่างข้างต้น จำลองการใช้งานการตรวจสอบค่า segment เป็นเงื่อนไข และ แสดงค่า segment ที่ต้องการถ้าเข้าเงื่อนไข
    URI ข้างต้นมีส่วนของ segment เป็น users/15/profile ลำดับของ segment จะเริ่มนับที่ 1 ดังนั้น จะได้แต่ละค่าขแง 
segment แต่ละตำแหน่ง เป็น
 
1 = users
2 = 15 
3 = profile
 
    สามารถหาจำนวน segment ทั้งหมดผ่านคำสั่ง
 
$total = $uri->getTotalSegments();
echo $total; // 3
 
    เราสามารถคืนค่า segment เป็น array ด้วยคำสั่ง
 
$segments = $uri->getSegments();

// $segments =
[
        0 => 'users',
        1 => '15',
        2 => 'profile'
]
 
 
    สำหรับเนื้อหาการจัดการ URI หรือ URL เพิ่มเติมก็มีเพียงเท่านี้ สามารถทำความเข้าไจ และนำไปปรับ
ประยุกต์ใช้งานต่อไปได้


   เพิ่มเติมเนื้อหา ครั้งที่ 1 วันที่ 26-08-2020


การตัด index.php ออกจากคำสั่งจัดการ URI

    ในการใช้งานคำสั่งจัดการ URI ทั้งที่เป็นฟังก์ชั่นจาก URI helper และจาก URI Library จะเห็นว่าบาง
คำสั่งจะติดส่วนของ index.php หรือ index file ที่กำหนดใน app/Congif/App.php ผ่าน property ชื่อ
$indexPage ทำให้บางคำสั่งติดส่วนของ index.php เช่นคำสั่ง site_url()  anchor() และคำสั่งอื่นๆ 
แน่นอนว่าเราสามารถแก้ปัญหาได้ด้วยใช้คำสั่ง base_url() ซ้อนเข้าไปอีกที อย่างรูปแบบคำสั่ง anchor() 
 
echo anchor(base_url(), 'Click here');
 
    ในกรณีเว็บแอปของเราใช้ mode_rewrite เพื่อตัดการแสดง index.php เราสามารถตัดปัญหานี้ได้ โดยการ
กำหนดค่า $indexPage ในไฟล์ app/Congif/App.php ให้เป็นค่าว่าง
 
    app/Congif/App.php
 
public $indexPage = '';
 
    เท่านี้เราก็สามารถใช้ฟังก์ชั่น site_url() และ base_url() ได้เหมือนกัน และบางฟังก์ชั่นก็จะไม่ติดส่วนของไฟล์
index.php และเราก็ไม่ต้องแก้ไขปัญหาโดยใช้ฟังก์ชั่น base_url() อีก ทำให้สะดวกในการใช้งานเพิ่มขึ้น
    ในที่นี้ให้เรากำหนด $indexPage เป็นค่าว่าง


กด Like หรือ Share เป็นกำลังใจ ให้มีบทความใหม่ๆ เรื่อยๆ น่ะครับ



อ่านต่อที่บทความ









เนื้อหาที่เกี่ยวข้อง






เนื้อหาพิเศษ เฉพาะสำหรับสมาชิก

กรุณาล็อกอิน เพื่ออ่านเนื้อหาบทความ

ยังไม่เป็นสมาชิก

สมาชิกล็อกอิน



( หรือ เข้าใช้งานผ่าน Social Login )




URL สำหรับอ้างอิง











เว็บไซต์ของเราให้บริการเนื้อหาบทความสำหรับนักพัฒนา โดยพึ่งพารายได้เล็กน้อยจากการแสดงโฆษณา โปรดสนับสนุนเว็บไซต์ของเราด้วยการปิดการใช้งานตัวปิดกั้นโฆษณา (Disable Ads Blocker) ขอบคุณครับ