Slim 必须通过 Composer 安装，推荐用 create-project 初始化项目；在现有项目中追加时才用 require 命令并指定版本；启动前需确认 public 为根目录、重写规则生效且 PHP 版本匹配。
Slim 是一个轻量、灵活的 PHP 微框架，适合构建 API 或小型 Web 应用。它不依赖全局安装或复杂配置，composer 是唯一推荐且标准的安装方式 —— 没有“手动下载 ZIP”或“require_once 引入”的合理替代方案。
用 composer create-project 快速初始化 Slim 项目
这是最直接、最干净的起步方式，会自动创建项目目录、安装最新稳定版 Slim 及其依赖（如 slim/slim、psr/http-message 等），并生成基础路由文件。
composer create-project slim/slim-skeleton my-slim-app
- 执行后会在当前目录下新建
my-slim-app文件夹，包含完整可运行结构 - 该命令基于官方
slim-skeleton模板，已预置public/index.php入口和 PSR-4 自动加载 - 如果提示
command not found: composer，需先确认 Composer 已全局安装并加入 PATH - 不建议用
composer init手动建项目再require slim/slim，容易遗漏关键配置（如 autoload、scripts）
composer require slim/slim 的适用场景与注意事项
仅在已有 PHP 项目中“追加 Slim”时使用此命令，比如你正在维护一个旧系统，想局部引入 Slim 处理某些 API 路由。
cd /path/to/existing-project composer require slim/slim:^4.13
- 必须指定版本约束（如
^4.13），否则默认安装 v5（截至 2024 年中），而 v5 要求 PHP 8.1+ 且移除了部分 v4 的中间件签名 - 安装后不会自动生成
index.php或路由示例，需手动编写入口文件，并确保 PSR-7 实现（如nyholm/psr7）也已安装 - 若项目无
autoload配置，需检查composer.json中是否包含"autoload": {"psr-4": {"App\\": "src/"}}类映射
启动服务前必须验证的三件事
Slim 本身不带内置服务器，但开发阶段常配合 PHP 内置服务器运行 —— 这里最容易出错。
立即学习“PHP免费学习笔记（深入）”；
- 确保
public/是 Web 根目录：访问http://localhost:8000时，请求必须经由public/index.php入口，而非项目根目录下的index.php - 重写规则不能缺失：Apache 需启用
.htaccess（模板中已提供），Nginx 需配置try_files $uri $uri/ /index.php?$query_string; - PHP 版本要匹配：Slim 4 要求 PHP >= 7.4；Slim 5 要求 PHP >= 8.1 —— 运行
php -v和composer show slim/slim可交叉验证
真正卡住人的往往不是安装命令本身，而是 public/ 目录没设对、重写没生效、或者 PHP 版本与所装 Slim 大版本不兼容 —— 这些问题不会报“Slim not found”，而是表现为 404 或空白页。
