php 8.4 + composer 2.7 搭建项目核心是四步：环境确认（php -v 和 composer --version 验证版本一致）、composer init 初始化并配置 psr-4 自动加载、安装轻量依赖如 symfony/http-foundation 并验证加载、添加 composer.lock 到 git 及配置阿里云镜像保障可维护性。
PHP 8.4 + Composer 2.7 搭建项目，关键不是“从零写代码”，而是快速建立可验证、可加载、可扩展的工程结构。核心动作就四步：环境确认 → 初始化项目 → 配置自动加载 → 安装并验证依赖。
一、先确认 PHP 8.4 和 Composer 2.7 已就位
别跳过这步——很多“Class not found”或“require failed”问题根源在此。
- 运行
php -v，输出必须含 8.4.x（如PHP 8.4.5），且无警告；若显示 8.3 或更低，需切换版本（WSL 用户推荐用 Ondřej Surý PPA；macOS 推荐brew install php@8.4） - 运行
composer --version，确认是 2.7+（如Composer version 2.7.7）；若报command not found，检查是否已全局安装并加入 PATH，或改用php composer.phar --version - 执行
composer show --platform | grep php，确保输出的 PHP 版本与php -v一致——Composer 解析依赖时以该平台版本为准
二、用 composer init 创建最小可用项目结构
composer create-project 适合拉框架模板，但搭建通用 PHP 工程（如工具库、API 内核、CLI 应用），composer init 更干净可控。
- 新建空目录并进入：
mkdir my-tool && cd my-tool - 运行
composer init --no-interaction --name="myorg/my-tool" --type="library"（--type="library"明确类型，避免后续 require-dev 被忽略） - 手动编辑生成的
composer.json，补全 autoload（PSR-4 是标配）：
"autoload": { "psr-4": { "MyOrg\Tool\": "src/" } } - 立即执行
composer dump-autoload，让命名空间映射生效
三、声明并安装第一个真实依赖
别一上来就装 Laravel 或 Symfony——先用轻量、高兼容的包验证流程是否通。
- 执行
composer require symfony/http-foundation:^6.4（它支持 PHP 8.4，且无 C 扩展依赖） - 安装成功后，
vendor/下应有symfony/http-foundation及其递归依赖；composer.lock文件会自动生成并锁定精确版本 - 写个最简测试文件
test.php放在项目根目录：
php
require_once 'vendor/autoload.php';
$request = SymfonyComponentHttpFoundationRequest::createFromGlobals();
echo "OK, PSR-4 + dependency loaded. ";
运行php test.php，输出 OK 即说明整个加载链路完整
四、为长期维护加两道保障
工程化不只是跑起来，更是防踩坑、易协作。
-
锁文件必须提交：把
composer.lock加入 Git，确保所有成员还原完全一致的依赖树；vendor/永远不提交 -
国内加速必配镜像：运行
composer config -g repo.packagist https://mirrors.aliyun.com/composer/，避免 install/update 卡死或超时 - 若项目未来要作为扩展包被其他项目
require，还需补上"type": "library"（已设）、确保src/下类使用正确命名空间，并在composer.json中明确"require": {"php": "^8.4"}
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
