Cloudinary cung cấp API để tải hình ảnh, video và bất kỳ loại tệp nào khác lên Cloudinary. Các tệp được tải lên Cloudinary được lưu trữ an toàn trên đám mây với lịch sử sửa đổi và sao lưu an toàn tùy chọn. API của Cloudinary cho phép tải lên an toàn từ máy chủ của bạn, trực tiếp từ trình duyệt hoặc ứng dụng dành cho thiết bị di động của khách truy cập hoặc được tìm nạp qua các URL công khai từ xa
Thư viện PHP của Cloudinary bao bọc API tải lên của Cloudinary và đơn giản hóa việc tích hợp. Các phương thức PHP có sẵn để dễ dàng thực hiện tải hình ảnh và video PHP lên Cloudinary và các phương thức trợ giúp chế độ xem PHP có sẵn để tải trực tiếp từ trình duyệt lên Cloudinary
Trang này bao gồm các mẫu sử dụng phổ biến để tải lên hình ảnh và video PHP với Cloudinary
Để biết chi tiết về tất cả các tùy chọn và tham số tải lên có sẵn, hãy xem tài liệu Tải lên phương tiện và phương pháp Tham khảo API tải lên
Tiện ích Tải lên của Cloudinary cung cấp giải pháp thay thế cho việc sử dụng SDK Cloudinary để thêm chức năng tải lên vào ứng dụng của bạn, loại bỏ nhu cầu phát triển khả năng tải lên tương tác nội bộ. Tiện ích tải lên là một giao diện người dùng tương tác, giàu tính năng, dễ tích hợp cho phép bạn thêm hỗ trợ tải lên trên nền tảng đám mây vào trang web của mình. Có thể dễ dàng nhúng tiện ích vào ứng dụng web của bạn chỉ bằng một vài dòng mã JavaScript. Xem tài liệu về tiện ích tải lên để biết thông tin chi tiết
Bạn có thể tải hình ảnh, video hoặc bất kỳ tệp thô nào khác lên Cloudinary từ mã PHP của mình. Quá trình tải lên được thực hiện qua HTTPS bằng cách sử dụng một giao thức bảo mật dựa trên các thông số api_key và api_secret của môi trường sản phẩm của bạn
Sử dụng lớp UploadApi để tải nội dung lên Cloudinary
use Cloudinary\Api\Upload\UploadApi;
Phương thức sau của lớp UploadApi tải hình ảnh lên Cloudinary
public function upload[$file, $options = []]
Ví dụ: tải lên tệp hình ảnh cục bộ có tên 'my_image. jpg'
[new UploadApi[]]->upload['my_image.jpg']
Tệp cần tải lên có thể được chỉ định dưới dạng đường dẫn cục bộ, URL HTTP hoặc HTTPS từ xa, URL bộ chứa lưu trữ trong danh sách trắng [S3 hoặc Google Storage], URI dữ liệu base64 hoặc URL FTP. Để biết chi tiết, xem
Để biết chi tiết về tất cả các tùy chọn và tham số tải lên có sẵn, hãy xem tài liệu Tải lên phương tiện và phương pháp Tham khảo API tải lên
Bạn tải lên video giống hệt như hình ảnh. SDK cũng hỗ trợ tự động tải các tệp lớn lên Cloudinary theo khối nếu tệp cần tải lên lớn hơn tham số chunk_size đã xác định, theo mặc định là 20000000 Byte [= 20 MB]
Ví dụ sau tải
public function upload[$file, $options = []]0 lên Cloudinary với khối lượng 6 MB và lưu trữ nó trong cấu trúc thư mục hai cấp với ID công khai
public function upload[$file, $options = []]0. Nó cũng thực hiện hai thao tác thay đổi kích thước video thành hình vuông và hình chữ nhật nhỏ
[new UploadApi[]]->upload['dog.mp4', [
'resource_type' => 'video',
'public_id' => 'myfolder/mysubfolder/dog_closeup',
'chunk_size' => 6000000,
'eager' => [
['width' => 300, 'height' => 300, 'crop' => 'pad'],
['width' => 160, 'height' => 100, 'crop' => 'crop', 'gravity' => 'south']],
'eager_async' => true,
'eager_notification_url' => '//mysite.example.com/notify_endpoint']
]Theo mặc định, quá trình tải lên được thực hiện đồng bộ. Sau khi hoàn tất, hình ảnh hoặc video đã tải lên có sẵn ngay lập tức để chuyển đổi và phân phối. Lệnh gọi tải lên trả về một Hash có nội dung tương tự như sau
Phản hồi bao gồm các URL HTTP và HTTPS để truy cập nội dung phương tiện đã tải lên cũng như thông tin bổ sung về nội dung đã tải lên. ID công khai, loại tài nguyên, chiều rộng và chiều cao, định dạng tệp, kích thước tệp theo byte, chữ ký để xác minh phản hồi, v.v.
- Để biết thêm thông tin về tải nội dung phương tiện lên, hãy xem tài liệu Tải lên phương tiện
- Để biết chi tiết về tất cả các tham số tải lên có sẵn, hãy xem phương pháp Tham khảo API tải lên
Mẫu tải lên được đề cập ở trên cho phép mã PHP phía máy chủ của bạn tải nội dung phương tiện lên Cloudinary. Trong quy trình này, nếu bạn có một biểu mẫu web cho phép người dùng của bạn tải lên hình ảnh hoặc video, dữ liệu của tệp phương tiện trước tiên sẽ được gửi đến máy chủ của bạn và chỉ sau đó mới được tải lên Cloudinary
Một tùy chọn mạnh mẽ và hiệu quả hơn là cho phép người dùng của bạn tải hình ảnh và video trong mã phía máy khách của bạn trực tiếp từ trình duyệt lên Cloudinary thay vì đi qua máy chủ của bạn. Phương pháp này cho phép tải lên nhanh hơn và trải nghiệm người dùng tốt hơn. Nó cũng giảm tải từ máy chủ của bạn và giảm độ phức tạp của các ứng dụng PHP của bạn
Bạn có thể tải lên trực tiếp từ trình duyệt bằng lệnh gọi có dấu hoặc chưa dấu tới điểm cuối tải lên, như minh họa trong ví dụ
Đối với các bản tải lên đã ký từ mã phía máy khách của bạn, mã phải được tạo trong mã PHP phía máy chủ của bạn. Bạn có thể sử dụng phương pháp
public function upload[$file, $options = []]1 để