如何在一个 Composer 项目中同时使用 PSR-0 和 PSR-4 自动加载？-composer-PHP中文网

如何在一个 Composer 项目中同时使用 PSR-0 和 PSR-4 自动加载？

冰火之心

发布： 2025-12-16 18:27:08

原创

718人浏览过

Composer支持PSR-0与PSR-4共存，需在composer.json的autoload中分别配置；PSR-4用于现代命名空间，PSR-0兼容旧式下划线类名，注意避免前缀重叠、路径正确并执行dump-autoload生效。

如何在一个 composer 项目中同时使用 psr-0 和 psr-4 自动加载？

Composer 支持在一个项目中混合使用 PSR-0 和 PSR-4 自动加载规则，只需在 composer.json 的 autoload 字段中分别配置即可。Composer 会按定义顺序尝试匹配类名，但要注意命名空间与路径的对应关系，避免冲突或漏加载。

在 composer.json 中并行配置 PSR-0 和 PSR-4

你可以在同一份 composer.json 文件中同时声明 psr-0 和 psr-4，它们互不干扰：

psr-4 用于现代命名空间结构（推荐主流代码使用）
psr-0 用于遗留库或需兼容老式类名（如 Zend_Controller_Action 这类下划线分隔风格）

示例配置：

{
  "autoload": {
    "psr-4": {
      "App\": "src/",
      "Vendor\Package\": "lib/vendor-package/src/"
    },
    "psr-0": {
      "Zend_": "library/Zend/",
      "Doctrine_": "library/Doctrine/"
    }
  }
}
</font>
<p>配置后运行 <code>composer dump-autoload</code> 生效。</p>

<H3>注意类名解析优先级和潜在冲突</H3>
<p>Composer 不强制执行“先 PSR-4 后 PSR-0”，而是对每个类尝试所有规则，直到找到匹配项。但实际行为是：</p>
<ul>
  <li>PSR-4 匹配更快（基于命名空间前缀 + 目录映射，无文件扫描）</li>
  <li>PSR-0 需要将下划线转为目录分隔符，并查找对应 <code>.php</code> 文件，可能触发更多 I/O</li>
  <li>如果一个类名同时满足 PSR-4 和 PSR-0 规则（例如 <code>App_Foo</code> 被映射到 <code>src/</code> 且 <code>App_</code> 又在 PSR-0 中定义），结果不确定——应避免这种重叠</li>
</ul>

<H3>处理混合风格的旧项目迁移场景</H3>
<p>当逐步将 PSR-0 代码迁向 PSR-4 时，可临时共存：</p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/1928">
                            <img src="https://img.php.cn/upload/ai_manual/001/246/273/68b6d56e1edcc642.png" alt="达芬奇">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/1928">达芬奇</a>
                            <p>达芬奇——你的AI创作大师</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="达芬奇">
                                <span>166</span>
                            </div>
                        </div>
                        <a href="/ai/1928" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="达芬奇">
                        </a>
                    </div>
                
<ul>
  <li>把新功能全用 PSR-4（如 <code>App\Http\Controller</code> → <code>src/Http/Controller</code>）</li>
  <li>保留老模块用 PSR-0（如 <code>Legacy_Module_User</code> → <code>legacy/Module/User.php</code>）</li>
  <li>在 <code>psr-0</code> 条目中可用数组值指定多个路径，支持多目录查找</li>
</ul>
<p>例如：</p>
<font color="#888">
<pre class="brush:php;toolbar:false;">
"psr-0": {
  "Legacy_": ["legacy/", "old-lib/"]
}

登录后复制