1. 程式人生 > >PHP 多參數方法的重構

PHP 多參數方法的重構

方式 重構 src 模擬 merge 微信 fault 列表 options

假設我們要完成一個保存文章的功能,如果采用函數編程的方式,大概會是下面這個樣子:

<?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) { // ... } } ?>

如上所示,一旦我們把limitoffsetorder等參數轉換為對象的屬性,這個對象本身就變得不倫不類了,因為雖然title,content,categoryId可以算作是對象的內在屬性,而limitoffsetorder卻不是,頂多也只能算作是外部特征,不加區分的結果基本是噩夢的開始。所以,還是老老實實的把外在特征放到方法的參數裏好些(更嚴格的說,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 多參數方法的重構