QueryPHP渐进式PHP常驻框架引擎 v1.0 rc3

QueryPHP 是一款现代化的高性能 PHP 7 常驻框架，以工程师用户体验为历史使命，让每一个 PHP 应用都有一个好框架。
百分之百单元测试覆盖直面 Bug 一剑封喉，基于 Zephir 实现框架常驻，依托 Swoole 生态实现业务常驻，此刻未来逐步渐进。我们的愿景是 USE LEEVEL WITH SWOOLE DO BETTER，让您的业务撑起更多的用户服务。


两年重构，只为更好的自己
QueryPHP 基于一款成立于 2010 年的 PHP 框架 DoYouHaoBaby 开发，继承了上一代产品的优秀之处，彻底革新并进行了长达 2 年重构.
在这个基础上，我们引入了 Laravel、Symfony 等框架现代化先进特性，站在巨人的肩膀上保持创新。


#它是如何工作的？
QueryPHP 是一个渐进式 PHP 常驻框架，我们强调的是一个渐进式，它既可以运行在 php-fpm 场景，也可以将框架核心编译成 C 扩展，同时还支持在 swoole 服务中运行。
#运行在 php-fpm 场景或者 PHP 内置 webserver
事实上，QueryPHP 也是一个普通的 PHP 框架，目前最低版本要求 PHP 7.1.3，我们对环境并没有特别的要求。


PHP ^7.1.3
ext-mbstring 字符处理
ext-openssl 加密组件
我们系统依赖的组件可以通过 composer.json 找到，我们提供了大量开箱即用的功能。
~ $ php leevel server
# => Now visite http://127.0.0.1:9527/
上面就是运行在 PHP 内置 webserver 中，也可以用 nginx 搭建站点。


#框架编译成 C 扩展
我们为了更好的性能，为整个 QueryPHP 的核心开发了一套可选的 C 扩展，它不是必须要安装的。


Leevel 是一个开源 PHP C 扩展开发框架，采用 zephir 编写，是为了解决使用框架带来性能下降的经典矛盾，Leevel 是为了解决 QueryPHP 性能而开发，可以与同版本的 QueryPHP 混合使用，将接管 composer 中的 PHP 版本功能。
它是如何做到接管 composer 中的底层核心的呢。
我们访问一个类, composer 根据 psr4 规则去搜索到我们文件而载入，如下的脚本会被载入。
Leevel/Di/Container.php
instance('foo', 'bar');
var_dump($container->make('foo')); // bar
...
如果我们存在一个扩展就提供了这样一个类并随着 PHP 常驻，是不是性能不错，实际上是可以，QueryPHP 选择了 zephir 来实现。
leevel/di/container.zep
实际上会被编译成 C，被最终被编译成 PHP 扩展。
leevel/di/container.zep.c
这样子,不需要修改代码直接提升性能。


#Windows 系统
暂未提供 dll.


#Linux 操作系统
下载源代码.
git clone git@github.com:hunzhiwange/leevel.git
cd ext
编译扩展.
$/path/to/phpize
$./configure --with-php-config=/path/to/php-config
$make && make install
将扩展添加到你的 php.ini, 使用 php -m 查看扩展是否被安装.
extension = leevel.so
#运行在 Swoole 环境中
swoole 的问世对于 PHP 后端来说是一种福音，swoole 4.1 已经开始支持原始 pdo,redis 协程，支持 swoole 势在必行。已经做了一些基础工作，对于第一个版本我们要完善单元测试，所以下一个版本主要支持 swoole。
php leevel swoole:http
WARNING
Swoole 部分在第一个版本被撤下来了，后面回归。


#特性
框架理念 (值得托付的使命感，让每一个 PHP 应用都有一个好框架。)
组件系统 (框架底层由独立的高内聚低耦合组件构成，可以轻松无侵入接入现有系统。)
路由系统 (框架提供 MVC 自动路由并能够智能解析 Restful 请求和基于 OpenApi 3.0 规范的 swagger-php 注解路由，文档路由一步搞定。)
整体解决方案 (框架提供了从缓存、Session、IOC 容器、模板引擎、Ddd ORM 等大量开箱即用的功能，提供了基于 Symfony Console 命令行工具集。)
框架常驻 (Leevel 可选扩展接管底层核心)
业务常驻 (基于 Swoole 4 开发，我们的愿景是少量代码或者无修改，让你的业务撑起更多的用户服务。)
百分之百单元测试覆盖（单元测试一直是国产 PHP 开源项目的痛）
拜师国外现代化框架 (从 Laravel、Symfony 吸收大量特性，也包含其它的框架.)
PHP 7 严格模式 （每一个 PHP 脚本都是 strict_types = 1）
PHP 7 类型提示 （仅可能为每一个方法提供确定的参数类型和返回值类型）
依赖注入 （完整实现，关键 mvc、命令行脚本、事件监听器全部接入 IOC）
领域驱动设计 （在妖怪的 QeePHP 基础上保持创新，提供了 UnitOfWork[事务工作单元]、Repository[仓储]、Specification[查询规约]，Entity getter setter[领域实体或叫模型] ）
more...
#Todo
QueryPHP 仍然处于开发中，这里有一些目前还不支持、但已经在计划中的特性：


基于 Vue + IView 通用权限系统
完善 Swoole
开发文档
我们欢迎你为 QueryPHP 的开发作出贡献。


#为什么不是...?
#Laravel
Laravel 是一个非常优秀的框架，拥有非常庞大的社区，实际上 QueryPHP 大量吸收了 Laravel 的一些优秀特性。一致依赖 Laravel 性能确实为人诟病，QueryPHP 开发了一个 Leevel 来解决这一部分问题，用 Laravel 没错，QueryPHP 只是其中一个选择。


#Symfony
Symfony 实际上是 PHP 社区事实标准，QueryPHP 底层大量使用 Symfony 的基础组件例如 console、finder 等，Symfony 可以与 QueryPHP 更好地结合。


#ThinkPHP
ThinkPHP 是我最佩服的一个国产 PHP 框架，10 多年来还在持续不断的革新，国内很少有生命力这么久的框架。我在 2010 年就通读了 ThinkPHP 2.0 代码，在后面工作中主要也是使用 ThinkPHP 3 系列，有苦也有乐。加油！


#Phalcon & Yaf
Phalcon 与 Yaf 世界上最快的 PHP 框架，Yaf 很轻，Phalcon 很重，它们都是世界级的框架。
QueryPHP 选择一部分由 PHP 编写，一部分编译成扩选扩展 Leevel。
Leevel 位于 Yaf 和 Phalcon 轻重之间，是一种可选的方案。