12/08/2018, 15:45

Giới thiệu về Orm Creating models and Relating Models trong Fuel PHP

1. Tạo Models Model có thể tạo một cách nhanh chóng và dễ dàng. Trong Model của Fuel có các convention khác các framework khác, model được đặt tên có tiền tố Model_ cho class đó. Ví dụ như Model_Article class sử dụng tên file article.php. Model được đặt trong thư mục /app/classes/model/ . Tuy ...

1. Tạo Models

Model có thể tạo một cách nhanh chóng và dễ dàng. Trong Model của Fuel có các convention khác các framework khác, model được đặt tên có tiền tố Model_ cho class đó. Ví dụ như Model_Article class sử dụng tên file article.php. Model được đặt trong thư mục /app/classes/model/ . Tuy nhiên bạn có thể sử dụng bất kỳ tên nào bạn muốn đặt mà không cần tuân theo convention.

Ví dụ:

class Model_Article extends OrmModel {}

Ví dụ trên chỉ làm việc với MySQL và MySQLi bởi vì nó cần phải lấy các thuộc tính mô hình từ cơ sở dữ liệu. Tuy nhiên nó không phải là rất hiệu quả và do đó không khuyến khích sử dụng nó theo cách này bởi vì bạn sẽ luôn luôn cần một truy vấn thêm cho mỗi model chỉ để lấy tên cột

Ví du:

class Model_Article extends OrmModel
{
    protected static $_properties = array('id', 'title', 'contents', 'publish');
}

2. Cấu hình Models

Bạn có thể thêm thuộc tính vào Model để cấu hình nó Như mình đã trình bày ở phần 1, việc setting các thuộc tính cho model là không bắt buộc, tuy nhiên khi tạo model mọi người nên setting thuộc tính cho model đó. Khi setting properties, chúng ta có thể khai báo public hay protected, lưu ý là không thể khai báo private. Lưu ý rằng tất cả các thuộc tính cấu hình được đặt trước bằng một dấu gạch dưới đơn để tránh va chạm với các tên cột của bạn.

  • protected static $$table_name

Model với tên Model_Article là model cho table "articles". Nếu bạn ko đặt tên đúng quy chuẩn này thì bạn có thể setting lại bằng cách thêm thuộc tính $$table_name.

Ví dụ:

class Model_Article extends OrmModel
{
    protected static $_table_name = 'myarticles';
}
  • protected static $$primary_key

Theo mặc định điều này được thiết lập từ array('id') . Nếu bạn sử dụng một tên cột khác hoặc nhiều khóa chính bạn cần phải thiết lập thuộc tính này.

Ví dụ:

class Model_Article extends OrmModel
{
    protected static $_primary_key = array('aid');
}

Khóa chính phải là khóa: duy nhất và không thay đổi.

  • protected static $$properties

Đã có một ví dụ đơn giản ở trên để thêm tất cả các thuộc tính cho model, chúng cũng có thể được cấu hình bằng cách sử dụng tên cột như là khoá và các tùy chọn cài đặt như type, label và validation.

Ví dụ:

class Model_Article extends OrmModel
{
    protected static $_properties = array(
        'id', // both validation & typing observers will ignore the PK
        'name' => array(
            'data_type' => 'varchar',
            'label' => 'Article Name',
            'validation' => array('required', 'min_length' => array(3), 'max_length' => array(20)),
            'form' => array('type' => 'text'),
            'default' => 'New article',
        ),
        'gender' => array(
            'data_type' => 'varchar',
            'label' => 'Gender',
            'form' => array('type' => 'select', 'options' => array('m' => 'Male', 'f' => 'Female')),
            'validation' => array('required'),
        ),
        'created_at' => array(
            'data_type' => 'int',
            'label' => 'Created At',
            'form' => array(
                'type' => false, // this prevents this field from being rendered on a form
            ),
        ),
        'updated_at' => array('data_type' => 'int', 'label' => 'Updated At')
    );
}

Các form thuộc tính có thể được truyền theo dạng một mảng như trong ví dụ.

Validation rules có thể được thông qua như là một trong hai quy tắc: array ('required') hoặc như là một rule với một mảng các params: mảng ('min_length' => mảng (3)) cả hai được hiển thị trong ví dụ trên. Giải thích đầy đủ về class Validation và rules của nó có thể được tìm thấy trong phần Core. Bạn cần thiết lập Observer_Validation để chạy xác nhận.

  • protected static $$conditions

Theo mặc định thuộc tính này không tồn tại và Model :: condition () trả về array(). Tuy nhiên bạn cũng có thể thiết lập trong model nếu bạn muốn bất kỳ điều kiện nào được xác định trên mỗi truy vấn được thực hiện.Hiện tại, 'order_by' và 'where' được hỗ trợ.

Ví dụ:

class Model_Article extends OrmModel
{
    protected static $_conditions = array(
        'order_by' => array('id' => 'desc'),
        'where' => array(
            array('publish_date', '>', 1370721177),
            array('published', '=', 1),
        ),
    );
}

Order_by chỉ được áp dụng nếu không xác định được thứ tự khác trong truy vấn. Where được thêm vào bằng cách sử dụng and đối với bất kỳ mệnh đề nào khác được xác định.

  • protected static hasone,_has_one, hasone,_belongs_to, hasmany,_has_many, hasmany,_many_many

The Orm hỗ trợ các loại mối quan hệ sau natively:

  • Belongs To
  • Has One
  • Has Many
  • Many to Many

3. Relating Models

3.1. Relations: Belongs To

Khóa chính (Primary key) trong bảng là thể hiện sự ràng buộc tới một bảng khác: thuộc về 1 đối tượng liên quan. Đây là phía bên kia của mối quan hệ HasOne hoặc HasMany. Ví dụ: Giả sử chúng ta có mô hình Model_Comment và nó thuộc về Model_Post (một post có nhiều comment) như vậy id của Model_Post sẽ được lưu và bảng của Model_Comment. Điều này có nghĩa bảng comments sẽ có cột post_id (hoặc cái tên khác bạn cấu hình). Nếu bạn giữ nguyên mặc định thì tất cả những gì bạn cần làm là thêm 'post' vào static property $$belongs_to của Model_Comment:

Ví dụ:

protected static $_belongs_to = array('post');

Dưới đây là những ví dụ để thiết lập và breaking các mối quan hệ belongs-to:

Ví dụ:

// both main and related object are new:
$comment = new Model_Comment();
$comment->post = new Model_Post();
$comment->save();

// both main and related object already exist
$comment = Model_Comment::find(6);
$comment->post = Model_Post::find(1);
$comment->save();

// break the relationship established above
$comment = Model_Comment::find(6);
$comment->post = null;
$comment->save();

Ví dụ cấu hình đầy đủ với giá trị mặc định là giá trị:

// in a Model_Comment which belong to a post
protected static $_belongs_to = array(
    'post' => array(
        'key_from' => 'post_id',
        'model_to' => 'Model_Post',
        'key_to' => 'id',
        'cascade_save' => true,
        'cascade_delete' => false,
    )
);

3.2. Relations: Has One

Chỉ định quan hệ một-một với model khác. Giả sử chúng ta có model Model_User và nó có một Model_Profile. Điều này có nghĩa là bảng profiles sẽ có một user_id cột (hoặc cái tên khác bạn cấu hình), trong khi bảng user sẽ không đề cập đến trong profile. Nếu bạn giữ nguyên mặc định thì tất cả những gì bạn cần làm là thêm 'profile' vào static property $$_has_one của Model_User:

Ví dụ:

protected static $_has_one = array('profile');

Dưới đây là những ví dụ để thiết lập và breaking các mối quan hệ has_one:

// both main and related object are new:
$user = new Model_User();
$user->profile = new Model_Profile();
$user->save();

// both main and related object already exist
$user = Model_User::find(6);
$user->profile = Model_Profile::find(1);
$user->save();

// break the relationship established above
$user = Model_User::find(6);
$user->profile = null;
$user->save();

Ví dụ cấu hình đầy đủ với giá trị mặc định là giá trị:

// in a Model_User which has one profile
protected static $_has_one = array(
    'profile' => array(
        'key_from' => 'id',
        'model_to' => 'Model_Profile',
        'key_to' => 'user_id',
        'cascade_save' => true,
        'cascade_delete' => false,
    )
);

3.3. Relations: Has Many

Chỉ định quan hệ một-nhiều với model khác. Giả sử chúng ta có model Model_Post và nó có nhiều Model_Comments. ID của Model_Post được lưu Model_Comment instance trong bảng riêng của nó. Điều này có nghĩa bảng comments sẽ có một cột post_id (hoặc cái tên khác bạn cấu hình), trong khi bảng posts sẽ không đề cập đến comments. Nếu bạn giữ nguyên mặc định tất cả những gì bạn cần làm là thêm 'comments' vàostatic property $$_has_many của Model_User:

Ví dụ:

protected static $_has_many = array('comments');

Dưới đây là những ví dụ để thiết lập và breaking các mối quan hệ has_many:

// both main and related object are new:
$post = new Model_Post();
$post->comments[] = new Model_Comment();
$post->save();

// both main and related object already exist
$post = Model_Post::find(1);
$post->comments[6] = Model_Comment::find(6); // assigning it to comments[6] is not required but recommended
$post->save();

// break the relationship established above
$post = Model_Post::find(1);
unset($post->comments[6]);
$post->save();

Ví dụ cấu hình đầy đủ với giá trị mặc định là giá trị:

// in a Model_Post which has many comments
protected static $_has_many = array(
    'comments' => array(
        'key_from' => 'id',
        'model_to' => 'Model_Comment',
        'key_to' => 'post_id',
        'cascade_save' => true,
        'cascade_delete' => false,
    )
);

3.4. Relations: Many to Many

Chỉ định một mối quan hệ nhiều - nhiều với một model khác. Để thiết lậpmối quan hệ này, bạn cần một bảng trung gian chỉ với 2 ID từ cả hai phía của quan hệ là khóa chính kép.

Ví dụ định nghĩa quan hệ thông qua bảng:

protected static $_many_many = array(
    'users' => array(
        'table_through' => 'posts_users', 	// both models plural without prefix in alphabetical order
        'conditions' => array(
           'order_by' => array(
                'posts_users.status' => 'ASC'	// define custom through table ordering
            ),
        ),
    )
);
// other fields that may be required have been ommitted for this example

Giả sử chúng ta có model Model_Post và nó có nhiều và thuộc về nhiều Model_Users. ID của Model_Post cùng với ID của Model_User trong một bảng được gọi là posts_users (thứ tự mặc định theo thứ tự chữ cái). Bảng đó chỉ có 2 cột: post_id và user_id cùng với khoá chính của bảng đó. Nếu bạn giữ nguyên mặc định tất cả những gì bạn cần làm là thêm 'users' vào thuộc tính tĩnh $$_many_many của Model_Post:

Ví dụ:

protected static $_many_many = array('users');

Và bạn cần phải thêm một bảng như thế này để SQL của bạn:

CREATE TABLE IF NOT EXISTS `posts_users` (
  `post_id` int(11) NOT NULL,
  `user_id` int(11) NOT NULL,
  PRIMARY KEY (`post_id`,`user_id`)
);

Dưới đây là những ví dụ để thiết lập và breaking các mối quan hệ many_many:

// both main and related object are new:
$post = new Model_Post();
$post->users[] = new Model_User();
$post->save();

// both main and related object already exist
$user = Model_User::find(8);
$user->posts[1] = Model_Post::find(1);
$user->save();

// break the relationship established above
$post = Model_Post::find(1);
unset($post->users[8]);
$post->save();

Ví dụ cấu hình đầy đủ với giá trị mặc định là giá trị:

// in a Model_Post which has and belongs to many Users
// = multiple posts per user and multiple users (authors) per post
protected static $_many_many = array(
    'users' => array(
        'key_from' => 'id',
        'key_through_from' => 'post_id', // column 1 from the table in between, should match a posts.id
        'table_through' => 'posts_users', // both models plural without prefix in alphabetical order
        'key_through_to' => 'user_id', // column 2 from the table in between, should match a users.id
        'model_to' => 'Model_User',
        'key_to' => 'id',
        'cascade_save' => true,
        'cascade_delete' => false,
    )
);

4. Tổng kết và tài liệu tham khảo

Hi vọng phần giới thiệu trên có thể giúp các bạn hiểu Fuelphp với cách thiết lập các mối quan hệ đơn giản, quản lý các bảng trong cơ sở dữ liệu và các quan hệ giữa chúng, qua đó chúng ta cũng sẽ biết cách để lấy dữ liệu như thế nào cho phù hợp với yêu cầu đặt ra. Thôi thì xong rồi, chúc bà con ngủ ngon (haiz)

  1. https://fuelphp.com/docs/index.html
  2. https://fuelphp.com/docs/packages/orm/relations/belongs_to.html
  3. https://fuelphp.com/docs/packages/orm/relations/has_one.html
  4. https://fuelphp.com/docs/packages/orm/relations/has_many.html
  5. https://fuelphp.com/docs/packages/orm/relations/many_many.html
Bài liên quan

Giới thiệu về Orm Creating models and Relating Models trong Fuel PHP

1. Tạo Models Model có thể tạo một cách nhanh chóng và dễ dàng. Trong Model của Fuel có các convention khác các framework khác, model được đặt tên có tiền tố Model_ cho class đó. Ví dụ như Model_Article class sử dụng tên file article.php. Model được đặt trong thư mục /app/classes/model/ . Tuy ...

Bùi Văn Nam viết 15:45 ngày 12/08/2018

Giới thiệu về Fuel PHP và Orm CRUD trong Fuel PHP

1. Fuel PHP FuelPHP là một framework đơn giản, linh hoạt, hướng cộng đồng và được viết mới hoàn toàn dựa trên PHP 5.3+ với những ý tưởng tốt nhất của các framework khác. FuelPHP được xây dựng theo mô hình MVC, có hỗ trợ đầy đủ mô hình HMVC. Ngoài ra FuelPHP cũng hỗ trợ thêm một khái niệm gọi là ...

Bùi Văn Nam viết 15:37 ngày 12/08/2018

Giới thiệu về ConstraintLayout (P2) Add Constraint layout vào trong project

Xin chào 500 anh em! Như ở Phần 1 mình đã liệt kê các phần mới của ConstraintLayout để mọi người có thể hiểu rõ hơn về nó. Ở phần này mình sẽ hướng dẫn các bạn sử dụng ContraintLayout trong việc tạo giao diện. 1. Thêm Contraint Layout vào trong Project Trong Android Studio 2.2 đã cập nhật hầu ...

Bùi Văn Nam viết 13:34 ngày 12/08/2018

[Network] Giới thiệu về PfSense

Để bảo vệ hệ thống mạng thì ta có nhiều giải pháp như sử dụng router cisco, dùng firewall cứng, firewall mềm của microsoft như ISA … Những thiết bị như trên rất tốn kinh phí vì vậy đối với các doanh nghiệp vừa và nhỏ thì giải pháp firewall mềm mã nguồn mở là một phương án hiệu quả. Pfsense ...

Bùi Văn Nam viết 23:12 ngày 11/08/2018

Giới thiệu về knockout js ( Phần 1)

Giới thiệu chung Mô hình của Knockout js(MVVM) Hướng dẫn cài đặt Observables trong Knockout js Giới thiệu chung Knockout(KO) là một thư viện của Javascript, nó giúp bạn tạo, hiển thị hay hiệu chỉnh User Interface(UI) với một data model được định nghĩa sẵn. Bất cứ khi nào bạn có phần ...

Bùi Văn Nam viết 22:57 ngày 11/08/2018
0