# 介绍

The PHP Framework For Code Poem As Free As Wind

始于二零一零,十年磨一剑

QueryPHP 是一款现代化的高性能 PHP 渐进式框架, 以提供稳定可靠的高品质企业级框架为历史使命。USE LEEVEL DO BETTER

# 特性

# 它是如何工作的?

QueryPHP 是一个渐进式 PHP 常驻框架,我们强调的是一个渐进式,它既可以运行在 PHP-FPM 场景,也可以在 Swoole 服务中运行,同时还支持在 Go RoadRunner 服务中运行。

# 运行在 PHP-FPM 场景或者 PHP 内置 webserver

事实上,QueryPHP 也是一个普通的 PHP 框架,目前最低版本要求 PHP 8.0.0,我们对环境并没有特别的要求。

我们系统依赖的组件可以通过 composer.json 找到,我们提供了大量开箱即用的功能。

~ $ php leevel server
# => Now visite http://127.0.0.1:9527/
  • Home http://127.0.0.1:9527/
  • MVC router http://127.0.0.1:9527/api/test
  • MVC restful router http://127.0.0.1:9527/restful/123
  • MVC restful router with method http://127.0.0.1:9527/restful/123/show
  • Annotation api router http://127.0.0.1:9527/api/v1/demo/liu
  • Annotation web router http://127.0.0.1:9527/web/v2/demo
  • php leevel link:public http://127.0.0.1:9527/public/css/page.css
  • php leevel link:storage http://127.0.0.1:9527/storage/logo.png
  • php leevel link:apis http://127.0.0.1:9527/apis/
  • php leevel link:debugbar http://127.0.0.1:9527/debugbar/debugbar.cs

上面就是运行在 PHP 内置 WebServer 中,也可以用 Nginx 搭建站点。

# 运行在 Swoole 环境中

Swooke 可以使 PHP 开发人员可以编写高性能的异步并发 TCP、UDP、Unix Socket、HTTP,WebSocket 服务。QueryPHP 已全面支持 Swoole 协程,可以编写出性能很高的 API 服务。

php leevel http:server # php leevel http:server -d
php leevel http:reload
php leevel http:stop
php leevel http:status

和 PHP-FPM 差不多

QueryPHP 支持热重载,开发起来很方便。

root@vagrant-ubuntu-10-0-2-5:/data/codes/queryphp# php leevel http:server
_____________                           _______________
 ______/     \__  _____  ____  ______  / /_  _________
  ____/ __   / / / / _ \/ __`\/ / __ \/ __ \/ __ \___
   __/ / /  / /_/ /  __/ /  \  / /_/ / / / / /_/ /__
     \_\ \_/\____/\___/_/   / / .___/_/ /_/ .___/
        \_\                /_/_/         /_/

                     HTTP SERVER

+-----------------------+---------------------------------+
| Item                  | Value                           |
+-----------------------+---------------------------------+
| host                  | 0.0.0.0                         |
| port                  | 9527                            |
| process_name          | leevel.http                     |
| pid_path              | @path/runtime/protocol/http.pid |
| worker_num            | 8                               |
| daemonize             | 0                               |
| enable_static_handler | 1                               |
| document_root         | @path/www                       |
| task_worker_num       | 4                               |
+-----------------------+---------------------------------+

# Go RoadRunner 支持

RoadRunner 是一个开源的高性能 PHP 应用服务器、负载均衡器和流程管理器。它支持作为一个服务运行,能够在每个项目的基础上扩展其功能。

# 安装 RoadRunner

你可以下载二进制文件.

cd /data/server
wget https://github.com/spiral/roadrunner/releases/download/v1.3.5/roadrunner-1.3.5-darwin-amd64.zip
unzip roadrunner-1.3.5-darwin-amd64.zip
cd /data/codes/queryphp

# RoadRunner 服务

/data/server/roadrunner-1.3.5-darwin-amd64/rr serve -d -v # -d = debug
/data/server/roadrunner-1.3.5-darwin-amd64/rr http:reset
/data/server/roadrunner-1.3.5-darwin-amd64/rr http:workers -i

RoadRunner 和 php-fpm 保持一致

root@vagrant-ubuntu-10-0-2-5:/data/codes/queryphp# /data/server/roadrunner-1.3.5-darwin-amd64/rr serve -d -v
DEBU[0000] [static]: disabled
DEBU[0000] [rpc]: started
DEBU[0000] [http]: started
INFO[0060] 127.0.0.1 {23.1ms} 200 GET http://127.0.0.1:9527/api/test

# Todo

QueryPHP 仍然处于开发中,这里有一些目前还不支持、但已经在计划中的特性:

  • 完善 Swoole
  • 完善开发文档
  • 更多边界单元测试

我们欢迎你为 QueryPHP 的开发作出贡献。