The symfony and Doctrine book

Attribute

Doctrine được cấu hình thông qua attribute. Các attribute có thể được thiết lập ở các mức khác nhau và thừa kế lẫn nhau. Một số attribute có thể được thiết lập ở tất cả các mức, một số thì không. Dưới đây miêu tả cách thiết lập các attribute ở mỗi mức. Attribute có thể xác định ở toàn cục, cho từng connection, hay mỗi model riêng biệt.

Trong symfony, cấu hình Doctrine được lưu ở config/ProjectConfiguration.class.php hoặc apps/appname/config/appnameConfiguration.class.php

Toàn cục

Bạn có thể thiết lập global attribute bằng cách tạo phương thức configureDoctrine() trong file cấu hình. Tất cả các global attribute được thiết lập với singleton instance của Doctrine_Manager . Phương thức này được gọi khi sfDoctrinePlugin config.php được load. Ở thời điểm này chưa có bất kì kết nối nào tồn tại, do đó attribute được quản lý bởi Doctrine_Manager.

public function configureDoctrine(Doctrine_Manager $manager)
{
  $manager->setAttribute('use_dql_callbacks', true);
  $manager->setAttribute('use_native_enum', true);
}

Tất cả kết nối

Bạn có thể quản lý các attribute của từng kết nối bằng cách tạo phương thức configureDoctrineConnection() trong lớp cấu hình. Phương thức này được gọi trong sfDoctrineDatabase khi mỗi kết nối được symfony tạo theo thứ tự trong file config/databases.yml.

public function configureDoctrineConnection(Doctrine_Connection $connection)
{
  $connection->setAttribute('use_dql_callbacks', true);
  $connection->setAttribute('use_native_enum', true);
}

Bạn có thể xác định các attribute cho kết nối trực tiếp trong file cấu hình config/doctrine/databases.yml:

doctrine:
   class: sfDoctrineDatabase
   param:
     dsn: 'mysql:host=localhost;dbname=dbname'
     username: user
     password: secret
     attributes:
       use_dql_callbacks: true
       use_native_enum:  true

Bạn cũng có thể cấu hình khác nhau cho mỗi kết nối bằng cách tạo một phương thức ứng với mỗi kết nối. Nếu bạn có một kết nối tên master thì bạn cần tạo một function tên configureDoctrineConnectionMaster() trong file config/ProjectConfiguration.class.php.

public function configureDoctrineConnectionMaster(Doctrine_Connection $connection)
{
  $connection->setAttribute('use_dql_callbacks', false);
  $connection->setAttribute('use_native_enum', false);
}

Trong ví dụ trên chúng ta đã thiết lập use_dql_callbacks và use_native_enum cho tất cả các kết nối ngoại trừ kết nối có tên master.

Model

Mức cấu hình cuối cùng của Doctrine là model. Attribute có thể được xác định trực tiếp trong file YAML mô tả model.

Store:
  connection: client
  attributes:
    export: tables
  columns:
    name: string(255)
    description: string(500)

Bạn cũng có thể thiết lập các attribute trong các lớp được tạo ra ở thư mục lib/model/doctrine. Mở file lib/model/doctrine/Store.class.php và override phương thức setTableDefinition() để thêm attribute.

public function setTableDefinition()
{
  parent::setTableDefinition();
  $this->setAttribute('export', 'tables');
}

Cấu hình quá trình tạo Model

sfDoctrinePlugin cung cấp khả năng override một số lựa chọn để tạo model. Những thiết lập này có thể điều khiển bằng lớp sfConfig sử dụng tham số doctrine_model_builder_options.

Dưới đây là ví dụ cách đổi tên lớp base khi tạo models. Bạn có thể thiết lập để đổi nó thành myDoctrineRecord hay bất cứ gì bạn muốn.

public function configureDoctrine(Doctrine_Manager $manager)
{
  $options = array('baseClassName' => 'myDoctrineRecord');
  sfConfig::set('doctrine_model_builder_options', $options);
}

Bạn cần tạo thêm một lớp, ở đây là sfproject/lib/myDoctrineRecord.class.php với đoạn code sau.

class myDoctrineRecord extends sfDoctrineRecord
{
}

Bây giờ hãy generate model, tất cả các lớp sẽ extend từ myDoctrineRecord thay vì sfDoctrineRecord, do đó bạn có thể thêm các chỉnh sửa cho tất cả các model của mình.

Dưới đây là danh sách tất cả các option bạn có thể thay đổi thành giá trị khác trong quá trình tạo model.

Chỉnh sửa đường dẫn tới thư viện Doctrine

Với sfDoctrinePlugin thật dễ dàng để thêm một phiên bản mới của Doctrine bằng thay đổi giá trị cấu hình.

Dưới đây là ví dụ về cách cấu hình sfDoctrinePlugin để sử dụng một phiên bản khác của Doctrine, ví dụ 1.1.

Đầu tiên chúng ta cần thêm phiên bản của Doctrine chúng ta muốn sử dụng vào thư mục lib/vendor/doctrine:

$ mkdir lib/vendor
$ cd lib/vendor
$ svn co http://svn.doctrine-project.org/branches/1.0.10/lib doctrine

Bây giờ chúng ta có thể cấu hình sfDoctrinePlugin để sử dụng phiên bản này thay vì phiên bản có sẵn trong plugin. Trong phương thức ProjectConfiguration::setup() bạn cần thay đổi giá trị của sfDoctrinePlugin_doctrine_lib_path như dưới đây:

public function setup()
{
  sfConfig::set('sfDoctrinePlugin_doctrine_lib_path', sfConfig::get('sf_lib_dir') . '/vendor/doctrine/Doctrine.php');
}

Bạn có thể tìm hiểu thêm về cấu hình ở Doctrine Manual.