Hướng dẫn sử dụng Thư viện phương tiện trong PolyCMS

Last updated on Jul 10, 2026 4:17 AM

Tổng quan

Thư viện phương tiện (Media Library) của PolyCMS cung cấp giải pháp quản lý hình ảnh và tệp tin tập trung cho toàn bộ nội dung CMS của bạn. Mọi tệp tin tải lên được lưu trữ độc lập trong thư mục uploads/polycms/, đảm bảo tách biệt hoàn toàn với các tệp dữ liệu của Perfex CRM.

Các phương thức tải lên

Tải lên kéo và thả (Drag-and-Drop)

Bạn chỉ cần kéo tệp tin trực tiếp từ máy tính thả vào khung cửa sổ Thư viện phương tiện để bắt đầu tải lên. Hệ thống hỗ trợ tải lên đồng thời nhiều tệp cùng lúc.

Tải lên chọn tệp duyệt (Browse)

Nhấp chọn nút Upload để mở hộp thoại chọn tệp tiêu chuẩn của hệ điều hành. Lựa chọn một hoặc nhiều tệp tin cần tải lên.

Tải lên trực tiếp từ khung soạn thảo

Khi đang viết bài viết hoặc chỉnh sửa trang tĩnh, bạn có thể chọn chèn ảnh trực tiếp ngay trong khung soạn thảo TinyMCE. Hộp thoại Thư viện phương tiện sẽ xuất hiện để bạn chọn ảnh có sẵn hoặc tải lên tệp ảnh mới.

Cấu trúc thư mục lưu trữ

PolyCMS tổ chức sắp xếp các tệp tải lên theo cấu trúc thư mục tự động **Năm/Tháng/Ngày**:

uploads/polycms/
├── 2026/
│   ├── 05/
│   │   ├── 15/
│   │   │   ├── hero-banner.jpg
│   │   │   └── hero-banner-thumb.jpg
│   │   └── 16/
│   └── 06/

Cơ chế phân cấp này giúp ngăn ngừa việc trùng lặp tên tệp và giúp việc quản lý thư mục luôn khoa học ngay cả khi hệ thống chứa hàng ngàn tệp tin.

Các chế độ hiển thị

Bạn có thể chuyển đổi linh hoạt giữa hai chế độ hiển thị:

Chế độ hiển thị	Mô tả hoạt động
Grid View (Dạng lưới)	Hiển thị ảnh thu nhỏ (thumbnails) trực quan giúp dễ dàng duyệt tìm hình ảnh
List View (Dạng danh sách)	Bảng chi tiết hiển thị tên tệp, dung lượng, kích thước ảnh và ngày tải lên

Các tính năng nổi bật

Duyệt cây thư mục (Directory Tree Browser) — Điều hướng nhanh qua cấu trúc thư mục bằng sơ đồ cây ở thanh bên.
Lọc theo định dạng tệp — Dễ dàng lọc nhanh hiển thị các tệp Hình ảnh (Images), Tài liệu (Documents) hoặc Tất cả các tệp (All Files).
Xem trước Lightbox — Click vào ảnh để xem kích thước đầy đủ ngay trên màn hình mà không cần thoát khỏi thư viện.
Tự tạo ảnh thu nhỏ (Thumbnails) — Tự động sinh ra các ảnh thu nhỏ cho mọi hình ảnh tải lên để tối ưu tốc độ tải.
Thông tin chi tiết tệp tin — Hiển thị tên tệp, kích thước ảnh, dung lượng file, ngày tải lên và đường dẫn URL trực tiếp của tệp.

Cơ chế bảo mật tải lên 6 lớp (6-Layer Security)

PolyCMS áp dụng các quy chuẩn bảo mật máy chủ nghiêm ngặt đối với mọi tệp tin tải lên:

Kiểm duyệt định dạng tệp (File Extension Validation) — Chỉ chấp nhận các định dạng tệp nằm trong danh sách cho phép (jpg, png, gif, webp, svg, pdf...). Từ chối và chặn đứng các tệp thực thi nguy hiểm (.php, .exe, .sh...).
Xác thực MIME-Type — Quét nội dung thực tế của tệp tin để đảm bảo khớp đúng với định dạng khai báo, ngăn chặn hành vi đổi đuôi tệp tin độc hại.
Kiểm tra Magic Bytes — Đọc cấu trúc binary ở phần đầu tệp tin để xác thực định dạng file thực tế.
Quét mã độc nội dung (Content Scanning) — Phân tích tệp tin tải lên để phát hiện và loại bỏ các đoạn mã PHP ẩn, các thẻ script độc hại nhằm chống tấn công thực thi mã từ xa (RCE).
Chặn tệp tin đuôi kép (Double-Extension Blocking) — Từ chối thẳng các tệp tin có tên dạng image.php.jpg.
Tái xử lý ảnh qua thư viện GD (GD Image Reprocessing) — Tiến hành nén và xử lý lại hình ảnh thông qua thư viện PHP GD để loại bỏ triệt để các mã độc nhúng bên trong ảnh mà vẫn bảo toàn nguyên vẹn chất lượng hiển thị.

Xóa tệp tin an toàn

Khi bạn thực hiện xóa một tệp phương tiện, PolyCMS sẽ tự động quét kiểm tra xem tệp tin đó có đang được nhúng trong bài viết hay trang tĩnh nào không. Nếu tệp đang được sử dụng, hệ thống sẽ hiển thị cảnh báo để tránh việc xóa nhầm làm hỏng hiển thị ảnh ngoài trang chủ.

Thao tác cơ sở dữ liệu (v1.1.0)

Từ phiên bản v1.1.0, mọi tệp tin tải lên đều được lưu trữ quản lý trong bảng database blog_media. Mỗi dòng bản ghi lưu trữ:

Trường dữ liệu	Ý nghĩa lưu trữ
`filename`	Tên tệp tin gốc
`path`	Đường dẫn tương đối (ví dụ: `2026/05/17/image.jpg`)
`url`	Đường dẫn URL tuyệt đối phục vụ hiển thị
`alt_text`	Văn bản thay thế phục vụ tối ưu SEO (Alt text)
`title` / `caption`	Tiêu đề và chú thích của ảnh
`mime_type`	Định dạng MIME-type của tệp tin
`file_size`	Dung lượng tệp tin tính bằng bytes
`width` / `height`	Kích thước chiều rộng và chiều cao của ảnh
`author_id`	ID của nhân sự thực hiện tải tệp lên

Các bài viết và trang tĩnh liên kết với ảnh thông qua mã feature_image_id, trong khi vẫn lưu giữ đường dẫn feature_image để phục vụ hiển thị nhanh ngoài trang chủ. Khi ảnh bị xóa, toàn bộ liên kết này sẽ tự động được dọn dẹp sạch sẽ.

Tài liệu hướng dẫn liên quan

Quản lý bài viết — Có nhúng ảnh phương tiện vào khung soạn thảo bài viết.
Quản lý trang tĩnh — Nhúng ảnh vào trang tĩnh.
Tự phát triển Theme — Gọi hiển thị ảnh phương tiện trong tệp template của theme.
Tài liệu REST API — Hướng dẫn tải lên, liệt kê và xóa tệp phương tiện qua API.