上次的說明了PHP套件管理的歷史與社群提出的解決之道,本篇文章接著談類別管理的進階議題。
當專案大了起來,有時候會有類別名稱重複的問題。
假設今天要撰寫一個論壇模組,提供討論區與留言板功能。
你一定很想將討論區的文章與留言板的文章都命名類別為Article:
// BoardArticle.php
<?php
class Article{
//...
}
?>
// ForumArticle.php
<?php
class Article{
//...
}
?>
當然了,這麼做會得到一個結果:
Fatal error: Cannot redeclare class Article
這種問題有一個簡單的解決辦法,就是加上前綴字。
類別分別命名為ForumArticle與BoardArticle就可以了。
Q1: 等一下!這個解法好陽春!我看到至少4個問題:
class TonyBoardArticle{
//...
}
class JackBoardArticle{
//...
}
看看 Codeigniter 的原始碼,全部用CI_當作前綴。超醜的。
於是PHP從5.3版之後支援了命名空間(namespace)。
所以可以用Article替類別定義了:
// BoardArticle.php
<?php
namespace Board;
class Article{
//...
}
?>
// ForumArticle.php
<?php
namespace Forum;
class Article{
//...
}
?>
使用類別時只要加上命名空間即可:
//index.php
<?php
include 'BoardArticle.php';
include 'ForumArticle.php';
$article = new Forum\Article();
$post = new Board\Article();
如果當前的php檔只用到其中一個Article類別,可以指定當前的php檔只用哪個命名空間+類別的組合:
<?php
include 'BoardArticle.php';
include 'ForumArticle.php';
use Forum\Article;
$article = new Article();
$fArticle = new Forum\Article();
$bArticle = new Board\Article();
如此一來,當php找不到Article類別時,便會去使用use關鍵字宣告的組合。
當然了,就算用use指定過,原本的宣告方式還是可以用的。(如最下方兩行所示)
OK,可以繼續完成我們的論壇模組了!
討論區跟留言板有各自的文章,再來還需要「推文」:
<?php
namespace Board;
class Comment{
// ...
}
?>
<?php
namespace Forum;
class Comment{
// ...
}
?>
使用剛剛學到的命名空間去載入他們:
<?php
// index.php
include 'BoardArticle.php';
include 'ForumArticle.php';
include 'BoardComment.php';
include 'ForumComment.php';
$article = new Forum\Article();
$comment = new Forum\Comment();
// ...
果然是漂亮的各種命名阿!
Q2: include有好多行!上次提到了Composer可以解決這種問題,當引入命名空間之後,Composer也能發揮作用嗎?
是的。
跟上次初學Composer一樣,建立一個composer.json檔:
{
"autoload": {
"files": [
"ForumArticle.php",
"ForumComment.php",
"BoardArticle.php",
"BoardComment.php"
]
}
}
注意,上次我們用"classmap"指定資料夾、把資料夾內檔案全掃一次,這次我們用"files"分別設定各個檔案。
再來,在terminal輸入
composer install
執行完畢之後,跟上次一樣,只要載入一個檔案:
<?php
require 'vendor/autoload.php';
$article = new Forum\Article();
$comment = new Forum\Comment();
就可以使用各個類別囉!
Q3: 等一下!看起來跟沒有命名空間的時候差不多啊!一樣是把php檔自動require進去而已?
對啊,你最上面的原始寫法,也只是手動載入好幾個檔案,在載入的時候本來就沒有特別之處:
<?php
// index.php
include 'BoardArticle.php';
include 'ForumArticle.php';
include 'BoardComment.php';
include 'ForumComment.php';
$article = new Forum\Article();
$comment = new Forum\Comment();
// ...
載入php檔就只是載入,跟命名空間是兩回事。
Q4: 還是不太對啊!上次我用classmap一次把好幾個資料夾內容掃過,這次我用files分別指定每個檔案幹嘛?Composer不是厲害在能指定資料夾去自動掃過?
......你說的沒錯。
開個my_lib資料夾,把4個php檔都丟進去吧。composer.json這樣寫就好了:
{
"autoload": {
"classmap": [
"my_lib"
]
}
}
再來,在terminal輸入
composer install
這樣就搞定了!
其實我只是想示範,除了用classmap設定資料夾之外,也可以用files直接指定檔案。
Q5: OK,原諒你。不過,我必須說,我今天什麼都沒學到。最後還是在composer.json寫classmap而已,跟上次一模一樣。
是的...我剛說了,載入php檔就只是載入,跟命名空間是兩回事。
我今天介紹的namespace功能是PHP本身提供的。而Composer只是協助你載入的工具、當然不可能改變程式語言本身。
Composer只是幫助你少打那一串require而已。
Q6: ㄟ等等...有個地方我覺得很醜。我們現在的my_lib資料夾裏面有4個檔案,檔名很醜:
"ForumArticle.php"
"ForumComment.php"
"BoardArticle.php"
"BoardComment.php"
類別名稱本身都是俐落的Article跟Comment了,檔案名稱還是有前綴字。但也不可能有兩個Article.php、兩個Comment.php。你有沒有辦法解決這個美感問題?
這個問題簡單,把那個my_lib資料夾刪掉,開一個Forum資料夾、一個Board資料夾。本來的ForumArticle.php改成Article.php丟進Forum資料夾、本來的BoardArticle.php改成Article.php丟進Board資料夾。composer.json改寫成這樣:
{
"autoload": {
"classmap": [
"Board",
"Forum"
]
}
}
再來,在terminal輸入
composer install
這招不錯吧!檔案名稱就是類別名稱,乾淨俐落!
而且資料夾的名字本身就是namespace的名稱!
以後都這樣做啦!一用到命名空間就開個同名資料夾把檔案丟進去!
Q7: 這招我覺得還好耶...。本來檔案都放在my_lib,我在composer.json只要填my_lib一行就好,現在變成要填兩行。要是我這個論壇模組有一大堆類別、用了一大堆命名空間呢?那我classmap底下不就要填入好幾行?那我寧可全部丟進my_lib,只填my_lib一行!
唔,這樣說也是有道理。那重新建立my_lib資料夾,把Board跟Forum資料夾丟進my_lib資料夾。
composer.json改回這樣寫:
{
"autoload": {
"classmap": [
"my_lib"
]
}
}
再來,在terminal輸入
composer install
classmap不只是告訴Composer去載入哪幾個資料夾內的檔案,還會把資料夾內的資料夾也全部掃過一次。
怎麼樣,Composer夠神吧。
Q8: 原來classmap底下會遞迴掃描下去...。我決定了,我的Forum跟Board都是在提供線上討論功能,我決定替我這個模組命名為Discussion。我要在my_lib底下開Discussion資料夾,然後把原本的Forum跟Board資料夾都丟進去。你覺得這個想法如何?
還不錯。一個Discussion資料夾就是你的整個Discussion模組。
提供了討論區、留言板功能的Discussion模組,我喜歡。
Q9: 好像忘了什麼...。啊,剛剛說命名空間跟檔案結構符合會最漂亮。那我要把那4個檔案的namespace改成這樣:
<?php
namespace Dicussion/Forum;
class Article{
//...
}
剛剛說了,載入檔案就只是載入檔案,跟命名空間無關。
現在檔案結構沒變,所以我應該不用重新輸入composer install。
讓我試試...。
靠!怎麼噴error了!你騙我?
Fatal error: Class 'Discussion\Forum\Comment' not found
呃...,我前面的說法確實有點誤導。
PHP自動載入的基本函式長這樣:
void __autoload ( string $class )
如你所見,PHP至少需要Composer提供資訊指出$class該去哪個檔案找。
namespace改變之後,PHP會找不到對應的$class在哪。
所以還是輸入一下composer install吧!Composer會把需要的資訊整理好的。
Q10: OKOK,我知道了,我駕馭這一切了。我覺得這個Dicsussion模組真的超屌的,不但命名空間漂亮,連檔案結構都漂亮。我要把這個Discussion資料夾整個丟給我朋友,他們公司最近需要論壇模組。
讓我打電話給他...。
「什麼?你們已經做好半個論壇模組了?你只需要我模組的其中幾個功能?你們的模組也是放在Discussion資料夾?」
糟糕,資料夾名稱重複了!所以我的模組拿給別人還是有不相容的可能,怎麼辦?
沒有錯..還記得你Q1提到的第3個狀況嗎?確實有把作者名稱加進去的必要!
別怕,我教你。你開一個Tony資料夾,把整個Discussion資料夾丟進去。
接著所有檔案namespace改成像這樣:
<?php
namespace Tony/Dicussion/Forum;
class Article{
//...
}
要用的時候就這樣喔:
<?php
require 'vendor/autoload.php';
$article = new Tony\Discussion\Forum\Article();
$comment = new Tony\Discussion\Forum\Comment();
是變得有點長啦。
但這下搞定了吧!作者名稱再撞到的話,就改個獨特的名稱就是了!
你一定常聽到PSR-0對吧!
PSR-0是PHP跨框架相容性統一標準組織訂出來的自動載入慣例。
來談談PSR-0幾個最重要的要求吧!
{vendor name}\{namespace}\{class name}
發現了嗎?在剛剛Q1~Q10的過程中,其實你已經把PSR-0學完了,連設計原理都一起搞懂了。
懂這些之後,你也可以做好自己的模組、發佈到 Packagist 給全世界透過composer下載、使用了!
最後,如果遵守psr-0的話,composer.json可以這樣寫:
{
"autoload": {
"psr-0": {
"Tony\\Discussion\\": "my_lib/"
}
}
}
注意,雙引號、兩次反斜線並沒有特別意思,只是 json 規定的格式。
跟classmap一樣都可以完成任務。兩者其實是有差別的...,我們下次再談。
Composer工具以及PHP-FIG組織的出現,讓一直以來散落各地的PHP社群開始有集中的趨勢。
換句話說,各社群終於能共享彼此的library了。
然而,如你所見,psr-0不但導致檔案結構容易變得深層,還要求檔案結構必須配合程式碼,這也招致了不少批評。
https://r.je/php-psr-0-pretty-shortsighted-really.html
除此之外,composer autoload內的classmap跟psr-0到底如何分工?效能差異又為何?這些問題也都還在爭論與驗證當中。
不過,PSR-0在各框架已被廣泛支援,因此建議你還是需要有所瞭解。
現在已經出現psr-0的替代方案,稱為psr-4。
PSR-0從2014-10-21開始被註明為不建議使用。
至於PSR-4..我們下次再談。