MVC PHP - Viết thư viện load config - Học MVC PHP nâng cao
Chúng ta lại gặp nhau trong serie project MVC PHP nữa rồi. Trong bài này chúng ta sẽ tìm hiểu cách viết file cấu hình (config) cho module và các thao tác như lấy giá trị config, thiết lập thay đổi giá trị cho config. Config là file cấu hình cho module và đóng vai trò rất quan trọng, mỗi ...
Chúng ta lại gặp nhau trong serie project MVC PHP nữa rồi. Trong bài này chúng ta sẽ tìm hiểu cách viết file cấu hình (config) cho module và các thao tác như lấy giá trị config, thiết lập thay đổi giá trị cho config.
Config là file cấu hình cho module và đóng vai trò rất quan trọng, mỗi module thường sẽ có một file config.php và coder sẽ định nghĩa các thông số nằm trong đó.
1. Tạo file config.php cho module trong MVC
Bạn tạo một file config.php nằm trong thư mục admin/config như sau:
Giả sư ta có danh sách các cấu nằm trong file này như sau:
<?php if ( ! defined('PATH_SYSTEM')) die ('Bad requested!');
return array(
'csrf_token_name' => 'tokenname',
'base_url' => 'http://localhost/mvc'
);
Ok, vấn đề bây giờ là làm sao load các thông số này trong controller. Để làm được như vậy thì ta phải tạo thư viện Loader cho nó.
2. Tạo thư viện load config trong MVC
Bạn tạo một file FT_Config_Loader.php nằm trong thư mục system/core/loader như hình sau:
Bây giờ bạn copy nội dung sau vào file này:
<?php
/**
* @package FT_Framework
* @author Zaidap.com Dev Team
* @email Zaidap.com.net@gmail.com
* @copyright Copyright (c) 2015
* @since Version 1.0
* @filesource system/core/loader/FT_Config_Loader.php
*/
class FT_Config_Loader
{
// Danh sách config
protected $config = array();
/**
* Load helper
*
* @param string
* @desc hàm load helper, tham số truyền vào là tên của helper
*/
public function load($config)
{
if (file_exists(PATH_APPLICATION . '/config/' . $config . '.php')){
$config = include_once PATH_APPLICATION . '/config/' . $config . '.php';
if ( !empty($config) ){
foreach ($config as $key => $item){
$this->config[$key] = $item;
}
}
return true;
}
return FALSE;
}
/**
* Get item config
*
* @param string
* @param string
* @desc hàm get config item, tham số truyền vào là tên của item và tham số mặc định
*/
public function item($key, $defailt_val = '')
{
return isset($this->config[$key]) ? $this->config[$key] : $defailt_val;
}
/**
* Set item config
*
* @param string
* @param string
* @desc hàm set config item, tham số truyền vào là tên của item và giá trị của nó
*/
public function set_item($key, $val){
$this->config[$key] = $val;
}
}
Trong lớp này mình định nghĩa ba hàm chính là:
- hàm
load()dùng để load một file config nào đó - hàm
item()dùng để lấy một key config nào đó - hàm
set_item()dùng để thiết lập thay đổi giá trị của key config nào đó.
3. Tạo đối tượng load config trong FT_Controller
Bước cuối cùng này khá quan trọng. Bạn sẽ tạo một đối tượng load config ở hàm khởi tạo của controller chính (FT_Controller).
Bạn mở file system/core/FT_Controller.php lên tìm đến hàm khởi tạo __construct() và thêm một đoạn code sau:
public function __construct()
{
// Loader cho config
require_once PATH_SYSTEM . '/core/loader/FT_Config_Loader.php';
$this->config = new FT_Config_Loader();
$this->config->load('config');
}
Trong đoạn code này mình thực hiện 3 thao tác:
- include file loader
FT_Config_Loader.phpcủa config - khởi tạo mới đối tượng loader và lưu vào thuộc tính
configcủa controller - thực hiện load file
config.php.
Bạn vào controller New_Controller.php và giữ nguyên nội dung như bài trước đã làm:
<?php if ( ! defined('PATH_SYSTEM')) die ('Bad requested!');
class News_Controller extends FT_Controller
{
public function indexAction()
{
echo '<pre>';
print_r($this);
echo '<h1>Index Action</h1>';
}
}
Sau đó chạy lên với URL http://localhost/mvc/admin.php?c=news&a=index thì sẽ xuất hiện hình như sau:
Bạn thấy config đã xuất hiện trong instance của Controller và nó có hai key như trong hình vẽ.
4. Thao tác với thư viện config trong Controller
Bây giờ bạn chỉnh lại controller News_Controller.php với nội dung như sau:
<?php if ( ! defined('PATH_SYSTEM')) die ('Bad requested!');
class News_Controller extends FT_Controller
{
public function indexAction()
{
// Lấy config có key là csrf_token_name
echo '<h3>Token: csrf_token_name: ' . $this->config->item('csrf_token_name') . '</h3>';
// Thay đổi giá trị cho csrf_token_name
$this->config->set_item('csrf_token_name', 'new_token');
echo '<h3>Token: csrf_token_name (changed): ' . $this->config->item('csrf_token_name') . '</h3>';
// Tạo cấu hình mới tên website_name
$this->config->set_item('website_name', 'Zaidap.com.net');
echo '<h3>key website_name: ' . $this->config->item('website_name') . '</h3>';
}
}
Chạy controller này lên bạn sẽ thấy giao diện như sau:
Như vậy là bạn đã biết cách sử dụng thư viện này rồi phải không nào.
5. Lời kết
Phần cấu hình này ngoài file config.php ra bạn có thể tạo thêm một file bất kì và dùng hàm load() để thực hiện lấy nội dung của nó. Đây là một thư viện đóng vai trò cũng khá quan trọng bởi mỗi một module sẽ luôn có những thông số cấu hình riêng và điều này giúp việc quản lý code dễ dàng hơn.
Bạn cần chú ý một số cách sử dụng mà ở phần 4 mình đã thực hiện vì ở các bài sau mình không giải thích thêm về nó nữa. Chúc bạn học tốt.
