PHP 多參數方法的重構
假設我們要完成一個保存文章的功能,如果采用函數編程的方式,大概會是下面這個樣子:
<?php function saveArticle($title, $content, $categoryId) { // ... } ?>
每個參數代表一個屬性,但帶來一個問題,參數列表會變得很長。此時采用對象編程的技術會是個好方法:
<?php class Article { var $title; var $content; var $categoryId; function save() { // ... } }?>
在這裏,原來的方法參數都轉換為以對象的屬性方式存在,從而大大降低了方法的參數數量。多數時候這個方法是不錯的,不過並不是所有的參數都適合以對象屬性的方式存在,區分的原則是,看這些參數是屬於對象的內在屬性還是外在特征,如果不加區分的統統轉換為對象屬性,這會讓對象本身失去意義。
舉個例子,比如說我們的Article
對象還有一個名為find
的方法,使用它時可能會涉及limit
, offset
, order
等參數:
<?php class Article { var $title; var $content; var $categoryId; var$limit = 10; var $offset = 0; var $order = ‘created DESC‘; function save() { // ... } function find($categoryId) { // ... } } ?>
如上所示,一旦我們把limit
,offset
,order
等參數轉換為對象的屬性,這個對象本身就變得不倫不類了,因為雖然title,content,categoryId可以算作是對象的內在屬性,而limit
,offset
,order
卻不是,頂多也只能算作是外部特征,不加區分的結果基本是噩夢的開始。所以,還是老老實實的把外在特征放到方法的參數裏好些(更嚴格的說,find
static
類型的方法,不過文本就是一個簡單的說明,不必細究):
<?php class Article { var $title; var $content; var $categoryId; function save() { // ... } function find($categoryId, $limit = 10, $offset = 0, $order = ‘created DESC‘) { // ... } } ?>
可惜如此一來又出現了文章開頭所說的問題,find
方法的參數太多了,缺乏可讀性,所以還得重構:
<?php class Article { var $title; var $content; var $categoryId; function save() { // ... } function find($categoryId, $options = array()) { $default = array( ‘limit‘ => 10, ‘offset‘ => 0, ‘order‘ => ‘created DESC‘ ); $options = array_merge($default, (array)$options); // ... } } ?>
看上去還不錯,調用時可以使用類似下面的方法:
$article->find(123, array(‘limit‘ => 20));
簡單的說,就是用數組方式的參數,來模擬一種類似關鍵字參數的效果,采用這種方式的話,可以通過數組的鍵名來描述參數的作用,從而增加代碼的可讀性。類似這樣的重構方法在CakePHP等項目裏被大量使用,仔細體會,以後再寫代碼的時候就可以本能的寫出高可讀性的代碼來。
補充:相對array_merge
來說,使用$options += $default;
也是不錯的選擇。另外,如果options的邏輯很復雜的話,也可以不用數組的方式,轉而使用一個專門的對象來封裝邏輯操作。
文章轉自:https://www.awaimai.com/869.html
關註微信公眾號:lovephp
PHP 多參數方法的重構