Yii 1.x 提供 Yii::$classMap 靜態屬性,允許開發者預先註冊「類名 → 文件路徑」映射,避免運行時通過 Yii::import() 或 require 動態查找,顯著提升大型項目啟動性能。
<?php
// 入口文件 index.php
require_once($yii);
$app = Yii::createWebApplication($config);
// 註冊類映射(建議在創建應用實例後、run() 前)
Yii::$classMap = [
'JPhpMailer' => Yii::getPathOfAlias('ext') . '/phpmailer/JPhpMailer.php',
'CustomLib' => Yii::getPathOfAlias('vendor.custom') . '/CustomLib.php',
];
$app->run();
// 業務代碼中直接實例化,無需 import
$mailer = new JPhpMailer();
$lib = new CustomLib();
手動維護映射表繁瑣且易出錯,可編寫腳本掃描目錄自動生成:
<?php
// scripts/build_classmap.php
$scanDirs = [
Yii::getPathOfAlias('ext'),
Yii::getPathOfAlias('vendor.custom'),
];
$map = [];
foreach ($scanDirs as $dir) {
$iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($dir));
foreach ($iterator as $file) {
if ($file->isFile() && $file->getExtension() === 'php') {
// 簡單約定:文件名 = 類名.php
$className = $file->getBasename('.php');
$map[$className] = $file->getPathname();
}
}
}
// 輸出為 PHP 文件,入口直接 require
file_put_contents(
Yii::getPathOfAlias('runtime') . '/classmap.php',
'
入口文件:
Yii::$classMap = require(Yii::getPathOfAlias('runtime') . '/classmap.php');
YiiBase::autoload() 會優先檢查 self::$classMap[$className],命中則直接 include,跳過別名解析、路徑拼接、文件存在性檢查等開銷。Vendor_Lib)。post-autoload-dump 鉤子。合理使用 Yii::$classMap 是 Yii 1.x 專案性能優化的「低成本、高收益」手段。配合自動生成腳本,可在保持代碼整潔的同時獲得接近原生 require 的加載速度。