# QueryPHP **Repository Path**: garenx/queryphp ## Basic Information - **Project Name**: QueryPHP - **Description**: QueryPHP 是一款现代化的高性能 PHP 渐进式协程框架, 我们还是主要面向传统 PHP-FPM 场景。 - **Primary Language**: PHP - **License**: MIT - **Default Branch**: master - **Homepage**: https://www.queryphp.com - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 16 - **Created**: 2020-07-28 - **Last Updated**: 2020-12-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

Minimum PHP Version Minimum Swoole Version RoadRunner Version StyleCI QueryPHP Doc
Build Status Coverage Status Coverage Status Latest Stable Version QueryPHP License

English | 中文

# 高性能 PHP 渐进式协程框架引擎 > 这是一个 QueryPHP 应用，其核心框架可以在这里找到 [Framework](https://github.com/hunzhiwange/framework)。 QueryPHP 是一款现代化的高性能 PHP 渐进式协程框架, 我们还是主要面向传统 PHP-FPM 场景，以工程师用户体验为历史使命，让每一个 PHP 应用都有一个好框架。 百分之百单元测试覆盖直面 Bug，致力于创造高品质产品 Level Level Leevel，依托 Swoole 开启未来更多可能，此刻未来逐步渐进。我们的愿景是 **USE LEEVEL WITH SWOOLE DO BETTER**, 让您的业务撑起更多的用户服务。 *代码如诗，自由如风, 此刻携手 QueryPHP 共创美好.* * 官方网站: * API 文档: * 开发文档: ![](doyouhaobaby.png) QueryPHP 基于一款成立于 2010 年的 PHP 框架 [DoYouHaoBaby](https://github.com/hunzhiwange/dyhb.blog-x/tree/master/Upload/DoYouHaoBaby) 开发，最新版本 DoYouHaoBaby 更名为 [QeePHP](https://github.com/hunzhiwange/windsforce/tree/master/upload/System/include/QeePHP)，继承了上一代产品的优秀之处，彻底革新并进行了长达 4 年重构. ## 核心包 * QueryPHP On Github: * QueryPHP On Gitee: * Framework On Github: * Framework On Gitee: * Packages: * Packages From Hunzhiwange: * Packages From Leevel: ## 赞助商

金牌赞助商
## 如何安装 ## 基本使用 ``` composer create-project hunzhiwange/queryphp myapp ``` ## 打开浏览器访问 ![](index.jpg) ``` php leevel server ``` * 首页 * MVC 路由 * MVC restful 路由 http://127.0.0.1:9527/restful/123 * 指定方法的 MVC restful 路由 http://127.0.0.1:9527/restful/123/show * 注解路由 http://127.0.0.1:9527/api/v1/petLeevelForApi/helloworld * 带有绑定的注解路由 http://127.0.0.1:9527/api/v2/withBind/foobar * php leevel link:public * php leevel link:storage * php leevel link:apis * php leevel link:debugbar ## 连接数据库 ### 首先创建一个数据库. ``` CREATE DATABASE IF NOT EXISTS myapp DEFAULT CHARSET utf8 COLLATE utf8_general_ci; ``` ### 修改 .env ``` vim .env ... // Database DATABASE_DRIVER = mysql DATABASE_HOST = 127.0.0.1 DATABASE_PORT = 3306 DATABASE_NAME = queryphp_development_db DATABASE_USER = root DATABASE_PASSWORD = ... to ... // Database DATABASE_DRIVER = mysql DATABASE_HOST = 127.0.0.1 DATABASE_PORT = 3306 DATABASE_NAME = myapp DATABASE_USER = root DATABASE_PASSWORD = 123456 ... ``` ### 执行数据库迁移命令 ```diff - $php leevel migrate:migrate + $composer migrate $php leevel server ``` ### 测试连接数据库 ``` { count: 4, :trace: { ... } } ``` ## 登陆到 QueryVue 后台 ### 安装前端 第一步安装前端,细节信息可以在 `frontend/README.md` 查看. ``` cd frontend npm install -g cnpm --registry=https://registry.npm.taobao.org // Just once cnpm install npm run serve # npm run dev ``` ### 登陆后台 接着访问这个登陆地址. ``` user: admin password: 123456 ``` ## 运行测试 ### 首先创建一个用于测试的数据库 test. ``` CREATE DATABASE IF NOT EXISTS test DEFAULT CHARSET utf8 COLLATE utf8_general_ci; ``` ### 修改 .env.phpunit ``` vim .env.phpunit ... // Database DATABASE_DRIVER = mysql DATABASE_HOST = 127.0.0.1 DATABASE_PORT = 3306 DATABASE_NAME = test DATABASE_USER = root DATABASE_PASSWORD = ... to ... // Database DATABASE_DRIVER = mysql DATABASE_HOST = 127.0.0.1 DATABASE_PORT = 3306 DATABASE_NAME = test DATABASE_USER = root DATABASE_PASSWORD = 123456 ... ``` ### 执行数据库迁移命令 ```diff - php leevel migrate:migrate -e env.phpunit + $composer migrate-phpunit ``` ### 运行 ```diff _____________ _______________ ______/ \__ _____ ____ ______ / /_ _________ ____/ __ / / / / _ \/ __`\/ / __ \/ __ \/ __ \___ __/ / / / /_/ / __/ / \ / /_/ / / / / /_/ /__ \_\ \_/\____/\___/_/ / / .___/_/ /_/ .___/ \_\ /_/_/ /_/ $cd /data/codes/queryphp/ $vim .env.phpunit # modify database redis and other - $php leevel migrate:migrate -e env.phpunit + $composer migrate-phpunit - $php vendor/bin/phpunit + $php ./build/phpunit + $composer test + $composer test-coverage ``` ## 生产环境优化 ### 关闭调试 修改 .env 或者 bootstrap/option.php. ``` // Environment production、testing and development ENVIRONMENT = production // Debug DEBUG = false DEBUG_JSON = false DEBUG_CONSOLE = false DEBUG_JAVASCRIPT = false ``` ### 执行优化指令 下面的指令可以让 QueryPHP 运行得更加快速。 ``` php leevel router:cache php leevel option:cache php leevel i18n:cache php leevel view:cache php leevel autoload (Equivalent to `composer dump-autoload --optimize --no-dev`) ``` 或者 ``` php leevel production ``` ## 开发阶段 ### 打开调试 修改 .env 或者 bootstrap/option.php. ``` // Environment production、testing and development ENVIRONMENT = development // Debug DEBUG = true DEBUG_JSON = true DEBUG_CONSOLE = true DEBUG_JAVASCRIPT = true ``` ### 清理缓存指令 ``` php leevel i18n:clear php leevel log:clear php leevel option:clear php leevel router:clear php leevel session:clear php leevel view:clear php leevel autoload --dev (Equivalent to `composer dump-autoload --optimize`) ``` Or ``` php leevel development ``` ## 使用 swoole 提升性能 ### Http 服务 ``` php leevel http:server # php leevel http:server -d php leevel http:reload php leevel http:stop php leevel http:status ``` Swoole http 和 php-fpm 保持一致 ``` 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 | +-----------------------+---------------------------------+ ``` * 首页 * MVC 路由 * MVC restful 路由 http://127.0.0.1:9527/restful/123 * 指定方法的 MVC restful 路由 http://127.0.0.1:9527/restful/123/show * 注解路由 http://127.0.0.1:9527/api/v1/petLeevelForApi/helloworld * 带有绑定的注解路由 http://127.0.0.1:9527/api/v2/withBind/foobar * php leevel link:public * php leevel link:storage * php leevel link:apis * php leevel link:debugbar ### Websocket 服务 ``` php leevel websocket:server # php leevel websocket:server -d php leevel websocket:reload php leevel websocket:stop php leevel websocket:status ``` 一个聊天室测试 ``` root@vagrant-ubuntu-10-0-2-5:/data/codes/queryphp# php leevel websocket:server _____________ _______________ ______/ \__ _____ ____ ______ / /_ _________ ____/ __ / / / / _ \/ __`\/ / __ \/ __ \/ __ \___ __/ / / / /_/ / __/ / \ / /_/ / / / / /_/ /__ \_\ \_/\____/\___/_/ / / .___/_/ /_/ .___/ \_\ /_/_/ /_/ WEBSOCKET SERVER +-----------------+--------------------------------------+ | Item | Value | +-----------------+--------------------------------------+ | host | 0.0.0.0 | | port | 9502 | | process_name | leevel.websocket | | pid_path | @path/runtime/protocol/websocket.pid | | worker_num | 8 | | daemonize | 0 | | task_worker_num | 4 | +-----------------+--------------------------------------+ ``` 访问 ## RoadRunner 支持 RoadRunner 是一个开源的高性能 PHP 应用服务器、负载均衡器和流程管理器。它支持作为一个服务运行，能够在每个项目的基础上扩展其功能。 ### 安装 RoadRunner 你可以下载二进制文件. ``` cd /data/server wget https://github.com/spiral/roadrunner/releases/download/v1.8.2/roadrunner-1.8.2-darwin-amd64.zip unzip roadrunner-1.8.2-darwin-amd64.zip cd /data/codes/queryphp ``` ### RoadRunner 服务 ``` /data/server/roadrunner-1.8.2-darwin-amd64/rr serve -d -v # -d = debug /data/server/roadrunner-1.8.2-darwin-amd64/rr http:reset /data/server/roadrunner-1.8.2-darwin-amd64/rr http:workers -i ``` RoadRunner 和 php-fpm 保持一致 ``` root@vagrant-ubuntu-10-0-2-5:/data/codes/queryphp# /data/server/roadrunner-1.8.2-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 ``` * 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 router http://127.0.0.1:9527/api/v1/petLeevelForApi/helloworld * Annotation router with bind http://127.0.0.1:9527/api/v2/withBind/foobar * 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.css ## 统一团队代码风格 ### 安装 PHP 代码格式化工具 不需要安装即可使用，我们已经下载了版本。 ### 基本使用 ```diff $cd /data/codes/queryphp - $php-cs-fixer fix --config=.php_cs.dist + $php ./build/php-cs-fixer fix --config=.php_cs.dist + $composer php-cs-fixer ``` ### 使用 Git 钩子 添加一个 pre-commit 钩子. ``` cp ./build/pre-commit.sh ./.git/hooks/pre-commit chmod 777 ./.git/hooks/pre-commit ``` 跳过钩子 ``` # git commit -h # git commit -n -m 'pass hook' #bypass pre-commit and commit-msg hooks ``` ## PHPStan 静态分析 ```diff - $php ./build/phpstan analyse + $composer phpstan ``` ## 致谢 感谢同事 [毛飞](https://github.com/maosea0125) 在开发这个项目过程中的无私帮助，让我有了很多新的认识, 这让 QueryPHP 变得更加的美好. 也非常感谢下面的这些优秀的开源软件, 我们也参考了很多的设计与思想, 让我们可以站在巨人的肩膀上保持创新. * QeePHP: * Swoole: * JeCat: * ThinkPHP: * Laravel: * Symfony: * Doctrine: * Phalcon: * Swoft: ## 版权协议 QueryPHP 是一个基于 [MIT license](http://opensource.org/licenses/MIT) 授权许可协议的开源软件.