Thuộc tính động php 8.2
Laravel bao gồm Eloquent, một trình ánh xạ quan hệ đối tượng (ORM) giúp tương tác với cơ sở dữ liệu của bạn trở nên thú vị. Khi sử dụng Eloquent, mỗi bảng cơ sở dữ liệu có một "Mô hình" tương ứng được sử dụng để tương tác với bảng đó. Ngoài việc truy xuất các bản ghi từ bảng cơ sở dữ liệu, các mô hình Eloquent còn cho phép bạn chèn, cập nhật và xóa các bản ghi khỏi bảng. Show
Trại khởi động LaravelNếu bạn chưa quen với Laravel, hãy thoải mái tham gia Laravel Bootcamp. Laravel Bootcamp sẽ hướng dẫn bạn cách xây dựng ứng dụng Laravel đầu tiên của bạn bằng Eloquent. Đó là một cách tuyệt vời để tham quan mọi thứ mà Laravel và Eloquent cung cấp Tạo các lớp mô hìnhĐể bắt đầu, hãy tạo một mô hình Eloquent. Model thường nằm trong thư mục 02 và mở rộng lớp 03. Bạn có thể sử dụng lệnh Artisan 04 để tạo một mô hình mới
Nếu bạn muốn tạo di chuyển cơ sở dữ liệu khi tạo mô hình, bạn có thể sử dụng tùy chọn 05 hoặc 06
Bạn có thể tạo nhiều loại lớp khác nhau khi tạo mô hình, chẳng hạn như nhà máy, trình gieo hạt, chính sách, bộ điều khiển và yêu cầu biểu mẫu. Ngoài ra, các tùy chọn này có thể được kết hợp để tạo nhiều lớp cùng một lúc ________số 8kiểm tra mô hìnhĐôi khi có thể khó xác định tất cả các thuộc tính và mối quan hệ có sẵn của một mô hình chỉ bằng cách lướt qua mã của nó. Thay vào đó, hãy thử lệnh 07 Artisan, lệnh này cung cấp tổng quan thuận tiện về tất cả các thuộc tính và quan hệ của mô hình 0Công ước mô hình hùng hồnCác mô hình được tạo bởi lệnh 04 sẽ được đặt trong thư mục 09. Hãy kiểm tra một lớp mô hình cơ bản và thảo luận về một số quy ước chính của Eloquent 3tên bảngSau khi xem qua ví dụ trên, bạn có thể nhận thấy rằng chúng tôi đã không cho Eloquent biết bảng cơ sở dữ liệu nào tương ứng với mô hình 10 của chúng tôi. Theo quy ước, "trường hợp rắn", tên số nhiều của lớp sẽ được sử dụng làm tên bảng trừ khi một tên khác được chỉ định rõ ràng. Vì vậy, trong trường hợp này, Eloquent sẽ giả sử mô hình 10 lưu trữ các bản ghi trong bảng 12, trong khi mô hình 13 sẽ lưu trữ các bản ghi trong bảng 14Nếu bảng cơ sở dữ liệu tương ứng của mô hình của bạn không phù hợp với quy ước này, bạn có thể chỉ định tên bảng của mô hình theo cách thủ công bằng cách xác định thuộc tính 15 trên mô hình 0Khóa chínhEloquent cũng sẽ giả định rằng bảng cơ sở dữ liệu tương ứng của mỗi mô hình có một cột khóa chính có tên là 16. Nếu cần, bạn có thể xác định thuộc tính 17 được bảo vệ trên mô hình của mình để chỉ định một cột khác đóng vai trò là khóa chính của mô hình 3Ngoài ra, Eloquent giả định rằng khóa chính là một giá trị số nguyên tăng dần, điều đó có nghĩa là Eloquent sẽ tự động chuyển khóa chính thành một số nguyên. Nếu bạn muốn sử dụng khóa chính không tăng dần hoặc không phải là số, bạn phải xác định thuộc tính 18 công khai trên mô hình của mình được đặt thành 19 6Nếu khóa chính của mô hình của bạn không phải là số nguyên, thì bạn nên xác định thuộc tính được bảo vệ 20 trên mô hình của mình. Thuộc tính này phải có giá trị là 21 9Khóa chính "tổng hợp"Eloquent yêu cầu mỗi mô hình phải có ít nhất một "ID" nhận dạng duy nhất có thể đóng vai trò là khóa chính của nó. Các khóa chính "tổng hợp" không được hỗ trợ bởi các mô hình Eloquent. Tuy nhiên, bạn có thể tự do thêm các chỉ mục duy nhất, nhiều cột bổ sung vào các bảng cơ sở dữ liệu của mình ngoài khóa chính xác định duy nhất của bảng Khóa UUID & ULIDThay vì sử dụng số nguyên tăng tự động làm khóa chính của mô hình Eloquent, bạn có thể chọn sử dụng UUID thay thế. UUID là số nhận dạng chữ và số duy nhất trên toàn cầu dài 36 ký tự Nếu bạn muốn một mô hình sử dụng khóa UUID thay vì khóa số nguyên tăng tự động, bạn có thể sử dụng đặc điểm 22 trên mô hình. Tất nhiên, bạn nên đảm bảo rằng mô hình có một 1Theo mặc định, Đặc điểm 23 sẽ tạo cho các mô hình của bạn. Các UUID này hiệu quả hơn cho việc lưu trữ cơ sở dữ liệu được lập chỉ mục vì chúng có thể được sắp xếp theo từ điểnBạn có thể ghi đè quá trình tạo UUID cho một mô hình nhất định bằng cách xác định phương thức 24 trên mô hình. Ngoài ra, bạn có thể chỉ định cột nào sẽ nhận UUID bằng cách xác định phương thức 25 trên mô hình 0Nếu muốn, bạn có thể chọn sử dụng "ULID" thay vì UUID. ULID tương tự như UUID; . Giống như các UUID được sắp xếp, các ULID có thể sắp xếp theo thứ tự từ điển để lập chỉ mục cơ sở dữ liệu hiệu quả. Để sử dụng ULID, bạn nên sử dụng đặc điểm 26 trên mô hình của mình. Bạn cũng nên đảm bảo rằng mô hình có một 1Dấu thời gianTheo mặc định, Eloquent mong đợi các cột 27 và 28 tồn tại trên bảng cơ sở dữ liệu tương ứng của mô hình của bạn. Eloquent sẽ tự động đặt giá trị của các cột này khi các mô hình được tạo hoặc cập nhật. Nếu bạn không muốn Eloquent tự động quản lý các cột này, bạn nên xác định thuộc tính 29 trên mô hình của mình với giá trị là 19 2Nếu bạn cần tùy chỉnh định dạng dấu thời gian của mô hình, hãy đặt thuộc tính 31 trên mô hình của bạn. Thuộc tính này xác định cách các thuộc tính ngày được lưu trữ trong cơ sở dữ liệu cũng như định dạng của chúng khi mô hình được tuần tự hóa thành một mảng hoặc JSON 3Nếu bạn cần tùy chỉnh tên của các cột được sử dụng để lưu dấu thời gian, bạn có thể xác định các hằng số 32 và 33 trên mô hình của mình 4Nếu bạn muốn thực hiện các thao tác mô hình mà không cần sửa đổi dấu thời gian của mô hình, bạn có thể thao tác trên mô hình trong phạm vi bao đóng được cung cấp cho phương thức 35 5kết nối cơ sở dữ liệuTheo mặc định, tất cả các mô hình Eloquent sẽ sử dụng kết nối cơ sở dữ liệu mặc định được định cấu hình cho ứng dụng của bạn. Nếu bạn muốn chỉ định một kết nối khác sẽ được sử dụng khi tương tác với một mô hình cụ thể, bạn nên xác định thuộc tính 36 trên mô hình 6Giá trị thuộc tính mặc địnhTheo mặc định, một phiên bản mô hình mới được khởi tạo sẽ không chứa bất kỳ giá trị thuộc tính nào. Nếu bạn muốn xác định giá trị mặc định cho một số thuộc tính của mô hình, bạn có thể xác định thuộc tính 37 trên mô hình của mình 7Cấu hình Eloquent StrictnessLaravel cung cấp một số phương thức cho phép bạn định cấu hình hành vi và "sự nghiêm ngặt" của Eloquent trong nhiều tình huống khác nhau Đầu tiên, phương thức 38 chấp nhận một đối số boolean tùy chọn cho biết liệu có nên ngăn tải lười biếng hay không. Ví dụ: bạn có thể chỉ muốn tắt tính năng tải chậm trong môi trường phi sản xuất để môi trường sản xuất của bạn sẽ tiếp tục hoạt động bình thường ngay cả khi mối quan hệ tải chậm vô tình xuất hiện trong mã sản xuất. Thông thường, phương thức này nên được gọi trong phương thức 39 của ứng dụng của bạn 40 8Ngoài ra, bạn có thể hướng dẫn Laravel ném một ngoại lệ khi cố điền một thuộc tính không thể điền bằng cách gọi phương thức 41. Điều này có thể giúp ngăn ngừa các lỗi không mong muốn trong quá trình phát triển cục bộ khi cố gắng đặt một thuộc tính chưa được thêm vào mảng 42 của mô hình 9Cuối cùng, bạn có thể hướng dẫn Eloquent ném một ngoại lệ nếu bạn cố gắng truy cập một thuộc tính trên một mô hình khi thuộc tính đó không thực sự được lấy từ cơ sở dữ liệu hoặc khi thuộc tính không tồn tại. Ví dụ: điều này có thể xảy ra khi bạn quên thêm thuộc tính vào mệnh đề 43 của truy vấn Eloquent 0Kích hoạt "Chế độ nghiêm ngặt" của EloquentĐể thuận tiện, bạn có thể kích hoạt cả ba phương thức được thảo luận ở trên bằng cách gọi phương thức 44 1Truy xuất mô hìnhKhi bạn đã tạo một mô hình và , bạn đã sẵn sàng bắt đầu truy xuất dữ liệu từ cơ sở dữ liệu của mình. Bạn có thể coi mỗi mô hình Eloquent là một trình tạo truy vấn mạnh mẽ cho phép bạn truy vấn trôi chảy bảng cơ sở dữ liệu được liên kết với mô hình. Phương thức 45 của mô hình sẽ lấy tất cả các bản ghi từ bảng cơ sở dữ liệu được liên kết của mô hình 2truy vấn tòa nhàPhương thức Eloquent 45 sẽ trả về tất cả các kết quả trong bảng của mô hình. Tuy nhiên, vì mỗi mô hình Eloquent đóng vai trò là trình tạo truy vấn, bạn có thể thêm các ràng buộc bổ sung cho truy vấn và sau đó gọi phương thức 47 để truy xuất kết quả 3
Làm mới người mẫuNếu bạn đã có một phiên bản của mô hình Eloquent được lấy từ cơ sở dữ liệu, bạn có thể "làm mới" mô hình bằng các phương thức 48 và 49. Phương thức 48 sẽ lấy lại mô hình từ cơ sở dữ liệu. Phiên bản mô hình hiện tại sẽ không bị ảnh hưởng 4Phương pháp 49 sẽ hydrat hóa lại mô hình hiện có bằng cách sử dụng dữ liệu mới từ cơ sở dữ liệu. Ngoài ra, tất cả các mối quan hệ đã tải của nó cũng sẽ được làm mới 5bộ sưu tậpNhư chúng ta đã thấy, các phương thức Eloquent như 45 và 47 lấy nhiều bản ghi từ cơ sở dữ liệu. Tuy nhiên, các phương thức này không trả về một mảng PHP đơn giản. Thay vào đó, một thể hiện của 54 được trả vềLớp Eloquent 55 mở rộng lớp cơ sở 56 của Laravel, cung cấp khả năng tương tác với các bộ sưu tập dữ liệu. Ví dụ: phương pháp 57 có thể được sử dụng để xóa các mô hình khỏi bộ sưu tập dựa trên kết quả của một lần đóng được gọi 6Ngoài các phương thức được cung cấp bởi lớp bộ sưu tập cơ sở của Laravel, lớp bộ sưu tập Eloquent cung cấp các phương thức dành riêng cho việc tương tác với các bộ sưu tập của các mô hình Eloquent Vì tất cả các bộ sưu tập của Laravel đều triển khai các giao diện có thể lặp lại của PHP, nên bạn có thể lặp qua các bộ sưu tập như thể chúng là một mảng 7Kết quả ChunkingỨng dụng của bạn có thể hết bộ nhớ nếu bạn cố tải hàng chục nghìn bản ghi Eloquent thông qua phương pháp 45 hoặc 47. Thay vì sử dụng các phương pháp này, phương pháp 60 có thể được sử dụng để xử lý số lượng lớn các mô hình hiệu quả hơnPhương thức 60 sẽ truy xuất một tập hợp con của các mô hình Eloquent, chuyển chúng tới một bao đóng để xử lý. Vì mỗi lần chỉ truy xuất một đoạn mô hình Eloquent hiện tại, nên phương thức 60 sẽ giúp giảm đáng kể mức sử dụng bộ nhớ khi làm việc với một số lượng lớn mô hình 8Đối số đầu tiên được truyền cho phương thức 60 là số bản ghi bạn muốn nhận trên mỗi "khối". Việc đóng được thông qua khi đối số thứ hai sẽ được gọi cho mỗi đoạn được truy xuất từ cơ sở dữ liệu. Một truy vấn cơ sở dữ liệu sẽ được thực hiện để truy xuất từng đoạn bản ghi được chuyển đến phần đóngNếu bạn đang lọc kết quả của phương pháp 60 dựa trên một cột mà bạn cũng sẽ cập nhật trong khi lặp lại kết quả, bạn nên sử dụng phương pháp 65. Sử dụng phương pháp 60 trong các tình huống này có thể dẫn đến kết quả không mong muốn và không nhất quán. Bên trong, phương thức 65 sẽ luôn truy xuất các mô hình có cột 16 lớn hơn mô hình cuối cùng trong đoạn trước 9Chunking Sử dụng Lazy CollectionsPhương thức 69 hoạt động tương tự theo nghĩa là, đằng sau hậu trường, nó thực thi truy vấn theo khối. Tuy nhiên, thay vì chuyển từng đoạn trực tiếp vào một hàm gọi lại như hiện tại, phương thức 69 trả về một mô hình Eloquent được làm phẳng, cho phép bạn tương tác với các kết quả dưới dạng một luồng duy nhất 00Nếu bạn đang lọc kết quả của phương pháp 69 dựa trên một cột mà bạn cũng sẽ cập nhật trong khi lặp lại kết quả, bạn nên sử dụng phương pháp 74. Bên trong, phương thức 74 sẽ luôn truy xuất các mô hình có cột 16 lớn hơn mô hình cuối cùng trong đoạn trước 01Bạn có thể lọc kết quả dựa trên thứ tự giảm dần của 16 bằng phương pháp 78con trỏTương tự như phương pháp 69, phương pháp 80 có thể được sử dụng để giảm đáng kể mức tiêu thụ bộ nhớ của ứng dụng khi lặp qua hàng chục nghìn bản ghi mô hình EloquentPhương thức 80 sẽ chỉ thực hiện một truy vấn cơ sở dữ liệu duy nhất; . Do đó, chỉ có một mô hình Eloquent được lưu trong bộ nhớ tại bất kỳ thời điểm nào trong khi lặp qua con trỏ
Bên trong, phương thức 80 sử dụng trình tạo PHP để thực hiện chức năng này 02 80 trả về một phiên bản 86. cho phép bạn sử dụng nhiều phương thức thu thập có sẵn trên các bộ sưu tập điển hình của Laravel trong khi chỉ tải một mô hình duy nhất vào bộ nhớ tại một thời điểm 03Mặc dù phương thức 80 sử dụng ít bộ nhớ hơn nhiều so với truy vấn thông thường (bằng cách chỉ giữ một mô hình Eloquent duy nhất trong bộ nhớ tại một thời điểm), nhưng cuối cùng nó vẫn sẽ hết bộ nhớ. Điều này là do trình điều khiển PDO của PHP lưu trữ nội bộ tất cả các kết quả truy vấn thô trong bộ đệm của nó. Nếu bạn đang xử lý một số lượng lớn bản ghi Eloquent, hãy cân nhắc sử dụng thay thếTruy vấn con nâng caoLựa chọn truy vấn phụEloquent cũng cung cấp hỗ trợ truy vấn con nâng cao, cho phép bạn lấy thông tin từ các bảng có liên quan trong một truy vấn duy nhất. Ví dụ: hãy tưởng tượng rằng chúng ta có một bảng chuyến bay 89 và một bảng 12 đến các điểm đến. Bảng 12 chứa cột 92 cho biết thời điểm chuyến bay đến đíchSử dụng chức năng truy vấn phụ có sẵn cho các phương pháp 43 và 94 của trình tạo truy vấn, chúng tôi có thể chọn tất cả 89 và tên của chuyến bay đã đến điểm đến đó gần đây nhất bằng một truy vấn duy nhất 04Thứ tự truy vấn conNgoài ra, hàm 96 của trình tạo truy vấn hỗ trợ các truy vấn con. Tiếp tục sử dụng ví dụ về chuyến bay của chúng tôi, chúng tôi có thể sử dụng chức năng này để sắp xếp tất cả các điểm đến dựa trên thời điểm chuyến bay cuối cùng đến điểm đến đó. Một lần nữa, điều này có thể được thực hiện trong khi thực hiện một truy vấn cơ sở dữ liệu 05Truy xuất các mô hình đơn lẻ / tổng hợpNgoài việc truy xuất tất cả các bản ghi phù hợp với một truy vấn nhất định, bạn cũng có thể truy xuất các bản ghi đơn lẻ bằng các phương pháp 97, 98 hoặc 99. Thay vì trả về một tập hợp các mô hình, các phương thức này trả về một phiên bản mô hình duy nhất 06Đôi khi bạn có thể muốn thực hiện một số hành động khác nếu không tìm thấy kết quả. Các phương thức 00 và 01 sẽ trả về một phiên bản mô hình duy nhất hoặc nếu không tìm thấy kết quả nào, hãy thực hiện lệnh đóng đã cho. Giá trị trả về của bao đóng sẽ được coi là kết quả của phương thức 07Không tìm thấy ngoại lệĐôi khi bạn có thể muốn ném một ngoại lệ nếu không tìm thấy mô hình. Điều này đặc biệt hữu ích trong các tuyến đường hoặc bộ điều khiển. Các phương thức 02 và 03 sẽ lấy kết quả đầu tiên của truy vấn; 08Nếu không bắt được 05, phản hồi HTTP 404 sẽ tự động được gửi lại cho máy khách 09Truy xuất hoặc tạo mô hìnhPhương thức 06 sẽ cố gắng định vị một bản ghi cơ sở dữ liệu bằng cách sử dụng các cặp cột/giá trị đã cho. Nếu không thể tìm thấy mô hình trong cơ sở dữ liệu, một bản ghi sẽ được chèn với các thuộc tính do hợp nhất đối số mảng thứ nhất với đối số mảng thứ hai tùy chọnPhương thức 07, giống như 06, sẽ cố gắng xác định vị trí một bản ghi trong cơ sở dữ liệu khớp với các thuộc tính đã cho. Tuy nhiên, nếu không tìm thấy mô hình, một phiên bản mô hình mới sẽ được trả về. Lưu ý rằng mô hình được trả về bởi 07 vẫn chưa được lưu vào cơ sở dữ liệu. Bạn sẽ cần gọi thủ công phương thức 10 để duy trì nó 30Truy xuất tổng hợpKhi tương tác với các mô hình Eloquent, bạn cũng có thể sử dụng 11, 12, 13 và các mô hình khác do trình tạo truy vấn Laravel cung cấp. Như bạn có thể mong đợi, các phương thức này trả về một giá trị vô hướng thay vì một thể hiện của Eloquent model 31Chèn và cập nhật mô hìnhphụ trangTất nhiên, khi sử dụng Eloquent, chúng ta không chỉ cần lấy các model từ cơ sở dữ liệu. Chúng ta cũng cần chèn các bản ghi mới. Rất may, Eloquent làm cho nó đơn giản. Để chèn một bản ghi mới vào cơ sở dữ liệu, bạn nên khởi tạo một phiên bản mô hình mới và đặt các thuộc tính trên mô hình. Sau đó, gọi phương thức 10 trên phiên bản mô hình 32Trong ví dụ này, chúng tôi chỉ định trường 15 từ yêu cầu HTTP đến cho thuộc tính 15 của phiên bản mô hình 17. Khi chúng ta gọi phương thức 10, một bản ghi sẽ được chèn vào cơ sở dữ liệu. Dấu thời gian 27 và 28 của mô hình sẽ tự động được đặt khi phương thức 10 được gọi, vì vậy không cần phải đặt chúng theo cách thủ côngNgoài ra, bạn có thể sử dụng phương thức 22 để "lưu" một mô hình mới bằng một câu lệnh PHP. Phiên bản mô hình được chèn sẽ được trả về cho bạn bằng phương thức 22 33Tuy nhiên, trước khi sử dụng phương thức 22, bạn cần chỉ định thuộc tính 42 hoặc 26 trên lớp mô hình của mình. Các thuộc tính này là bắt buộc vì tất cả các mô hình Eloquent đều được bảo vệ khỏi các lỗ hổng gán hàng loạt theo mặc định. Để tìm hiểu thêm về chuyển nhượng hàng loạt, vui lòng tham khảocập nhậtPhương pháp 10 cũng có thể được sử dụng để cập nhật các mô hình đã tồn tại trong cơ sở dữ liệu. Để cập nhật một mô hình, bạn nên truy xuất mô hình đó và đặt bất kỳ thuộc tính nào bạn muốn cập nhật. Sau đó, bạn nên gọi phương thức 10 của mô hình. Một lần nữa, dấu thời gian 28 sẽ tự động được cập nhật, do đó không cần phải đặt giá trị của nó theo cách thủ công 34Cập nhật hàng loạtCập nhật cũng có thể được thực hiện đối với các mô hình phù hợp với một truy vấn nhất định. Trong ví dụ này, tất cả các chuyến bay là 30 và có 31 của 32 sẽ được đánh dấu là bị hoãn 35Phương thức 33 yêu cầu một mảng các cặp cột và giá trị đại diện cho các cột cần được cập nhật. Phương thức 33 trả về số hàng bị ảnh hưởng
Kiểm tra thay đổi thuộc tínhEloquent cung cấp các phương thức 39, 40 và 41 để kiểm tra trạng thái bên trong mô hình của bạn và xác định các thuộc tính của nó đã thay đổi như thế nào so với khi mô hình được truy xuất ban đầuPhương thức 39 xác định xem có bất kỳ thuộc tính nào của mô hình đã bị thay đổi kể từ khi mô hình được truy xuất hay không. Bạn có thể chuyển một tên thuộc tính cụ thể hoặc một mảng thuộc tính cho phương thức 39 để xác định xem có thuộc tính nào "bẩn" không. Phương thức 40 sẽ xác định xem một thuộc tính có không thay đổi kể từ khi mô hình được truy xuất hay không. Phương thức này cũng chấp nhận một đối số thuộc tính tùy chọn 36Phương thức 41 xác định xem có bất kỳ thuộc tính nào bị thay đổi khi mô hình được lưu lần cuối trong chu kỳ yêu cầu hiện tại hay không. Nếu cần, bạn có thể chuyển tên thuộc tính để xem liệu một thuộc tính cụ thể có bị thay đổi hay không 37Phương thức 46 trả về một mảng chứa các thuộc tính ban đầu của mô hình bất kể có bất kỳ thay đổi nào đối với mô hình kể từ khi nó được truy xuất. Nếu cần, bạn có thể chuyển một tên thuộc tính cụ thể để lấy giá trị ban đầu của một thuộc tính cụ thể 38chuyển nhượng hàng loạtBạn có thể sử dụng phương thức 22 để "lưu" một mô hình mới bằng một câu lệnh PHP. Phiên bản mô hình được chèn sẽ được trả về cho bạn theo phương thức 33Tuy nhiên, trước khi sử dụng phương thức 22, bạn cần chỉ định thuộc tính 42 hoặc 26 trên lớp mô hình của mình. Các thuộc tính này là bắt buộc vì tất cả các mô hình Eloquent đều được bảo vệ khỏi các lỗ hổng gán hàng loạt theo mặc địnhLỗ hổng gán hàng loạt xảy ra khi người dùng chuyển một trường yêu cầu HTTP không mong muốn và trường đó thay đổi một cột trong cơ sở dữ liệu của bạn mà bạn không mong đợi. Ví dụ: người dùng ác ý có thể gửi tham số 51 thông qua yêu cầu HTTP, sau đó yêu cầu này được chuyển đến phương thức 22 của mô hình của bạn, cho phép người dùng tự báo cáo với quản trị viênVì vậy, để bắt đầu, bạn nên xác định thuộc tính mô hình nào bạn muốn gán hàng loạt. Bạn có thể làm điều này bằng cách sử dụng thuộc tính 53 trên mô hình. Ví dụ: hãy đặt thuộc tính 15 của mô hình 10 có thể gán khối lượng 00Khi bạn đã chỉ định thuộc tính nào có thể gán hàng loạt, bạn có thể sử dụng phương thức 22 để chèn bản ghi mới vào cơ sở dữ liệu. Phương thức 22 trả về thể hiện mô hình mới được tạo 01Nếu bạn đã có một phiên bản mô hình, bạn có thể sử dụng phương thức 58 để điền vào đó một mảng các thuộc tính 02Chuyển nhượng hàng loạt & cột JSONKhi gán các cột JSON, khóa có thể gán hàng loạt của mỗi cột phải được chỉ định trong mảng 53 của mô hình của bạn. Để bảo mật, Laravel không hỗ trợ cập nhật các thuộc tính JSON lồng nhau khi sử dụng thuộc tính 26 03Cho phép chuyển nhượng hàng loạtNếu bạn muốn làm cho tất cả các thuộc tính của mình có thể gán hàng loạt, bạn có thể xác định thuộc tính 61 của mô hình của mình dưới dạng một mảng trống. Nếu bạn chọn không bảo vệ mô hình của mình, bạn nên đặc biệt cẩn thận để luôn tạo thủ công các mảng được truyền cho các phương thức 58, 22 và 33 của Eloquent 04Ngoại lệ chuyển nhượng hàng loạtTheo mặc định, các thuộc tính không được bao gồm trong mảng 53 sẽ bị loại bỏ một cách âm thầm khi thực hiện các thao tác gán hàng loạt. Trong sản xuất, đây là hành vi dự kiến; Nếu muốn, bạn có thể hướng dẫn Laravel ném một ngoại lệ khi cố điền một thuộc tính không thể điền bằng cách gọi phương thức 41. Thông thường, phương thức này nên được gọi trong phương thức 39 của một trong những nhà cung cấp dịch vụ ứng dụng của bạn 05UpsertsĐôi khi, bạn có thể cần cập nhật mô hình hiện có hoặc tạo mô hình mới nếu không có mô hình phù hợp. Giống như phương thức 06, phương thức 69 vẫn duy trì mô hình, vì vậy không cần phải gọi phương thức 10 theo cách thủ côngTrong ví dụ dưới đây, nếu một chuyến bay tồn tại với vị trí 71 của 72 và vị trí 31 của 32, các cột 75 và 76 của chuyến bay đó sẽ được cập nhật. Nếu không có chuyến bay nào như vậy tồn tại, một chuyến bay mới sẽ được tạo có các thuộc tính do hợp nhất mảng đối số thứ nhất với mảng đối số thứ hai 06Nếu bạn muốn thực hiện nhiều "uperts" trong một truy vấn, thì bạn nên sử dụng phương thức 77 để thay thế. Đối số đầu tiên của phương thức bao gồm các giá trị để chèn hoặc cập nhật, trong khi đối số thứ hai liệt kê (các) cột xác định duy nhất các bản ghi trong bảng được liên kết. Đối số thứ ba và cũng là đối số cuối cùng của phương thức là một mảng các cột sẽ được cập nhật nếu một bản ghi phù hợp đã tồn tại trong cơ sở dữ liệu. Phương pháp 77 sẽ tự động đặt dấu thời gian 27 và 28 nếu dấu thời gian được bật trên mô hình 07
Xóa mô hìnhĐể xóa một mô hình, bạn có thể gọi phương thức 83 trên phiên bản mô hìnhBạn có thể gọi phương thức 84 để xóa tất cả các bản ghi cơ sở dữ liệu liên quan của mô hình. Thao tác 84 cũng sẽ đặt lại mọi ID tăng tự động trên bảng được liên kết của mô hìnhXóa một mô hình hiện có bằng khóa chính của nóTrong ví dụ trên, chúng tôi đang truy xuất mô hình từ cơ sở dữ liệu trước khi gọi phương thức 83. Tuy nhiên, nếu bạn biết khóa chính của mô hình, bạn có thể xóa mô hình mà không truy xuất nó một cách rõ ràng bằng cách gọi phương thức 87. Ngoài việc chấp nhận một khóa chính duy nhất, phương thức 87 sẽ chấp nhận nhiều khóa chính, một mảng khóa chính hoặc tập hợp các khóa chính 08
Xóa mô hình bằng truy vấnTất nhiên, bạn có thể tạo truy vấn Eloquent để xóa tất cả các mô hình phù hợp với tiêu chí truy vấn của bạn. Trong ví dụ này, chúng tôi sẽ xóa tất cả các chuyến bay được đánh dấu là không hoạt động. Giống như cập nhật hàng loạt, xóa hàng loạt sẽ không gửi các sự kiện mô hình cho các mô hình bị xóa 09
Xóa mềmNgoài việc thực sự xóa các bản ghi khỏi cơ sở dữ liệu của bạn, Eloquent còn có thể "xóa mềm" các mô hình. Khi các mô hình bị xóa mềm, chúng không thực sự bị xóa khỏi cơ sở dữ liệu của bạn. Thay vào đó, một thuộc tính 95 được đặt trên mô hình cho biết ngày và giờ mà mô hình bị "xóa". Để kích hoạt xóa mềm cho một mô hình, hãy thêm đặc điểm 96 vào mô hình 30
Bạn cũng nên thêm cột 95 vào bảng cơ sở dữ liệu của mình. Trình tạo lược đồ Laravel chứa một phương thức trợ giúp để tạo cột này 31Bây giờ, khi bạn gọi phương thức 83 trên model, cột 95 sẽ được đặt thành ngày và giờ hiện tại. Tuy nhiên, bản ghi cơ sở dữ liệu của mô hình sẽ được để lại trong bảng. Khi truy vấn một mô hình sử dụng xóa mềm, các mô hình đã xóa mềm sẽ tự động bị loại khỏi tất cả các kết quả truy vấnĐể xác định xem một phiên bản mô hình nhất định đã bị xóa mềm hay chưa, bạn có thể sử dụng phương pháp 004Khôi phục các mô hình đã xóa mềmĐôi khi bạn có thể muốn "hủy xóa" một mô hình đã xóa mềm. Để khôi phục một mô hình đã xóa mềm, bạn có thể gọi phương thức 005 trên một phiên bản mô hình. Phương pháp 005 sẽ đặt cột 95 của mô hình thành 008Bạn cũng có thể sử dụng phương pháp 005 trong truy vấn để khôi phục nhiều kiểu máy. Một lần nữa, giống như các hoạt động "khối lượng" khác, thao tác này sẽ không gửi bất kỳ sự kiện mô hình nào cho các mô hình được khôi phụcPhương pháp 005 cũng có thể được sử dụng khi xây dựng các truy vấn mối quan hệ 32Xóa vĩnh viễn các mô hìnhĐôi khi bạn có thể cần thực sự xóa một mô hình khỏi cơ sở dữ liệu của mình. Bạn có thể sử dụng phương pháp 011 để xóa vĩnh viễn mô hình đã xóa mềm khỏi bảng cơ sở dữ liệuBạn cũng có thể sử dụng phương thức 011 khi xây dựng các truy vấn quan hệ Eloquent 33Truy vấn các mô hình đã xóa mềmBao gồm cả các mô hình đã xóa mềmNhư đã lưu ý ở trên, các mô hình đã xóa mềm sẽ tự động bị loại khỏi kết quả truy vấn. Tuy nhiên, bạn có thể buộc các mô hình đã xóa mềm được đưa vào kết quả của truy vấn bằng cách gọi phương thức 013 trên truy vấn 34Phương thức 013 cũng có thể được gọi khi xây dựng truy vấn mối quan hệ 35Chỉ truy xuất các mô hình đã xóa mềmPhương pháp 015 sẽ chỉ truy xuất các mô hình đã xóa mềm 36Mô hình cắt tỉaĐôi khi bạn có thể muốn xóa định kỳ các mô hình không còn cần thiết. Để thực hiện điều này, bạn có thể thêm đặc điểm 016 hoặc 017 vào các mô hình mà bạn muốn cắt tỉa định kỳ. Sau khi thêm một trong các đặc điểm vào mô hình, hãy triển khai phương thức 018 trả về trình tạo truy vấn Eloquent để giải quyết các mô hình không còn cần thiết 37Khi đánh dấu các mô hình là 019, bạn cũng có thể xác định một phương pháp 020 trên mô hình. Phương thức này sẽ được gọi trước khi mô hình bị xóa. Phương pháp này có thể hữu ích để xóa bất kỳ tài nguyên bổ sung nào được liên kết với mô hình, chẳng hạn như các tệp được lưu trữ, trước khi mô hình bị xóa vĩnh viễn khỏi cơ sở dữ liệu 38Sau khi định cấu hình mô hình có thể cắt được của bạn, bạn nên lên lịch cho lệnh Artisan 021 trong lớp 022 của ứng dụng của bạn. Bạn có thể tự do chọn khoảng thời gian thích hợp để chạy lệnh này 39Đằng sau hậu trường, lệnh 021 sẽ tự động phát hiện các mô hình "Có thể cắt được" trong thư mục 09 của ứng dụng của bạn. Nếu các mô hình của bạn ở một vị trí khác, bạn có thể sử dụng tùy chọn 025 để chỉ định tên lớp mô hình 60Nếu bạn muốn loại trừ một số mô hình khỏi bị cắt tỉa trong khi cắt tỉa tất cả các mô hình được phát hiện khác, bạn có thể sử dụng tùy chọn 026 61Bạn có thể kiểm tra truy vấn 018 của mình bằng cách thực hiện lệnh 021 với tùy chọn 029. Khi giả vờ, lệnh 021 sẽ chỉ báo cáo có bao nhiêu bản ghi sẽ bị cắt bớt nếu lệnh thực sự chạy 62
cắt tỉa hàng loạtKhi các mô hình được đánh dấu bằng đặc điểm 017, các mô hình sẽ bị xóa khỏi cơ sở dữ liệu bằng truy vấn xóa hàng loạt. Do đó, phương thức 020 sẽ không được gọi, cũng như các sự kiện mô hình 91 và 92 sẽ không được gửi đi. Điều này là do các mô hình không bao giờ thực sự được truy xuất trước khi xóa, do đó làm cho quá trình cắt tỉa hiệu quả hơn nhiều 63Sao chép mô hìnhBạn có thể tạo một bản sao chưa lưu của một phiên bản mô hình hiện có bằng cách sử dụng phương pháp 036. Phương pháp này đặc biệt hữu ích khi bạn có các phiên bản mô hình chia sẻ nhiều thuộc tính giống nhau 64Để loại trừ một hoặc nhiều thuộc tính không được sao chép sang mô hình mới, bạn có thể chuyển một mảng cho phương thức 036 65Phạm vi truy vấnPhạm vi toàn cầuPhạm vi toàn cầu cho phép bạn thêm các ràng buộc vào tất cả các truy vấn cho một mô hình nhất định. Chức năng riêng của Laravel sử dụng phạm vi toàn cầu để chỉ truy xuất các mô hình "không bị xóa" khỏi cơ sở dữ liệu. Viết phạm vi toàn cầu của riêng bạn có thể cung cấp một cách thuận tiện, dễ dàng để đảm bảo mọi truy vấn cho một mô hình nhất định đều nhận được các ràng buộc nhất định Viết phạm vi toàn cầuViết một phạm vi toàn cầu là đơn giản. Đầu tiên, xác định một lớp triển khai giao diện 038. Laravel không có một vị trí thông thường nơi bạn nên đặt các lớp phạm vi, vì vậy bạn có thể đặt lớp này trong bất kỳ thư mục nào bạn muốnGiao diện 039 yêu cầu bạn triển khai một phương thức. 040. Phương thức 040 có thể thêm các ràng buộc 042 hoặc các loại mệnh đề khác vào truy vấn khi cần 66
Áp dụng phạm vi toàn cầuĐể gán phạm vi toàn cầu cho một mô hình, bạn nên ghi đè phương thức 045 của mô hình và gọi phương thức 046 của mô hình. Phương thức 046 chấp nhận một thể hiện trong phạm vi của bạn làm đối số duy nhất của nó 67Sau khi thêm phạm vi trong ví dụ trên vào mô hình 048, lệnh gọi phương thức 049 sẽ thực thi truy vấn SQL sau 68Phạm vi toàn cầu ẩn danhEloquent cũng cho phép bạn xác định các phạm vi toàn cầu bằng cách sử dụng các bao đóng, điều này đặc biệt hữu ích cho các phạm vi đơn giản không đảm bảo một lớp riêng biệt của riêng chúng. Khi xác định phạm vi toàn cầu bằng cách sử dụng bao đóng, bạn nên cung cấp tên phạm vi do chính bạn chọn làm đối số đầu tiên cho phương thức 046 69Loại bỏ phạm vi toàn cầuNếu bạn muốn xóa phạm vi toàn cầu cho một truy vấn nhất định, bạn có thể sử dụng phương pháp 051. Phương thức này chấp nhận tên lớp của phạm vi toàn cầu làm đối số duy nhất của nó 90Hoặc, nếu bạn đã xác định phạm vi toàn cầu bằng bao đóng, bạn nên chuyển tên chuỗi mà bạn đã gán cho phạm vi toàn cầu 91Nếu bạn muốn xóa một số hoặc thậm chí tất cả phạm vi toàn cầu của truy vấn, bạn có thể sử dụng phương pháp 052 92Phạm vi cục bộPhạm vi cục bộ cho phép bạn xác định các bộ ràng buộc truy vấn phổ biến mà bạn có thể dễ dàng sử dụng lại trong ứng dụng của mình. Ví dụ: bạn có thể cần thường xuyên truy xuất tất cả người dùng được coi là "phổ biến". Để xác định phạm vi, thêm tiền tố vào một phương thức mô hình Eloquent bằng 053Phạm vi phải luôn trả về cùng một phiên bản trình tạo truy vấn hoặc 054 93Sử dụng phạm vi cục bộKhi phạm vi đã được xác định, bạn có thể gọi các phương thức phạm vi khi truy vấn mô hình. Tuy nhiên, bạn không nên bao gồm tiền tố 053 khi gọi phương thức. Bạn thậm chí có thể xâu chuỗi các cuộc gọi đến các phạm vi khác nhau 94Kết hợp nhiều phạm vi mô hình Eloquent thông qua toán tử truy vấn 056 có thể yêu cầu sử dụng các bao đóng để đạt được kết quả chính xác 95Tuy nhiên, vì điều này có thể rườm rà, nên Laravel cung cấp phương thức 057 "bậc cao hơn" cho phép bạn xâu chuỗi các phạm vi lại với nhau một cách trôi chảy mà không cần sử dụng bao đóng 96Phạm vi độngĐôi khi bạn có thể muốn xác định một phạm vi chấp nhận các tham số. Để bắt đầu, chỉ cần thêm các tham số bổ sung vào chữ ký của phương thức phạm vi của bạn. Tham số phạm vi phải được xác định sau tham số 058 97Khi các đối số dự kiến đã được thêm vào chữ ký của phương thức phạm vi của bạn, bạn có thể chuyển các đối số khi gọi phạm vi 98So sánh các mô hìnhĐôi khi bạn có thể cần xác định xem hai mô hình có "giống nhau" hay không. Các phương pháp 059 và 060 có thể được sử dụng để nhanh chóng xác minh hai mô hình có cùng khóa chính, bảng và kết nối cơ sở dữ liệu hay không 99Các phương pháp 059 và 060 cũng khả dụng khi sử dụng các mối quan hệ ________ 1063, ________ 1064, ______ 1065 và ________ 1066. Phương pháp này đặc biệt hữu ích khi bạn muốn so sánh một mô hình có liên quan mà không đưa ra truy vấn để truy xuất mô hình đó 10Sự kiện
Các mô hình Eloquent gửi một số sự kiện, cho phép bạn kết nối với những khoảnh khắc sau trong vòng đời của một mô hình. ________ 1067, ________ 1068, ______ 1069, 37, 38, 35, 36, 91, 92, 004, 077, 078, 079 và 080Sự kiện 067 sẽ gửi đi khi một mô hình hiện có được lấy từ cơ sở dữ liệu. Khi một mô hình mới được lưu lần đầu tiên, các sự kiện 068 và 069 sẽ gửi đi. Các sự kiện 37 / 38 sẽ gửi đi khi một mô hình hiện có được sửa đổi và phương thức 10 được gọi. Các sự kiện 35 / 36 sẽ gửi đi khi một mô hình được tạo hoặc cập nhật - ngay cả khi các thuộc tính của mô hình không bị thay đổi. Tên sự kiện kết thúc bằng 089 được gửi đi trước khi bất kỳ thay đổi nào đối với mô hình được duy trì, trong khi các sự kiện kết thúc bằng 090 được gửi đi sau khi các thay đổi đối với mô hình được duy trìĐể bắt đầu lắng nghe các sự kiện mô hình, hãy xác định thuộc tính 091 trên mô hình Eloquent của bạn. Thuộc tính này ánh xạ các điểm khác nhau trong vòng đời của mô hình Eloquent tới các lớp sự kiện của riêng bạn. Mỗi lớp sự kiện mô hình sẽ nhận được một phiên bản của mô hình bị ảnh hưởng thông qua hàm tạo của nó 11Sau khi xác định và ánh xạ các sự kiện Eloquent của bạn, bạn có thể sử dụng để xử lý các sự kiện
Sử dụng ClosuresThay vì sử dụng các lớp sự kiện tùy chỉnh, bạn có thể đăng ký các lần đóng để thực thi khi các sự kiện mô hình khác nhau được gửi đi. Thông thường, bạn nên đăng ký các bao đóng này trong phương pháp 045 của mô hình của bạn 12Nếu cần, bạn có thể sử dụng khi đăng ký các sự kiện mô hình. Điều này sẽ hướng dẫn Laravel thực thi trình lắng nghe sự kiện mô hình trong nền bằng cách sử dụng hàng đợi của ứng dụng của bạn 13quan sát viênXác định người quan sátNếu bạn đang lắng nghe nhiều sự kiện trên một mô hình nhất định, bạn có thể sử dụng bộ quan sát để nhóm tất cả người nghe của mình vào một lớp duy nhất. Các lớp Người quan sát có các tên phương thức phản ánh các sự kiện Eloquent mà bạn muốn lắng nghe. Mỗi phương thức này nhận mô hình bị ảnh hưởng làm đối số duy nhất của chúng. Lệnh 097 Artisan là cách dễ nhất để tạo một lớp quan sát viên mới 14Lệnh này sẽ đặt người quan sát mới vào thư mục 098 của bạn. Nếu thư mục này không tồn tại, Artisan sẽ tạo nó cho bạn. Người quan sát mới của bạn sẽ giống như sau 15Để đăng ký một người quan sát, bạn cần gọi phương thức 099 trên mô hình mà bạn muốn quan sát. Bạn có thể đăng ký người quan sát theo phương pháp 39 của nhà cung cấp dịch vụ 301 của ứng dụng của bạn 16Ngoài ra, bạn có thể liệt kê các quan sát viên của mình trong một thuộc tính 302 của lớp 301 của ứng dụng của bạn 17
Người quan sát & Giao dịch cơ sở dữ liệuKhi các mô hình đang được tạo trong một giao dịch cơ sở dữ liệu, bạn có thể muốn hướng dẫn một người quan sát chỉ thực hiện các trình xử lý sự kiện của nó sau khi giao dịch cơ sở dữ liệu được thực hiện. Bạn có thể thực hiện điều này bằng cách xác định một thuộc tính 306 trên người quan sát. Nếu một giao dịch cơ sở dữ liệu không được tiến hành, các trình xử lý sự kiện sẽ thực thi ngay lập tức 18Sự kiện tắt tiếngĐôi khi, bạn có thể cần tạm thời "tắt tiếng" tất cả các sự kiện được kích hoạt bởi một mô hình. Bạn có thể đạt được điều này bằng cách sử dụng phương pháp 307. Phương thức 307 chấp nhận một bao đóng làm đối số duy nhất của nó. Bất kỳ mã nào được thực thi trong lần đóng này sẽ không gửi các sự kiện mô hình và mọi giá trị được trả về bởi lần đóng sẽ được trả về bằng phương thức 307 19Lưu một mô hình duy nhất mà không có sự kiệnĐôi khi bạn có thể muốn "lưu" một mô hình nhất định mà không gửi bất kỳ sự kiện nào. Bạn có thể thực hiện việc này bằng cách sử dụng phương pháp 310 00Bạn cũng có thể "cập nhật", "xóa", "xóa mềm", "khôi phục" và "sao chép" một mô hình nhất định mà không gửi bất kỳ sự kiện nào |