PHP 物件導向 (上)

魔術方法 (Magic Methods)

魔術方法是在類別中具有特殊名稱的方法，它們在特定的時機被自動呼叫，這些時機通常與類別的操作和生命週期相關。一個常用的魔術方法是建構子（Constructor）。

建構子 (Constructor)

建構子是一個特殊的方法，它在類別被實例化（物件被建立）時自動被呼叫。建構子通常用於初始化物件的屬性或進行一些初始設定。

class MyClass {
    public function __construct() {
        echo "物件已被建立！";
    }
}

$object = new MyClass(); // 輸出：物件已被建立！

Custom Methods

自訂方法是我們根據類別的需求自行定義的方法。其中的一個常見技巧是使用 return $this，這使得方法可以被鏈式呼叫（Method Chaining）。

鏈式呼叫(Method Chaining) 指在同一個物件上連續呼叫多個方法，而不需要每次呼叫都賦值給一個變數。

class Calculator {
    private $result = 0;

    public function add($value) {
        $this->result += $value;
        return $this; // 返回物件本身以便鏈式呼叫
    }

    public function subtract($value) {
        $this->result -= $value;
        return $this; // 返回物件本身
    }

    public function getResult() {
        return $this->result;
    }
}

$calculator = new Calculator();
$result = $calculator->add(10)->subtract(5)->getResult();
echo $result; // 輸出：5

在這個例子中，add 和 subtract 方法返回了物件本身 $this，這樣它們可以連續呼叫，而不需要每次呼叫都賦值給一個變數。

建構子引數的推廣 (Constructor Property Promotion)

在 PHP 8.0 及以上版本中，引入的新特性。

當使用建構子引數推廣之前，我們需要手動為每個類別的屬性指定建構子引數，然後在建構子中賦值。以下是一個使用前的範例：

class User {
    private string $name;
    private string $email;
    private ?string $phoneNumber;

    public function __construct(string $name, string $email, ?string $phoneNumber) {
        $this->name = $name;
        $this->email = $email;
        $this->phoneNumber = $phoneNumber;
    }
}

// 建立使用者物件
$user = new User('John Doe', 'john@example.com', '123-456-7890');

在上面的範例中，我們需要手動宣告建構子的引數，然後再將這些引數賦值給類別的屬性。

使用建構子引數推廣後的範例：

class User {
    public function __construct(
        private string $name,
        private string $email,
        private ?string $phoneNumber = null
    ) {
        // 建構子的內容
    }
}

// 建立使用者物件
$user = new User('John Doe', 'john@example.com', '123-456-7890');

在這個例子中，建構子的引數列表直接宣告瞭類別的屬性。$name 和 $email 屬性是必須的，而 $phoneNumber 屬性是可選的（使用 ?string 表示可以為空）。在建構子中，不需要再手動賦值給這些屬性，PHP 會自動處理。這樣，我們可以簡化建構子的定義，使程式碼更加簡潔和易讀。

存取修飾符 (Access Modifiers)

public（公共)

public 修飾符表示該成員(屬性或方法)在類別內外部均可被訪問。這意味著無論是在類別內部、子類別、還是外部程式碼中，都可以直接訪問這個成員，它是預設值。

class MyClass {
    public $publicProperty;

    public function publicMethod() {
        // 可以被任何地方訪問
    }
}

protected (受保護)

protected 修飾符表示該成員只能在定義它的類別內部和子類別中被訪問。外部程式碼無法直接訪問受保護的成員。

class MyClass {
    protected $protectedProperty;

    protected function protectedMethod() {
        // 只能在類別內部和子類別中訪問
    }
}

private（私有)

private 修飾符表示該成員指能在定義它的類別內部被訪問，對於外部程式碼和子類別都是不可見的。

class MyClass {
    private $privateProperty;

    private function privateMethod() {
        // 只能在類別內部訪問
    }
}

Null-Safe Operator

在 PHP 8.0 版本中，引入了 Null-Safe Operator（空安全運算子），也稱為 Null-Safe Operator（?->），它是一種簡化程式碼的語法糖，用於在操作可能為 null 的物件時避免產生錯誤。

在舊版本的 PHP 中，如果你試圖在一個可能為 null 的變數上呼叫方法或訪問屬性，你必須先檢查該變數是否為 null，以避免產生 Fatal Error。例如：

if (isset($object)) {
    $value = $object->getValue();
} else {
    $value = null;
}

使用 Null-Safe Operator，你可以將上面的程式碼簡化為：

$value = $object?->getValue();

這樣，如果$object為 null，表示式的結果將會是 null，而不會丟擲錯誤。Null-Safe Operator 只能用於物件的方法呼叫和屬性訪問，不能用於陣列和函式呼叫。這個語法糖使得處理可能為 null 的物件更加方便和簡潔。

這裡是一個使用 Null-Safe Operator 的例子：

class MyClass {
    public function getValue(): ?string {
        // 返回一個可能為null的值
        return "Hello, World!";
    }
}

$object = null; // 或者一個MyClass的實例

// 使用Null-Safe Operator呼叫可能為null的物件方法
$value = $object?->getValue();

echo $value; // 輸出 "Hello, World!" 或者 null（如果$object為null的話）

在這個例子中，無論$object是一個 MyClass 的實例還是 null，都不會產生錯誤，因為 Null-Safe Operator 會自動處理 null 情況。

Namespace

在 PHP 中，名稱空間（Namespace）是一種用來解決在不同類別之間命名衝突的機制。名稱空間可以是可選的，但在大型應用程式中，良好的組織和結構是非常重要的。以下是有關 PHP 名稱空間的一些基本概念和最佳實踐：

在程式檔案的最前面，你可以使用namespace宣告定義一個名稱空間。例如：

declare(strict_types=1);
namespace APP; // after strict_types

class MyClass {
    // class implementation
}

如果你的應用程式需要更深的組織結構，你可以使用巢狀名稱空間（Nested Namespace）。例如，如果你有一個銀行相關的類別，你可以這樣定義：

namespace APP\Bank;

class BankAccount {
    // class implementation
}

當你在不同的名稱空間中使用類別時，你可以使用use關鍵字。例如，如果你要使用APP名稱空間中的Account類別，你可以這樣做：

# method1
$myAccount = new App\Account();

# method2
use APP\Account;

$myAccount = new Account();

在某些情況下(當前在 namespace APP 下)，你可能需要使用 global namespace 中的類別。你可以使用斜線（\）字首來表示全域性名稱空間。例如：

namespace App;

# method1
new \DateTime();

# method2
use DateTime;
new DateTime();

有時候，你可能會想要為一個長命名的類別使用別名（Alias）。這樣可以使你的程式碼更簡潔易讀。例如：

use DateTime as DT;

new DT();

如果你需要引入多個名稱空間中的類別，你可以使用逗號（,）分隔它們。例如：

use APP\Account;
use APP\SocialMedia;

// 改寫
use APP\{Account, SocialMedia};

使用名稱空間和use語句，讓你可以更好地組織你的程式碼，避免命名衝突，使程式碼更易於維護和擴充套件。

Autoloading Classes

使用自動載入機制（例如 spl_autoload_register 函式）主要是為了方便管理多個類別，特別是當每個類別都儲存在獨立的檔案中時。這樣，你可以根據類別的名稱空間和類別名稱來自動載入相應的檔案。

然而，如果在同一個檔案中既有類別定義又有函式定義，那麼最好還是在需要的時候手動引入這些檔案。這是因為自動載入機制主要是為了類別而設計的，而不是用來處理函式。如果在自動載入的過程中引入了一個檔案，裡面除了類別定義還包含其他程式碼（如函式定義），可能會導致不必要的程式碼複雜性和不易讀懂的程式碼。

因此，最佳的做法是：

將每個類別儲存在獨立的檔案中。 這樣可以使用自動載入機制，方便地根據類別的名稱空間和類別名稱來自動載入相應的檔案。
如果檔案中既有類別定義又有函式定義，需要時手動引入。 如果檔案中有其他不屬於類別的程式碼（例如函式或常數），最好在需要使用這些程式碼的地方手動引入相應的檔案。這樣可以確保程式碼的可讀性和可維護性。

以下是一個範例，演示瞭如何使用自動載入機制來載入類別，並在需要的時候手動引入檔案中的函式：

// require_once 'APP/Account.php';
// require_once 'APP/SocialMedia.php';
// require_once 'APP/..';

spl_autoload_register(function($class){
    $formattedClass = str_replace("\\", "/", $class);
    $path = "{$formattedClass}.php";
    require_once $path;
});

// 使用自動載入機制載入類別
$account = new \APP\Account();

// 手動引入檔案中的函式
require_once 'path/to/file-with-functions.php';

// 現在你可以使用檔案中定義的函式
myFunction();

常數 (Constants)

在 PHP 中，常數是在類別中定義的不可改變的值，這些值在整個類別中都是固定的。在類別中定義常數使用 const 關鍵字，不可使用 define() 函式。

class Account {
    const INTEREST_RATE = 0.05;

    // 其他類別成員和方法
}

// 存取常數的方式
echo Account::INTEREST_RATE;

在這個範例中，INTEREST_RATE 是 Account 類別的常數，它的值不可更改，可以在整個應用程式中使用，提高了程式碼的可讀性和一致性。

靜態成員 (Static Members)

靜態屬性 (Static Properties)

靜態屬性是指在整個類別中共用的屬性，可以被所有實例共享。然而，靜態屬性的值可以被修改，因此在使用時需要小心 (能不要用就不要用)。

class Account {
    public static $count = 0;

    public function __construct() {
        self::$count++;
    }

    public static function getCount() {
        return self::$count;
    }
}

// 使用靜態屬性
$account1 = new Account();
$account2 = new Account();
echo Account::$count; // 輸出：2

在這個例子中，$count 是一個靜態屬性，用來記錄 Account 類別的實例數量。每次建立一個新的 Account 物件時，$count 的值會自動增加。

靜態方法 (Static Methods)

靜態方法是可以在不建立類別實例的情況下直接呼叫的方法。靜態方法通常用於 utility 類別，這些方法不依賴於特定的實例，而是執行通用的任務。這搭配上前面提到的 Autoloading Class 方法時會相當方便。

class Utility {
    public static function calculateArea($radius) {
        return pi() * $radius * $radius;
    }
}

// 呼叫靜態方法
$area = Utility::calculateArea(5); // 計算半徑為5的圓面積

在這個例子中，calculateArea 是一個靜態方法，可以直接透過 Utility::calculateArea() 的方式呼叫，而不需要建立 Utility 物件。

魔術方法 (Magic Methods)#

建構子 (Constructor)#

Custom Methods#

建構子引數的推廣 (Constructor Property Promotion)#

存取修飾符 (Access Modifiers)#

public（公共)#

protected (受保護)#

private（私有)#

Null-Safe Operator#

Namespace#

Autoloading Classes#

常數 (Constants)#

靜態成員 (Static Members)#

靜態屬性 (Static Properties)#

靜態方法 (Static Methods)#