PHPackages                             imiphp/project-http - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. imiphp/project-http

ActiveProject[Framework](/categories/framework)

imiphp/project-http
===================

imi 框架的 Http Server 项目。https://imiphp.com

v2.1.9(3y ago)73.3k1PHPPHP &gt;=7.4CI failing

Since Aug 14Pushed 2y ago1 watchersCompare

[ Source](https://github.com/imiphp/imi-project-http)[ Packagist](https://packagist.org/packages/imiphp/project-http)[ RSS](/packages/imiphp-project-http/feed)WikiDiscussions 2.1 Synced 3w ago

READMEChangelog (10)Dependencies (7)Versions (19)Used By (0)

说明
==

[](#说明)

这是一个 imi http 项目开发骨架项目，你可以基于这个项目来开发你的项目。

imi 框架：

imi 文档：

安装
--

[](#安装)

创建项目：`composer create-project imiphp/project-http:~2.1.0`

如果你希望在 php-fpm、Workerman 运行 imi：`已内置`

如果你希望在 Swoole 运行 imi：`composer require imiphp/imi-swoole:~2.1.0`

如果你希望在 RoadRunner 运行 imi：`composer require imiphp/imi-roadrunner:~2.1.0`

> RoadRunner 二进制文件请自行下载！

配置
--

[](#配置)

### 项目命名空间

[](#项目命名空间)

默认是 `ImiApp`，可以在 `composer.json` 中修改：

- `autoload.psr-4.ImiApp`
- `imi.namespace`

然后替换代码中的命名空间即可。

### 运行配置

[](#运行配置)

项目配置目录：`config`

HTTP 服务器配置目录：`ApiServer/config`

启动服务
----

[](#启动服务)

**Swoole：**`vendor/bin/imi-swoole swoole/start` （强烈推荐）

**Workerman：**`vendor/bin/imi-workerman workerman/start` （推荐）

**RoadRunner：**`vendor/bin/imi-cli rr/start` （尝鲜）

> 切换环境运行前建议删除运行时文件目录：`rm -rf .runtime/*runtime`

**PHP-FPM：**`vendor/bin/imi-cli fpm/start`（不推荐）

建议在 FPM 模式下生成缓存：`vendor/bin/imi-cli imi/buildRuntime --app-namespace "ImiApp" --runtimeMode=Fpm`

目录
--

[](#目录)

`.runtime` 是运行时文件读写目录，需要有可写权限

`public` 是 php-fpm 站点根目录，不用可删除

`rr` 是 RoadRunner 模式目录，不用可删除

`Module` 是模块目录，一种推荐的目录组织方式。每个模块内部有自己的控制器、服务层、模型等。当然，你也可以根据你的喜好自己组织，imi 框架没有强制要求。

内置的示例控制器目录在 `Module/Test/ApiController`。

生产环境
----

[](#生产环境)

**关闭热更新：**`config/beans.php` 中 `hotUpdate.status` 设为 `false`

生产环境建议只保留一个容器，可以提升性能，imi 官方推荐使用 **Swoole**！

**移除 `imi-fpm`：**`composer remove imiphp/imi-fpm && rm -rf public`

**移除 `imi-workerman`：**`composer remove imiphp/imi-workerman`

**移除 `imi-roadrunner`：**`composer remove imiphp/imi-roadrunner && rm -rf rr && rm -f .rr.yaml`

**移除 `imi-swoole`：**`composer remove imiphp/imi-swoole`（不推荐）

代码质量
----

[](#代码质量)

### 格式化代码

[](#格式化代码)

内置 `php-cs-fixer`，统一代码风格。

配置文件 `.php-cs-fixer.php`，可根据自己实际需要进行配置，文档：

**格式化项目：** `./vendor/bin/php-cs-fixer fix`

**格式化指定文件：** `./vendor/bin/php-cs-fixer fix test.php`

### 代码静态分析

[](#代码静态分析)

内置 `phpstan`，可规范代码，排查出一些隐藏问题。

配置文件 `phpstan.neon`，可根据自己实际需要进行配置，文档：

**分析项目：** `./vendor/bin/phpstan`

**分析指定文件：** `./vendor/bin/phpstan test.php`

### 测试用例

[](#测试用例)

内置 `phpunit`，可以实现自动化测试。

**文档：**

**测试用例 demo：**`tests/Module/Test/TestServiceTest.php`

**运行测试用例：**`composer test`

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 94.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~79 days

Recently: every ~59 days

Total

19

Last Release

1073d ago

Major Versions

v1.0.2 → v2.0.02021-08-20

PHP version history (2 changes)1.x-devPHP &gt;=7.1

v2.0.0PHP &gt;=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/6f917bb42280d114c53cebadc2942a13ee03abe14971089f88895e266d637169?d=identicon)[Yurunsoft](/maintainers/Yurunsoft)

---

Top Contributors

[![Yurunsoft](https://avatars.githubusercontent.com/u/20104656?v=4)](https://github.com/Yurunsoft "Yurunsoft (34 commits)")[![NHZEX](https://avatars.githubusercontent.com/u/14545600?v=4)](https://github.com/NHZEX "NHZEX (2 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/imiphp-project-http/health.svg)

```
[![Health](https://phpackages.com/badges/imiphp-project-http/health.svg)](https://phpackages.com/packages/imiphp-project-http)
```

###  Alternatives

[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k38.6M289](/packages/laravel-dusk)[pinguo/php-msf

Pinguo Micro Service Framework For PHP

1.7k4.2k](/packages/pinguo-php-msf)[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)[link-cloud/fast-hyperf

LinkCloud Fast Hyperf

241.2k1](/packages/link-cloud-fast-hyperf)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
