Url

File: packages/skilldo/cms/src/Support/Url.php
Namespace: SkillDo\Cms\Support\Url
Alias ngắn: \Url

Class Url cung cấp các helper tĩnh để tạo và xử lý URL trong SkillDo CMS v8.

Url::is	Url::admin	Url::account
Url::base	Url::permalink	Url::register
Url::current	Url::route	Url::login
Url::theme	Url::getYoutubeID	Url::logout
Url::slug	Url::isYoutube	Url::forgot
Url::fileManager	Url::language	Url::download
Url::path	Url::asset	Url::tag
Url::pathHash	Url::search

Url::is()

Hàm Url::is kiểm tra chuỗi có phải là một URL hợp lệ không.

Url::is('https://skilldo.vn')
// true

Url::is('T is men')
// false

Url::base()

Hàm Url::base trả về domain gốc của website. Nhận thêm một chuỗi path để nối vào sau domain.

Url::base()
// https://domain.com/

Url::base('skd-slug')
// https://domain.com/skd-slug

Url::current()

Hàm Url::current trả về URL đầy đủ của trang hiện tại (bao gồm query string).

Url::current()
// https://domain.com/san-pham?page=2

// Lấy URL dạng base64 (dùng để truyền redirect)
Url::current(true)
// aHR0cHM6Ly9kb21haW4uY29tL3Nhbi1waGFtP3BhZ2U9Mg==

Url::route()

Hàm Url::route trả về URL của một named route (gọi qua helper route() toàn cục).

Url::route('account.order')
// account/order

Url::admin()

Hàm Url::admin trả về URL khu vực admin của website.

Url::admin()
// https://domain.com/admin/

Url::admin('users')
// https://domain.com/admin/users

Url::theme()

Hàm Url::theme trả về URL trỏ vào thư mục của theme đang được kích hoạt.

Url::theme()
// https://domain.com/views/theme-name/

Url::theme('assets/images/logo.png')
// https://domain.com/views/theme-name/assets/images/logo.png

Url::permalink()

Hàm Url::permalink trả về URL sau khi áp dụng bộ lọc đa ngôn ngữ. Dùng trong các trường hợp trang hỗ trợ đa ngôn ngữ.

Url::permalink('san-pham-a')
// Ngôn ngữ mặc định: https://domain.com/san-pham-a
// Ngôn ngữ en:       https://domain.com/en/san-pham-a

Url::path()

Hàm Url::path trả về đường dẫn tính từ gốc site, KHÔNG kèm tên miền.

Dùng cho nội dung được cache ra file (CSS bundle): không nhúng tên miền nên file vẫn đúng khi đổi domain hoặc chuyển http ↔ https.

Url::path('uploads/source/a.jpg')
// /uploads/source/a.jpg

// Khi CMS cài trong thư mục con
// /thu-muc-con/uploads/source/a.jpg

Url::pathHash()

Hàm Url::pathHash trả về dấu vân tay 8 ký tự của base path, dùng nhúng vào tên file cache (CSS/JS bundle).

File bundle có chứa đường dẫn tính từ gốc site, nên bundle dựng ở https://sandbox.com/projectname không dùng lại được ở https://product.com. Vân tay này khiến bundle cũ tự bị bỏ qua thay vì dùng nhầm.

Url::pathHash()
// "3f2a9c1b"

Url::asset()

Hàm Url::asset trả về URL tuyệt đối cho tài nguyên (ảnh, css…). Nếu đầu vào đã là URL tuyệt đối, protocol-relative (//…) hoặc data URI thì giữ nguyên; ngược lại nối tên miền + base path.

Dùng cho CSS nền của element, vì CSS có thể được nạp từ file bundle nằm trong thư mục con khiến URL tương đối bị trình duyệt resolve sai.

Url::asset('uploads/source/bg.jpg')
// https://domain.com/uploads/source/bg.jpg

Url::asset('https://cdn.com/bg.jpg')
// https://cdn.com/bg.jpg  (giữ nguyên)

Url::asset('data:image/png;base64,...')
// giữ nguyên

Url::tag()

Hàm Url::tag trả về URL trang lưu trữ theo thẻ. Tiền tố đổi được qua config cms.tag.prefix (mặc định tag).

Url::tag('huong-dan')
// /tag/huong-dan
// Đa ngữ: /en/tag/huong-dan

Trả về đường dẫn tuyệt đối theo gốc site (có / ở đầu) và tự kèm tiền tố ngôn ngữ. Trước 8.1.4 hàm này trả về đường dẫn tương đối nên ở trang có URL nhiều đoạn trình duyệt resolve sai thành 404.

Url::search()

Hàm Url::search trả về URL trang kết quả tìm kiếm. Tiền tố đổi được qua config cms.search.prefix (mặc định search). Tham số rỗng sẽ bị bỏ khỏi query string.

Url::search()
// /search

Url::search('áo thun')
// /search?keyword=%C3%A1o+thun

Url::search('áo thun', 'product')
// /search?keyword=%C3%A1o+thun&type=product

Cùng quy ước với Url::tag(): đường dẫn tuyệt đối theo gốc site + tự kèm tiền tố ngôn ngữ, để form tìm kiếm đặt ở header luôn trỏ đúng dù đang đứng ở trang có URL sâu bao nhiêu đoạn.

Url::fileManager()

Hàm Url::fileManager trả về URL của trình quản lý file (Responsive File Manager) dùng trong admin. Nhận thêm chuỗi query params; tự động thêm callback=responsive_filemanager_callback nếu chưa có.

Url::fileManager()
// https://domain.com/vendor/rpsfmng/dialog.php?editor=mce_0

Url::fileManager('type=1&field_id=image')
// ...dialog.php?editor=mce_0&callback=responsive_filemanager_callback&type=1&field_id=image

Lưu ý: Để lấy segment URL hiện tại, dùng request()->segments() hoặc request()->segment($n) thay vì Url:: (class Url không có method segment).

Url::getYoutubeID()

Hàm Url::getYoutubeID trích xuất ID video từ URL YouTube.

Url::getYoutubeID('https://www.youtube.com/watch?v=Lq5GO4M1-Gk')
// Lq5GO4M1-Gk

Url::isYoutube()

Hàm Url::isYoutube kiểm tra URL có phải là URL video YouTube không.

Url::isYoutube('https://www.youtube.com/watch?v=abc123')
// true

Url::isYoutube('https://domain.com/video')
// false

Url::account()

Hàm Url::account trả về URL trang thông tin tài khoản (Frontend).

Url::account()
// https://domain.com/account

Lưu ý: Url::account() không nhận tham số path. Cần URL con (ví dụ account/order), dùng Url::base('account/order').

Url::register()

Hàm Url::register trả về URL trang đăng ký tài khoản (Frontend).

Url::register()
// https://domain.com/register

Url::login()

Hàm Url::login trả về URL trang đăng nhập tài khoản (Frontend).

Url::login()
// https://domain.com/login

Url::forgot()

Hàm Url::forgot trả về URL trang quên mật khẩu (Frontend).

Url::forgot()
// https://domain.com/forgot

Url::logout()

Hàm Url::logout trả về URL để đăng xuất tài khoản (Frontend).

Url::logout()
// https://domain.com/logout

Url::slug()

Hàm Url::slug trả về slug của trang hiện tại từ URL, tự động bỏ qua prefix ngôn ngữ nếu có.

// URL: https://domain.com/en/san-pham-a
Url::slug()
// san-pham-a

Url::language()

Hàm Url::language trả về URL của trang hiện tại nhưng chuyển sang ngôn ngữ khác.

// Đang ở: https://domain.com/san-pham-a
Url::language('en')
// https://domain.com/en/san-pham-a

Url::download()

Hàm Url::download tải một file từ URL về server (HTTP client, timeout 120 giây, ghi trực tiếp xuống file) và lưu vào đường dẫn chỉ định. Trả về true nếu thành công, false nếu response không thành công; ném lại Exception nếu có lỗi kết nối.

$success = Url::download(
    'https://example.com/file.zip',
    Path::storage('downloads/file.zip')
);