README

英文 | 中文

简介

这是一个使用EasySwoole框架的骨架应用程序。这个骨架使开发者更容易使用EasySwoole框架。这个应用程序旨在作为那些想要接触EasySwoole框架的人的起点。

需求

EasySwoole对系统环境有一些要求，它只能在Linux和Mac环境下运行，但由于Docker虚拟化技术的发展，Docker for Windows也可以作为Windows下的运行环境。

在XueSiLf/easyswoole-docker项目中已为您准备好了各种版本的Dockerfile，或者可以直接基于已构建的easyswoolexuesi2021/easyswoole镜像来运行。

如果你不想使用Docker作为运行环境的基础，你需要确保你的操作环境满足以下要求

• PHP >= 7.4
• Swoole PHP扩展 >= 4.4.23且Swoole PHP扩展 <= 4.4.26
• JSON PHP扩展
• Pcntl PHP扩展
• OpenSSL PHP扩展（如果需要使用HTTPS）

使用Composer安装

创建新的EasySwoole项目最简单的方法是使用Composer。如果你还没有安装它，请按照文档进行安装。

创建你的新EasySwoole项目

安装3.5.x版本

composer create-project easy-swoole-php/easyswoole-skeleton="3.5.1" project_name

如果你的开发环境基于Docker，你可以使用官方的Composer镜像来创建新的EasySwoole项目

docker run --rm -it -v $(pwd):/app composer create-project --ignore-platform-reqs easy-swoole-php/easyswoole-skeleton="3.5.1" project_name

安装3.7.x版本

composer create-project easy-swoole-php/easyswoole-skeleton="3.7.1" project_name

如果你的开发环境基于Docker，你可以使用官方的Composer镜像来创建新的EasySwoole项目

docker run --rm -it -v $(pwd):/app composer create-project --ignore-platform-reqs easy-swoole-php/easyswoole-skeleton="3.7.1" project_name

入门

安装完成后，你可以使用以下命令立即运行服务器。

cd project_name
php easyswoole server start # for the Development environment
# php easyswoole server start -mode=dev # for the Development environment
# php easyswoole server start -mode=dev -d # for the Development environment with daemonize
# php easyswoole server start -mode=test # for the Test environment
# php easyswoole server start -mode=uat # for the User Acceptance Testing environment
# php easyswoole server start -mode=produce # for the Production environment

或者，如果在基于Docker的环境中，你可以使用模板提供的docker-compose/docker-compose.yml

# install packages
cd project_name
docker run --rm -it -v $(pwd):/app composer install --ignore-platform-reqs

# start services
cd project_name/docker-compose
docker-compose up

这将启动端口为9501的cli-server，并将其绑定到所有网络接口。然后你可以访问https://:9501/，这将显示EasySwoole默认主页。

提示

• 建议你在骨架中的某些文件（如composer.json和docker-compose.yml）中将项目名称重命名为实际的名称。
• 查看App/HttpController/Index.php以了解HTTP入口点的示例。

请记住：你总是可以用适合你项目描述的内容替换此README.md文件的内容。

联系我们

问题：https://github.com/easy-swoole/easyswoole/issues

要加入微信群，请添加微信