唯一推荐方式是用composer create-project slim/slim-skeleton初始化项目，它自动集成nyholm/psr7、public/index.php入口、psr-4自动加载及错误中间件；直接require slim/slim会导致class not found或空白页，因slim 4+不自带psr-7实现、无入口文件且无autoload映射。
直接用 composer create-project slim/slim-skeleton 初始化项目，别手写 index.php 或只 composer require slim/slim —— 后者在 Slim 4+ 中必然报 Class "PsrHttpMessageServerRequestInterface" not found 或空白页，不是代码问题，是结构缺失。
为什么不能只 composer require slim/slim
Slim 4 和 5 都不自带 PSR-7 实现，也不生成入口文件、目录结构或 autoload 映射。你装完 slim/slim 后手动写 public/index.php，大概率会卡在：
-
Call to undefined method AppFactory::create()→ 缺nyholm/psr7或版本错 - 空白响应、HTTP 200 但无内容 → 请求没进
public/index.php，而是落在了项目根目录 -
getServerParams() not found→ 用了过时的laminas/laminas-diactoros，PHP 8.2+ 不兼容
这些都不是“配置没调好”，而是骨架根本没搭起来。Slim 不是单库，它是一套约定：PSR-7 实现 + 入口路径 + 自动加载规则必须同时就位。
composer create-project slim/slim-skeleton 做了什么
这条命令拉下来的不是“一个框架”，而是一个可立即运行的最小微服务基线：
- 自动安装
slim/slim:^4.13（当前 Slim 4 最稳版）或slim/slim:^5.0（PHP 8.1+ 用），并附带nyholm/psr7和nyholm/psr7-server（轻、快、PHP 8.2+ 友好） - 生成标准目录：
public/index.php（唯一 Web 入口）、src/（PSR-4 自动映射到App）、routes.php示例 - 预置
composer.json中的"autoload": {"psr-4": {"App\": "src/"}}，不用手动dump-autoload - 已配好错误中间件和基础路由，
php -S localhost:8000 -t public启动即访问http://localhost:8000
执行后项目名别含空格或中文，比如 my-api 可以，my api 会导致 Composer 报错。
微服务上线前必须关掉的默认行为
Slim 开发模式默认开启 displayErrorDetails = true，这在微服务间调用时极其危险：
- 上游服务收到的不是 JSON 错误码，而是完整堆栈、文件路径、甚至数据库连接信息（如果日志误打）
- 错误中间件必须显式关闭细节：
$app->addErrorMiddleware(false, true, false) - 必须加日志中间件（如
monolog/monolog），把错误写入文件或转发到集中日志系统，而不是塞进 HTTP 响应体 - 若用
php-di/php-di，记得用SlimFactoryAppFactory::createFromContainer($container)，否则容器注册的服务不会生效
别指望“先开发再加固”——微服务链路里一个服务暴露堆栈，整个调用链的信任模型就崩了。这步漏掉，上线后第一个 500 就可能变成安全事件。
Docker 或 Alpine 环境下容易被忽略的权限点
在 php:8.2-alpine 这类镜像中，composer install 极易因用户权限失败：
- 报错
failed to open stream: Permission denied不是因为目录没 chown，而是 Composer 默认以root运行，但工作目录属主是www-data - 别用
chown -R www-data:www-data /var/www/vendor暴力修复 —— 下次composer install仍会失败 - 正确做法：Dockerfile 中先装
su-exec，然后su-exec www-data composer install --no-dev --optimize-autoloader，最后用su-exec www-data php -S启动 - 所有微服务共用 vendor 目录时，必须统一约束
psr/http-message:^1.0，否则Class 'PsrHttpMessageServerRequestInterface'会被不同版本覆盖失效
真正卡住人的从来不是 Slim 的语法，而是 public 目录没设对、重写没生效、PHP 版本与 Slim 大版本错配、或者微服务上线时还开着 displayErrorDetails —— 这些问题不会报 “Slim 安装失败”，只会让你花三小时查路由，其实根本没进 index.php。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
