[精讚] [會員登入]
198

[PHP8] 使用autoload autoload+ namespace +use

到了php7之後,namespace和use越來越重要,此篇整理autoload和namespace、use的結合使用。

分享此文連結 //n.sfs.tw/16033

分享連結 [PHP8] 使用autoload autoload+ namespace +use@新精讚
(文章歡迎轉載,務必尊重版權註明連結來源)
2022-12-30 12:30:48 最後編修
2022-12-29 16:01:47 By 張○○
 

自動目錄

我覺得php7之後的php應該就是namespace的世界。

此篇簡單整理autoload和namespace的結合使用。

過去的做法

過去,我們主程式index.php載入類別時myclass.php,一般會寫成這樣:

index.php

<?php
@include_once( 'myclass.php');

最前面的@是忽略錯誤的符號。假加有很多的類別,且放在不同的目錄下,我們都要寫很多行並且加上目錄路徑,例如寫成這樣:

index.php

<?php
@include_once( 'myclass1.php');
@include_once( '/var/www/html/class/myclass2.php');  <== 絕對路徑表示法
@include_once( 'class/myclass3.php');  <== 使用相對路徑
@include_once( __DIR__ .'/myclass4.php');  <== 本目錄下的檔案

引入後 再new還是幹嘛的都可以。

這樣的做法對於要引入很多檔案的情況,會寫長長的一串,所以我們可以使用 php5開始提供的autoload 功能,在php8以前autoload的實作方式是在程式最開始加入一個__autoload()函數,並把autoload的規則寫在此函數裡,這個函數像是黑手一樣的存在,可以自動載入你叫用的類別。很可惜這個方法在php8之後就被廢棄並報錯:

Fatal error: __autoload() is no longer supported, use spl_autoload_register() instead in xxx

 

php8 之後的autoload

php8之後,可以採用 spl_ 相關的函數來實現autoload,並且能和 namespace 結合,spl是 Standard PHP Library 的縮寫,主要的函數只有一個

spl_autoload_register()

先看看檔案架構

.
├── module
│   └── shop
│       └── taipei.php
└── index.php

這裡只有兩個檔案,一個是索引用的 index.php 和類別檔 taipei.php

在傳統作法中,只要 include('module/shop/taipei.php) 然後就可以想幹嘛就幹嘛。

類別taipei沒做什麼,只有一個函數sell(),印出販賣的商品是蘋果:

taipei.php

<?php
namespace module\shop;

class taipei {
  public function sell(){
    return "蘋果";
  }
}

但是想用autoload方法來實作的話,程式寫成這樣就可以了:

index.php

<?php
spl_autoload_register();

$myshop = new module\shop\taipei;
print $myshop->sell(); //蘋果

可以看到不過加了第2行的函數spl_autoload_register(),什麼路徑都不必指定,也不用叫用 include什麼的,他自然而然的會去路徑 module/shop/ 中找到 taipei.php 的這個類別並載入。

這簡直太神奇?!

到底spl_autoload_register()做了什麼事才會這麼神奇?

眼尖的人可能有發現,index.php第4行中的new 後面指定了namespace,namespace在此發揮了巨大的作用。

我們能猜測他內部是把namespace轉成路徑,並區分最後一個部分當成類別名。

同時要注意,類別中的namespace宣告要和初始化的一致(taipei.php第2行),這樣就漂亮的整合了namespace和autoload

 

自定義的autoload

如果上面預設的autoload規則不符合需求的話,只能自己來訂定,以下範例檔案架構變成這樣,我們增加一個system的目錄,假設裡面會放一些和公司本身規定有關的程式碼。

.
├── module
│   └── shop
│       └── taipei.php
├── index.php
├── autoload.php
└── system
    └── promote
        └── year2023.php

這裡多了一個類別 year2023.php,以及後面才會加入的autotload.php

我們可以用上面的做法,直接初始化

$activity = new system\promote\year2023;

就能自動載入該類別。

但如果 promote/ 目錄下的活動很多,我們想全部都編成core這個namespace的話,就要改一下autoload的規則。先看程式碼:

year2023.php

<?php
namespace core ;

class year2023 {
  public function anniversary(){
    return "3/31-4/5";
  } 
} 

注意上面第2行的namespace改成core。

index.php

<?php 
spl_autoload_register(
  function ($myclass){
    $segment= explode("\\",$myclass,2);
    if( $segment[0]==="core"){
      @include_once(__DIR__ . '/system/promote/' . str_replace('\\', '/', $segment[1]). '.php');
    }else 
      @include_once(__DIR__ . '/' . str_replace('\\', '/', $myclass) . '.php');
  });
$activity= new core\year2023;
print $activity->anniversary();  //3/31-4/5

上面在 spl_autoload_register()中放入了一個函數,第3行$myclass就是所有被叫用的namespace+類別。

第4行把字串$myclass拆開分成2段,第一個字節和剩下的其它部分。

第5-6行 namespace的第一個字節如果是core開頭的,就去/system/promote/裡面找類別

第7-8行 除此之外就是和原本的autoload一樣。

接下來第9行引用時,namespace直接可以用core來引用,假如這行寫成

$activity= new system\promote\year2023;

可不可以?當然不行,因為一個類別只能有一個namespace。

我們可以把自定義的部分拆出來,新增一個autoload.php程式,爾後所有的程式都可以叫用同樣的規則。

autoload.php

<?php
    spl_autoload_register(
        function ($myclass){
            $segment= explode("\\",$myclass,2);
            if( $segment[0]==="core"){
    @include_once(__DIR__ . '/system/promote/' . str_replace('\\', '/', $segment[1]). '.php');
            }else
    @include_once(__DIR__ . '/' . str_replace('\\', '/', $myclass) . '.php');
        });

index.php

<?php
include_once(__DIR__ ."/autoload.php");

$activity= new core\year2023;
print $activity->anniversary(); //3/31-4/5

 

use? 怎麼use?

如果你討厭每個函數之前都要帶著長長的namespace,你可以使用use

index.php

<?php
include_once(__DIR__ ."/autoload.php");

use module\shop\taipei;
use core\year2023;

$myshop = new taipei;
print $myshop->sell(); //蘋果

$activity= new year2023;
print $activity->anniversary(); //3/31-4/5

第4-5指定了use,在第7和第10行就不必帶上namespace了。

這部分可參考2016末寫的文章[PHP] 命名空間 namespace及 use@新精讚至今剛好滿6年。

 

結論

1. namespace+ autoload是好兄弟,php8以上請採用這種寫法。

2. __autoload 方法已經在php8作廢。

3. 目錄不要使用php的關鍵字來取名,例如你不要把目錄叫作class或是use

4. 自訂義的autoload很方便。

 

參考資料

[1] https://justericgg.logdown.com/posts/196891-php-series-autoload

[2] https://ithelp.ithome.com.tw/articles/10134247

 

END

你可能感興趣的文章

使用strcmp來判斷日期是否介於某日期之間 要比較現在日期是否在兩個日期之間,使用字串比對的方法

[PHP] 陣列新增資料及整理 在php陣列加入項目和重新整理陣列的方法

[PHP8] 使用autoload autoload+ namespace +use 到了php7之後,namespace和use越來越重要,此篇整理autoload和namespace、use的結合使用。

[PHP] 判斷文字、數字、文字加數字的方法 幾個PHP數字和文字操作上的小眉角:判斷文字、數字、文字加數字的方法

Smarty安裝 smarty 是著名的樣版引擎,非常的好用,用多了突然發現拿掉smarty反而不會寫php了,以下是安裝過程..

PHP判斷對方瀏覽器語系 多語系的網頁應該主動偵查瀏覽器的語系,配合使用者跳出合適的語系。

我有話要說

>>

限制:留言最高字數1000字。 限制:未登入訪客,每則留言間隔需超過10分鐘,每日最多5則留言。

訪客留言

[無留言]

隨機好文

為什麼要重造輪子? 什麼輪子?造什麼輪子?我為什麼要重造輪子?

[bc] linux 的計算機 bc 設定小數位數、計算π、次方根 linux 的計算機 bc 設定小數位數、計算π、次方根

TFTP Server 安裝及使用 讓設備的網路設定檔或是韌體經由TFTP拷備出來,操作的方法

世紀帝國征服者新版本--被遺忘的帝國 世紀帝國征服者新版本--被遺忘的帝國 世紀二代的征服者是精典遊戲中的精典,aofe更好玩...

[AS3] 我做的唯一一個Flash As3遊戲UFO INVADSION [AS3] 我做的唯一一個Flash As3遊戲,是第一個也是最後一個,後來就沒再寫as3,不過as3還滿好玩的。