推荐使用 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 等基础模块)。
立即学习“PHP免费学习笔记(深入)”;
SmartB2B 是一款基于PHP、MySQL、Smarty的B2B行业电子商务网站管理系统,系统提供了供求模型、企业模型、产品模型、人才招聘模型、资讯模型等模块,适用于想在行业里取得领先地位的企业快速假设B2B网站,可以运行于Linux与Windows等多重服务器环境,安装方便,使用灵活。 系统使用当前流行的PHP语言开发,以MySQL为数据库,采用B/S架构,MVC模式开发。融入了模型化、模板
安装完成后进入目录并启动服务验证:
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 服务,开箱即用。










