Zend Framework(ZF1)的自動載入器是框架啟動的核心組件,採用 PSR-0 風格的命名空間對應規則。正確配置自動載入能避免大量 `require_once`,提升開發效能與程式碼可維護性。本文詳細解析模組級與全域自動載入的配置差異與最佳實踐。
ZF1 自動載入器遵循:類別名稱 中的底線 `_` 對應目錄分隔符,命名空間前綴對應基礎路徑。
Application_Model_User → application/models/User.php
Blog_Controller_Index → modules/blog/controllers/IndexController.php
每個模組擁有獨立命名空間與基礎路徑,互不干擾,符合模組化架構。
<?php
// 在 Module.php 或 Bootstrap 中
$loader = new Zend_Application_Module_Autoloader([
'namespace' => 'Blog', // 命名空間前綴:Blog_
'basePath' => APPLICATION_PATH . '/modules/blog' // 模組根目錄
]);
對應目錄結構:
modules/blog/
├── controllers/
├── models/
├── forms/
├── views/
└── Bootstrap.php
此載入器會自動註冊標準資源類型(models、forms、controllers 等),無需手動配置。
用於跨模組共用的類別(如 `Application_*`、`Library_*`)。
<?php
// public/index.php 或 Bootstrap::_initAutoload()
require_once 'Zend/Loader/Autoloader.php';
$loader = Zend_Loader_Autoloader::getInstance();
// 註冊應用命名空間
$loader->registerNamespace('Application_'); // 單一
$loader->registerNamespace(['Foo_', 'Bar_']); // 多個
// 確保 include_path 包含 library 與自訂目錄
set_include_path(implode(PATH_SEPARATOR, [
realpath(APPLICATION_PATH . '/../library'),
realpath(APPLICATION_PATH . '/forms/'),
get_include_path(),
]));
注意: `setFallbackAutoloader(true)` 會載入所有找到的類別(無需命名空間),極大增加效能開銷且易發生衝突,生產環境嚴禁啟用。
若模組有非標準目錄(如 `services/`, `entities/`),可擴充 `Zend_Application_Module_Autoloader`:
class My_Module_Autoloader extends Zend_Application_Module_Autoloader {
public function __construct($options) {
parent::__construct($options);
$this->addResourceType('service', 'services', 'Service')
->addResourceType('entity', 'entities', 'Entity');
}
}
| 現象 | 原因 | 解決 |
|---|---|---|
| Class 'Application_Model_X' not found | include_path 缺少 library 路徑 | 檢查 set_include_path() 順序與 realpath() |
| 模組類別互相污染 | 命名空間前綴衝突 | 每模組獨一前綴(如 Blog_, Admin_) |
| 生產環境效能差 | 未啟用類別對應快取 | 部署時執行 `php -r "require 'Zend/Loader/Autoloader.php'; Zend_Loader_Autoloader::getInstance()->setClassMap(require 'classmap.php');"` |
<?php
// 建立 classmap.php(部署腳本執行)
$map = [];
$iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator(APPLICATION_PATH));
foreach ($iterator as $file) {
if ($file->isFile() && $file->getExtension() === 'php') {
$content = file_get_contents($file->getPathname());
if (preg_match('/^class\s+([A-Z_a-z0-9_]+)/m', $content, $m)) {
$map[$m[1]] = $file->getPathname();
}
}
}
file_put_contents(APPLICATION_PATH . '/../data/classmap.php', '
啟動時載入:`$loader->setClassMap(require 'data/classmap.php');`,避免檔案系統掃描,大幅提升啟動速度。
掌握 ZF1 自動載入的命名空間對應規則與模組化配置,能讓專案結構清晰、載入高效、擴充容易。