yurunsoft/imi

This package is abandoned and no longer maintained. The author suggests using the imiphp/imi package instead.

imi 是一款支持长连接微服务分布式的 PHP 开发框架，可在 PHP-FPM、Swoole、Workerman 和 RoadRunner 等多种容器环境下运行。它支持 HttpApi、WebSocket、TCP、UDP、MQTT 服务的开发。

v2.1.64 2024-08-10 00:01 UTC

Requires

• php: >=7.4
• composer-runtime-api: ^2.0
• ext-json: *
• monolog/monolog: ^2.2
• phpdocumentor/reflection-docblock: ^5.2
• psr/container: ~1.1|~2.0
• psr/http-message: ~1.0
• psr/http-server-middleware: ~1.0
• psr/log: ~1.0|~2.0|~3.0
• psr/simple-cache: ~1.0|~2.0
• symfony/console: ^5.1|^6.0
• symfony/event-dispatcher: ^5.1|^6.0
• symfony/polyfill-php80: ^1.23
• symfony/polyfill-php81: ^1.23
• symfony/polyfill-php82: ^1.26
• symfony/process: ^5.1|^6.0
• vlucas/phpdotenv: ~5.3
• yurunsoft/doctrine-annotations: ^1.73.0

Requires (Dev)

• composer/semver: ^3.3.2
• php-cs-fixer/shim: ~3.17.0
• phpstan/phpstan: ~1.8.0
• phpunit/phpunit: ~9.6
• psr/container: ~1.1.0
• psr/http-message: ~1.0.0
• psr/http-server-middleware: ~1.0.0
• psr/log: ~1.0.0
• psr/simple-cache: ~1.0.0
• rector/rector: ~0.13
• symfony/polyfill-uuid: ^1.27
• yurunsoft/ide-helper: ~1.0
• yurunsoft/yurun-http: ~5.0

Suggests

• ext-inotify: 高性能热更新支持
• ext-pdo: 数据库操作支持
• ext-uuid: 模型 uuid 发号器依赖
• symfony/polyfill-uuid: 模型 uuid 发号器依赖

Replaces

• symfony/polyfill-php71: *
• symfony/polyfill-php72: *
• symfony/polyfill-php73: *
• symfony/polyfill-php74: *

MulanPSL-2.0

README

介绍

imi 是一款支持长连接微服务分布式的 PHP 开发框架，它可以运行在 PHP-FPM、Swoole、Workerman 和 RoadRunner 等多种容器环境下。

imi 提供了丰富的基础功能：MySQL、PostgreSQL、Redis、超强超好用的自研 ORM、连接池、Web Api、Web MVC、WebSocket、TCP Server、UDP Server、HTTP2、MQTT、gRPC、容器化（Container）、依赖注入、Aop、事件、异步（Async）、缓存（Cache）、命令行（Command）、配置化（Config）、上下文（Context）、定时任务（Cron）、门面（Facade）、验证器（Validate）、锁（Lock）、日志（Log）、定时器（Timer）、权限控制、消息队列（RabbitMQ、Kafka、Redis）、Swagger、宏（Macro）、限流、共享内存、Smarty、雪花算法发号器（Snowflake）、Workerman Gateway、InfluxDB 和 TDengine 等组件。

同时，imi 还提供了微服务相关支持：Nacos 配置中心、etcd 配置中心、Nacos 服务注册、Nacos 服务发现、Swoole Tracker、Zipkin、Jaeger、Prometheus、InfluxDB 服务指标监控、TDengine 服务指标监控 和 负载均衡 等组件。

除此之外，imi 还提供了管理后台开发骨架 imi-admin。

imi 框架自 2018 年 6 月 21 日首次发布以来，已经稳定运行在许多项目中，例如文旅电商平台、物联网充电云平台、停车云平台、支付微服务、短信微服务、钱包微服务、卡牌游戏服务端和数据迁移服务（虎扑）等项目。

imi AI

imi 官方提供了一个 AI 助手 imi-ai，不管是工作、生活、学习，它都可以帮你解决问题。

凡在 imi 官网赞助过的，凭支付记录凭证，联系宇润领取等额的激活卡号！

凡在 imi Github/Gitee 提交过 PR 的，凭截图联系宇润领取一定额度的激活卡号！

目前纯公益运营，注册会赠送一定免费额度。

由于 OpenAI 接口调用是有成本的，如果额度用完，也欢迎大家来支持开源事业，价格和 OpenAI 官方一致，1RMB=72000 Tokens。

社群

imi 框架交流群： 17916227

微信群：（请注明来意）

打赏赞助：https://www.imiphp.com/donate.html

官方视频教程（完全免费）

imi 2.0 基础视频教程(免费连载中):

https://space.bilibili.com/768718/channel/seriesdetail?sid=274078 https://www.zhihu.com/people/yurunsoft/zvideos

imi 1.0 框架入门教程（免费11集全）https://www.bilibili.com/video/av78158909

imi 框架进阶教程——五子棋游戏开发(免费7集全)https://space.bilibili.com/768718/channel/detail?cid=136926

扩展组件

优秀的第三方组件

• 权限控制 (phpben/imi-auth)
• 注册中心 (phpben/imi-config-center)
• 模块化路由 (phpben/imi-module-route)
• ThinkPHP6 验证器 (phpben/imi-validate)

优秀的开源项目

• 后台管理框架 (phpben/imi-admin)

开始使用

创建 Http Server 项目：composer create-project imiphp/project-http:~3.0.0

创建 WebSocket Server 项目：composer create-project imiphp/project-websocket:~3.0.0

创建 TCP Server 项目：composer create-project imiphp/project-tcp:~3.0.0

创建 UDP Server 项目：composer create-project imiphp/project-udp:~3.0.0

创建 gRPC 项目：composer create-project imiphp/project-grpc:~3.0.0

创建 MQTT Server 项目：composer create-project imiphp/project-mqtt:~3.0.0

完全开发手册

运行环境

• Linux 系统 (Swoole 不支持在 Windows 上运行)
• PHP >= 8.1
• Composer >= 2.0
• Swoole >= 5.0
• Redis、PDO 扩展

Docker

推荐使用 Swoole 官方 Docker：https://github.com/swoole/docker-swoole

成功案例

无论您是在个人项目还是公司项目中使用 imi 开发，无论是开源还是商业项目，都可以向我们提交您的案例。

我们会对您提交的案例进行审查，可能会将其展示在 imi 官网、Swoole 官网等处，这将有助于您的项目推广和发展。

提交格式：

• 项目名称
• 项目介绍
• 项目地址（官网/下载地址/Github等至少一项）
• 联系方式（电话/邮箱/QQ/微信等至少一项）
• 项目截图（可选）
• 感言

案例展示

成功案例：https://www.imiphp.com/case.html

imi 有你的案例会发展得更好，欢迎有条件的用户将项目案例挂上来，同时也是一种免费的宣传！

版权信息

imi 遵循木兰宽松许可证(Mulan PSL v2) 开源协议发布，并提供免费使用。

鸣谢

感谢以下开源项目 (按字母顺序排列) 为 imi 提供强力支持！

• doctrine/annotations (PHP 注解处理类库)
• PHP (没有 PHP 就没有 imi)
• Swoole (没有 Swoole 就没有 imi)

贡献者

你想出现在贡献者列表中吗？

你可以做的事（包括但不限于以下）：

• 纠正拼写、错别字
• 完善注释
• bug修复
• 功能开发
• 文档编写
• 教程、博客分享

提交 Pull Request 到本仓库，你可以成为 imi 的贡献者！

参与框架开发教程详见：https://doc.imiphp.com/v3.0/adv/devp.html