Chào mừng bạn đến với trang tài liệu dành cho trình điều khiển MongoDB PHP chính thức. Bạn có thể thêm trình điều khiển vào ứng dụng của mình để hoạt động với MongoDB trong PHP. Trình điều khiển MongoDB PHP bao gồm hai thành phần sau
Các
tiện ích mở rộng , cung cấp API cấp thấp và chủ yếu dùng để tích hợp libmongoc và libbson với .Thư viện library cung cấp API cấp cao để làm việc với cơ sở dữ liệu MongoDB nhất quán với các trình điều khiển ngôn ngữ MongoDB khác.
Mặc dù có thể sử dụng tiện ích mở rộng một mình, nhưng MongoDB khuyên bạn nên sử dụng cả tiện ích mở rộng và thư viện cùng nhau. Tải xuống các thành phần bạn cần hoặc thiết lập một dự án có thể chạy được bằng cách làm theo hướng dẫn của chúng tôi
hướng dẫn
Kiến trúc mở rộng và nội bộ
Tài liệu
Thư viện
Sự mở rộng
Nhật ký thay đổi
Thư viện
Sự mở rộng
Mã nguồn
Thư viện
Sự mở rộng
Cài đặt
Trước tiên, hãy đảm bảo rằng bạn đã cài đặt phiên bản PHP gần đây trên hệ thống của mình. Xem sách hướng dẫn PHP chính thức để biết hướng dẫn tải xuống và cài đặt.
Cài đặt Tiện ích mở rộng PHP MongoDB trước khi cài đặt Thư viện PHP cho MongoDB. Bạn có thể cài đặt tiện ích mở rộng bằng cách sử dụng PECL trên dòng lệnh.
$ sudo pecl install mongodb
Cuối cùng, thêm dòng sau vào của bạn
tập tin php.iniextension=mongodb.so
Ghi chú
Trên một số hệ thống, có thể có nhiều tệp INI cho các SAPI riêng lẻ (e. g. CLI, FPM). Đảm bảo bật tiện ích mở rộng trong tất cả các SAPI mà bạn cần
Phương pháp cài đặt thư viện PHP ưa thích là với Composer bằng cách chạy đoạn mã sau từ gốc dự án của bạn.
$ composer require mongodb/mongodb
Bạn có thể tìm thấy hướng dẫn cài đặt bổ sung trong tài liệu thư viện .
Kết nối với MongoDB Atlas
Để kết nối với cụm MongoDB Atlas , hãy sử dụng chuỗi kết nối Atlas for your cluster:
<?php$client = new MongoDB\Client( 'mongodb+srv://<username>:<password>@<cluster-address>/test?retryWrites=true&w=majority');$db = $client->test;
Ghi chú
Để biết thông tin về cách kết nối với Atlas Serverless, hãy xem trang Giới hạn phiên bản Serverless để biết phiên bản trình điều khiển tối thiểu mà bạn cần.
Kết nối với máy chủ MongoDB trên máy cục bộ của bạn
Nếu bạn cần chạy máy chủ MongoDB trên máy cục bộ của mình cho mục đích phát triển thay vì sử dụng cụm Atlas, bạn cần hoàn thành các bước sau
Tải xuống phiên bản Cộng đồng hoặc Doanh nghiệp của Máy chủ MongoDB.
Cài đặt và định cấu hình Máy chủ MongoDB.
Khởi động máy chủ
Quan trọng
Luôn bảo mật máy chủ MongoDB của bạn khỏi các cuộc tấn công độc hại. Xem Danh sách kiểm tra bảo mật của chúng tôi để biết danh sách các đề xuất bảo mật.
Sau khi bạn khởi động thành công máy chủ MongoDB, hãy chỉ định chuỗi kết nối của bạn trong mã kết nối trình điều khiển
Nếu Máy chủ MongoDB của bạn đang chạy cục bộ, bạn có thể sử dụng chuỗi kết nối "mongodb://localhost:<port>" trong đó <port> là số cổng bạn đã định cấu hình máy chủ của mình để lắng nghe các kết nối đến
Nếu bạn cần chỉ định tên máy chủ hoặc địa chỉ IP khác, hãy xem mục nhập Hướng dẫn sử dụng máy chủ của chúng tôi trên Chuỗi kết nối.
Để kiểm tra xem bạn có thể kết nối với máy chủ của mình hay không, hãy thay thế chuỗi kết nối trong ví dụ mã Connect to MongoDB Atlas và chạy nó.
khả năng tương thích
Do các sự cố tiềm ẩn khi biểu thị số nguyên 64 bit trên nền tảng 32 bit, người dùng nên sử dụng môi trường 64 bit. Khi sử dụng nền tảng 32 bit, hãy lưu ý rằng bất kỳ số nguyên 64 bit nào được đọc từ cơ sở dữ liệu sẽ được trả về dưới dạng phiên bản MongoDB\BSON\Int64 .
Khả năng tương thích MongoDB
Bảng tương thích sau chỉ định (các) phiên bản được đề xuất của trình điều khiển PHP để sử dụng với một phiên bản cụ thể của MongoDB
Cột đầu tiên liệt kê (các) phiên bản trình điều khiển
Bảng tương thích
Biểu tượng
Giải trình
✓
Tất cả các tính năng được hỗ trợ
⊛
Phiên bản Trình điều khiển sẽ hoạt động với phiên bản MongoDB, nhưng không phải tất cả các tính năng mới của MongoDB đều được hỗ trợ
không đánh dấu
Phiên bản Trình điều khiển không được thử nghiệm với phiên bản MongoDB
Phiên bản trình điều khiển PHP
MongoDB 6. 0
MongoDB 5. 0
MongoDB 4. 4
MongoDB 4. 2
MongoDB 4. 0
MongoDB 3. 6
MongoDB 3. 4
MongoDB 3. 2
MongoDB 3. 0
MongoDB 2. 6
máy lẻ + thư viện 1. 15 [1]
✓
✓
✓
✓
✓
✓
máy lẻ 1. 14 + thư viện 1. 13
✓
✓
✓
✓
✓
✓
máy lẻ 1. 13 + thư viện 1. 12
⊛
✓
✓
✓
✓
✓
máy lẻ 1. 12 + thư viện 1. 11
⊛
✓
✓
✓
✓
✓
✓
✓
✓
máy lẻ 1. 11 + thư viện 1. 10
⊛
✓
✓
✓
✓
✓
✓
✓
✓
máy lẻ 1. 10 + thư viện 1. 9
⊛
✓ [2]
✓
✓
✓
✓
✓
✓
✓
máy lẻ 1. 9 + thư viện 1. 8
⊛
⊛
✓
✓
✓
✓
✓
✓
✓
máy lẻ 1. 8 + thư viện 1. 7
⊛
⊛
✓
✓
✓
✓
✓
✓
✓
máy lẻ 1. 7 + thư viện 1. 6
⊛
⊛
⊛
✓
✓
✓
✓
✓
✓
máy lẻ 1. 6 + thư viện 1. 5
⊛
⊛
⊛
✓
✓
✓
✓
✓
✓
máy lẻ 1. 5 + thư viện 1. 4
⊛
⊛
⊛
⊛
✓
✓
✓
✓
✓
máy lẻ 1. 4 + thư viện 1. 3
✓
✓
✓
✓
✓
máy lẻ 1. 3 + thư viện 1. 2
✓
✓
✓
✓
máy lẻ 1. 2 + thư viện 1. 1
✓
✓
✓
✓
máy lẻ 1. 1 + thư viện 1. 0
✓
✓
✓
máy lẻ 1. 0
✓
✓
[1](1, 2) Phiên bản 1. 14 của thư viện PHP MongoDB đã bị bỏ qua để khôi phục tính chẵn lẻ của phiên bản giữa thư viện và tiện ích mở rộng. [2]Phần mở rộng 1. 10 + thư viện 1. 9 trình điều khiển không hỗ trợ đọc ảnh chụp nhanh trên phụ. Để biết thêm thông tin, hãy xem Máy chủ MongoDB phiên bản 5. 0 ghi chú phát hành.Khả năng tương thích ngôn ngữ
Bảng tương thích sau chỉ định (các) phiên bản được đề xuất của trình điều khiển PHP để sử dụng với một phiên bản PHP cụ thể
Cột đầu tiên liệt kê (các) phiên bản trình điều khiển
Phiên bản trình điều khiển PHP
PHP8. 2
PHP8. 1
PHP8. 0
PHP7. 4
PHP7. 3
PHP7. 2
PHP7. 1
PHP7. 0
PHP5. 6
PHP5. 5
máy lẻ + thư viện 1. 15 [1]
✓
✓
✓
✓
✓
✓
máy lẻ 1. 14 + thư viện 1. 13
✓
✓
✓
✓
✓
máy lẻ 1. 13 + thư viện 1. 12
✓
✓
✓
✓
✓
máy lẻ 1. 12 + thư viện 1. 11
✓
✓
✓
✓
✓
máy lẻ 1. 11 + thư viện 1. 10
✓
✓
✓
✓
✓
máy lẻ 1. 10 + thư viện 1. 9
✓
✓
✓
✓
✓
máy lẻ 1. 9 + thư viện 1. 8
✓
✓
✓
✓
✓
✓
máy lẻ 1. 8 + thư viện 1. 7
✓
✓
✓
✓
✓
máy lẻ 1. 7 + thư viện 1. 6
✓
✓
✓
✓
✓
✓
máy lẻ 1. 6 + thư viện 1. 5
✓
✓
✓
✓
✓
✓
máy lẻ 1. 5 + thư viện 1. 4
✓
✓
✓
✓
✓
✓
máy lẻ 1. 4 + thư viện 1. 3
✓
✓
✓
✓
✓
máy lẻ 1. 3 + thư viện 1. 2
✓
✓
✓
✓
✓
Để biết thêm thông tin về cách đọc bảng tương thích, hãy xem hướng dẫn của chúng tôi về Bảng tương thích MongoDB