php 8.6项目可在composer.json中设置psr-4命名空间映射,再在部署阶段运行composer的优化自动加载命令。先让命名空间、目录和文件名一致,再生成生产类映射;不要把开发时新增类后无法自动发现的问题,误判成php 8.6不支持psr-4。自动加载机制并非8.6新增。

Composer官方文档中的PSR-4自动加载配置规则
从一个可验证的类开始
在独立示例目录建立composer.json、src/Greeting.php和run.php。目录名与命名空间前缀分开理解,Linux文件系统还应严格核对文件名大小写。以下配置不要求安装框架。
{
"require": {"php": "^8.6"},
"autoload": {"psr-4": {"Demo\": "src/"}}
}<?php
// src/Greeting.php
namespace Demo;
class Greeting {
public function text(): string { return 'autoload ready'; }
}<?php // run.php require __DIR__ . '/vendor/autoload.php'; echo (new DemoGreeting())->text(), PHP_EOL;
开发和部署分别生成加载器
composer validate composer dump-autoload php run.php composer dump-autoload --no-dev --optimize php run.php
首次dump-autoload生成vendor/autoload.php。开发验证通过后,再用--optimize把可以解析的PSR-4规则转换为类映射;项目有真实依赖时,生产安装应根据已提交的composer.lock运行composer install --no-dev --optimize-autoloader,而不是部署时执行update改写依赖版本。

Composer官方列出的一级类映射优化命令
不要盲目开启权威类映射
--classmap-authoritative把类映射视为唯一来源,未被记录的类不会再按PSR-4查找。运行期间动态生成代理类的项目应先核对框架约定,不能把这个选项当成所有项目的默认优化。部署新增、移动或删除类后重新生成加载器,并按项目原有方式刷新长驻进程;不要直接编辑vendor目录里生成的映射文件。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
本教程核对的是自动加载路径。扩展是否齐全、依赖是否支持PHP 8.6以及应用回归仍是另外的部署检查,生成映射成功不能证明整个项目已兼容。
立即学习“PHP免费学习笔记(深入)”;


















