推荐使用 Composer 创建新项目安装 Swoft 框架，命令为 composer create-project swoft/swoft-skeleton myapp，需满足 PHP≥7.4、Swoole≥4.8.0（协程启用）、Composer 2.0+ 等条件，Linux/macOS 更稳定，Windows 需 WSL 或 Docker。

安装 Swoft 框架最推荐的方式是使用 Composer 创建新项目，不建议直接 clone 源码或手动下载——因为 Swoft 是一个完整、自包含的微服务框架，依赖管理必须由 Composer 精确控制。

前提条件检查

确保你的环境满足以下基本要求：

• PHP 版本 ≥ 7.4（Swoft 2.5+ 推荐 PHP 8.0+）
• 已安装 Swoole 扩展（≥ 4.8.0，需启用协程模式，禁用短名如 swoole.use_shortname=Off）
• Composer 已全局可用（建议 2.0+）
• Linux/macOS 环境更稳定，Windows 仅支持 WSL 或 Docker

通过 Composer 创建项目

运行以下命令一键初始化标准 Swoft 应用：

composer create-project swoft/swoft-skeleton myapp

其中 myapp 是你的项目目录名。该命令会自动拉取最新稳定版骨架（含 HTTP、RPC、WebSocket 等基础模块）。

安装完成后进入目录并启动服务验证：

cd myapp
php bin/swoft http:start

访问 http://127.0.0.1:8080，看到 Swoft 欢迎页即表示安装成功。

常见问题处理

如果启动失败，优先检查这几项：

• 扩展缺失：运行 php --ri swoole 查看是否加载，未显示则需重新编译或配置 swoole.so
• 端口被占：修改 app/bean.php 中 httpServer 的 port 配置
• 权限报错：确保 runtime/ 目录可写，执行 chmod -R 755 runtime
• 类找不到：执行 composer dump-autoload -o 重建自动加载映射

基本上就这些。不需要额外配置 Web 服务器（如 Nginx），Swoft 自带高性能 HTTP 服务，开箱即用。