Hướng dẫn học CakePHP: Một số qui ước CakePHP cần chú ý

Nội dung :

• - Cách đặt tên file
• - Tên lớp
• - Các qui ước khi dùng Model, View , Controllers .

1. Cách đặt tên file, tên lớp

• - Tên file sử dụng chữ thường, dùng dấu “_” để phân cách các từ
• - Tên lớp dùng CamelCased (viết hoa chữ cái đầu tiên của từ)

Ví dụ : ta có tên lớp là MyClass -> file class tương ứng : my_class.php
Dưới đây là các ví dụ về cách đặt tên file cho mỗi dạng lớp khác nhau mà bạn thường sử dụng trong ứng dụng CakePHP :

2. Các qui ước về Model và CSDL

- Tên các lớp model được đặt ở dạng số ít và việc viết hoa thường tuân theo CamelCased
Ví dụ: Person, BigPerson và ReallyBigPerson.
- CakePHP không hỗ trợ khóa chính gồm nhiều cột. Nếu bạn muốn thao tác trực tiếp kết nối (join) các bảng, hãy truy vấn trực tiếp hoặc thêm một khóa chính thay cho khóa nhiều cột.
Ví dụ:

CREATE TABLE posts_tags (
id INT(10) NOT NULL AUTO_INCREMENT,
post_id INT(10) NOT NULL,
tag_id INT(10) NOT NULL,
PRIMARY KEY(id));

- Lẽ ra trong table post_tags, bình thường thì 2 cột post_id và tag_id ta có thể cho nó làm khóa chính nhưng CakePHP không chấp nhận điều này.
- Tên bảng tương ứng với các model của CakePHP ở dạng số nhiều và sử dụng gạch dưới (_) tên bảng tương ứng với các model ở trên là people, big_people, và really_big_people.
- Tuy nhiên, bạn vẫn có thể đặt tên bảng khác đi và cho CakePHP biết điều này thông qua biến $useTable trong model (các bài viết tiếp theo sẽ có ví dụ)
- Bạn có thể dùng thư viện Inflector có sẵn trong CakePHP để kiểm tra dạng số ít/số nhiều của các từ.
- Các khóa ngoại trong các quan hệ hasMany, belongsTo, hasOne có tên mặc định là số ít của tên bảng kèm theo _id ở cuối cùng.
Ví dụ với quan hệ NewsCategory có nhiều News, bảng news sẽ có khóa ngoại đến bảng news_categories là news_category_id.
- Các bảng liên kết được sử dụng trong quan hệ hasAnhBelongsToMany (viết tắt là HABTM – quan hệ nhiều nhiều) được đặt tên bằng cách kết nối các tên model theo thứ tự abc, vì vậy tên đúng sẽ là apples_zebras chứ không phải là zebras_apples.
- Do đó, ta phải thêm một khóa khác có tên là id
- Khóa chính mặc định trong CakePHP là cột id, kiểu int, tự tăng. Tuy nhiên, bạn cũng có thể định nghĩa lại khóa chính cho bảng thông qua biến $primaryKey trong model
- Thay cho việc sử dụng kiểu int, auto-increment làm khóa chính, bạn có thể sự dụng char(36) hoặc binary(36), khi đó CakePHP sẽ tự động tạo ra UUIDs để làm khóa khi ta thêm mới một record. UUID là một chuỗi gồm 32 byte, tương ứng với 36 ký tự.
Ví dụ : 550e8400-e29b-41d4-a716-446655440000

3. Qui ước về Controller :

- Tên lớp của controller đặt theo dạng số nhiều,
- Tuân theo CamelCased và cuối tên phải có chữ “Controller”.

Ví dụ: ta có Controller tên Products thì có class Controller như sau :

- Khi một phương thức trong Controller được đặt tên bắt đầu với với dấu “_” ở phía trước, bạn sẽ không thể truy xuất nó từ bên ngoài mà chỉ có thể truy xuất trong controller đó (cái này gọi là private).
Ví dụ:
 

Mô tả hoạt động :
- http://localhost/products : function index() : run
- http://localhost/products/_get_product : function _get_product() : not run
- http://localhost/products/viewProduct : function _get_product() : run

4. Qui ước về View

- Tên file của View được đặt tương ứng với phương thức trong Controller và để trong thư mục theo tên file controller (không kèm theo chữ “controller”).
- Đuôi file dạng *.ctp

Ví dụ :

- Mặc định, nếu trong controller NewsController có method view(), khi gọi action view trên trình duyệt (http://localhost/news/view) thì Controller sẽ tìm file view.ctp trong app/views/news/view.ctp
- Tuy nhiên, bạn có thể gọi một file view khác không phải là view.ctp bằng lệnh

Ví dụ về mặc định :

Ví dụ về load 1 file view khác :

- Truy cập : http://localhost/news/view -> load file : view_demo.ctp trong thư mục app/views/news/

5.Tổng kết : viết demo đơn giản với CakePHP

- Viết dứng dụng đơn giản với đường link : http://localhost/cakephp/relax/playgame/10
- Từ link trên, ta cần có :
- Model : trong ví dụ này không xử lý dữ liệu nên không cần viết
- View : file view.ctp để hiển thị kết quả : Ban dang chon tro choi thu 12
- Controller : Relax với action Playgame nhận tham số 12
Cách thực hiện :
- Vào thư mục app/controllers/ tạo relaxs_controller.php với nội dung :

PHP Code:

- Vào thư mục app/views/ tạo thư mục relaxs ứng với Controllers relaxs trên
- Trong thư mục relaxs mới tạo , ta tạo file playgame.ctp với nội dung :

-Kiểm tra kết quả : http://localhost/relaxs/playgame/12

Title không hiển thị kết quả như mong muốn do CakePHP có 2 chế độ :
- Dùng template có sẳn của nó
- Template của mình
Trong ví dụ này , mình dùng template mặc định nên phần title là do CakePHP quyết định