# heros-worker

**Repository Path**: mondagphp/heros-worker

## Basic Information

- **Project Name**: heros-worker
- **Description**: 使用workerman封装的一个web框架，性能很强悍，MVC封装，支持分布式部署，使用非常简单。
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://herosworker.wiki
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-08-20
- **Last Updated**: 2021-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: WorkerMan, PHP, annotations

## README

#### 注意，这个项目只是框架内核代码，只能作为依赖，不能直接运行。

为什么要造这个轮子？
====

"PHP是世界上最好的变成语言",这句话虽然是一个梗但是他却代表了php这门语言在编程语言中的江湖地位。那既然是最好的语言，那么免不了就会出现各种各样的框架啦，包括php官方的 zendFrame, Laravel,Yii,包括国产的thinkPHP,ci等框架。那既然有这么多框架，为什么我们还要造这个轮子呢。原因有以下几点：

1. 目前开源的php框架总有这样或者那样的不符合公司项目要求的，使着不顺手，要么就过于重量级，像Laravel,zendFrame,thinkPHP那样太过于臃肿，学习成本太高，要么就是扩展性和或性能达不到要求，使用起来也很不方便。
2. 想把自己学习到的php编程知识做下沉淀，那最好的方法莫过于写php开发框架了。
3. 目前的开源框架都是为了兼容高中低端各种用户而牺牲了框架本身的性能和特性，这显然没有办法完全满足公司的全部需求，而修改像thinkPHP这种大型框架是一件很痛苦的事情，跟自己开发的成本差不多。这估计也是很多大点的公司都有自己的框架的原因了。

------------------

Heros-worker的设计思想
====

Heros-worker是一套web应用开发框架，我们觉得好开发框架应该是<strong>方便，快捷，优雅，干净</strong>的，这也是我们一直在用心做的事情。我们希望框架既能封装良好，是开发者使用方便，但又不损失框架性能，既能快速搭建系统又能保持良好的扩展性。

> 作为一群有逼格的码农，我们目标是开发能够应对<code class="scode">百万级pv</code>的系统框架，并且能够支持多应用,长连接,定时任务,消息队列等。

我们严格遵循约定优于配置的设计原则，能有约定就不提供配置，比如对一些你几乎不会配置的可配置选项，我们都会屏蔽配置接口，按照约定的方式执行。配置太多只会是系统越来越臃肿，执行效率越来越低。

我们始终坚持<strong>一个问题只保留一种你能够实现的最优解决方案即可</strong>，所以我们屏蔽了一些不规范的编码习惯，比如说路由定义几乎所有的框架都支持路由文件或者通过文件路径作为路由，但是在heros-worker中，对不起，你只能使用我们提供的通过注解的方式编写路由，这样的设计是第一是为了使代码可读性更高，调理清晰。二是框架采用了`illuminate/database`优秀的数据库`ORM`,使得代码更健壮。当然这个见仁见智，认同点赞，不喜勿喷。

像其他框架一样，我们也会提供laravel ORM ,middleware（中间件），aop，validate（验证器），session（会话）等开发过程中常用的工具的功能，跟其他框架不一样的是，我们还提供了类似springboot的`@Controller`,`@Resource`,`@Component`注解，这个开发者无需关心性能的问题，在框架启动的时候，已经把`bean`加载到内存中，借鉴java中springboot框架的模式实现服务资源的托管。

Heros-worker的特性
=======

1. 部署简单，高开发效率并且高性能
2. 框架的原理简单易懂，容易学习
3. 在保持约定大于配置的原则下又保持着很好的扩展性
4. 代码风格简洁漂亮，程序精简高效，但是注释详细，适合新手学习.


GitHub 源码地址
====

GitHub: [https://github.com/mondagPHP/heros-worker](https://github.com/mondagPHP/heros-worker)

开发手册
=======

手册地址: [https://herosworker.wiki](https://herosworker.wiki)

联系作者
=====

邮箱：<a href="mailto:mondagroup_php@163.com">mondagroup_php@163.com</a>

#### 本地调试

如果你想在本地直接调试heros-worker框架，不想每次都要更新到 composer 仓库，然后再用 composer update 去composer仓库去更新。
（这个过程慢的要死，就算你使用了中国镜像也慢）
你可以通过任何方式将 heros-worker 放入你的本地目录，如/code/php/heros-worker
然后在你的 app 项目的 composer.json 中加入如下配置

```bash
"repositories": [
        {
            "type": "path",
            "url": "/code/php/heros-worker"
        }
    ],
```

然后在 app 根目录下运行

```bash
composer require 'mondagroup/heros-worker:*@dev'
```