作者:君琪2010_207 | 来源:互联网 | 2023-01-29 08:08
QueryPHP v1.0.0-rc.1 和 2,这两版本主要推进文档的编写进程,第一个 rc 版本实现多国语言文档,rc.2 开发几十篇文档。
QueryPHP 1.0.0 正式版本的功能基本上已经实现,只需要花点时间做一下收一下尾巴。 在正式版本发布前,需要将文档至少完善出第一个简版本,为实现这一目标,QueryPHP 开发了多语言文档系统,基于测试即文档的理念,生成 Markdown与 VuePress 结合输出用户 API 文档。
关于 QueryPHP
QueryPHP 是一款现代化的高性能 PHP 渐进式协程框架, 我们还是主要面向传统 PHP-FPM 场景,以工程师用户体验为历史使命,让每一个 PHP 应用都有一个好框架。
百分之百单元测试覆盖直面 Bug,我们一直致力于创造高品质的产品 level level leevel,依托 Swoole 协程提升业务性能,此刻未来逐步渐进。 我们的愿景是USE LEEVEL WITH SWOOLE DO BETTER, 让您的业务撑起更多的用户服务。
- https://github.com/hunzhiwange/queryphp
- https://gitee.com/dyhb/queryphp
- https://www.queryphp.com
- https://www.114.ms (镜像站)
更新日志
- 【framework】优化点 call_user_func_array 和 call_user_func 提供更好的性能。
- 【framework】多语言文档生成已经成功实现
- 【framework】将早年的 markdown 文档全部重写到新的文档生成系统
- 【framework】完善集合文档
- 【framework】新增 URL 生成文档
- 【framework】新增命名空间文档
- 【framework】新增类型文档
- 【framework】新增验证器文档
- 【framework】新增树文档
RoadMap
- 【framework】Beta 6 是 QueryPHP 的最后一个 beta 版本,整个框架功能冻结。
- 【framework】RC 版本只修复 BUG、单元测试 和文档完善,不排除可能有一些必要的功能微调。
- 【framework】v1.0.0 正式版本将随 PHP 7.4 版本后发布 https://wiki.php.net/todo/php74,计划是在 2019.12 或者 2020.01 发布。
安装
composer create-project hunzhiwange/queryphp myapp dev-master php leevel server
![](https://img1.php1.cn/3cdc5/3531/525/65d294b88ce59544.jpeg)
运行基于 IViewUI 的通用权限系统
cd /data/codes/queryphp/frontend npm install npm run dev cd /data/codes/queryphp php leevel server http://127.0.0.1:9528/#/login
![](https://img1.php1.cn/3cdc5/3531/525/33e1d7c22c026369.png)
多语言文档
普通文档
以 Doc.php 结尾的普通文档,方法以 doc 开始的将会自动生成。
https://www.114.ms/docs/template/
https://github.com/hunzhiwange/framework/blob/master/tests/View/SummaryDoc.php
单元测试即文档
QueryPHP 在 3 年里沉淀了 3500 例测试用例,这些测试用例保证了框架的代码的品质。测试用例是最好的活文档,基于测试即文档的理念,我们通过给测试用例注解的方式来自动化文档。
https://www.114.ms/docs/database/query/where.html
https://github.com/hunzhiwange/framework/blob/master/tests/Database/Query/WhereTest.php
createDatabaseConnectMock(); // 字段 (表达式) 值 $sql = <<<'eot' [ "SELECT `test_query`.* FROM `test_query` WHERE `test_query`.`id` = 1", [], false, null, null, [] ] eot; $this->assertSame( $sql, $this->varJson( $connect ->table('test_query') ->where('id', '=', 1) ->findAll(true) ) ); } }
文档生成 markdown
php leevel make:docwithin tests/Database/Query/WhereTest.php Class Tests\Database\Query\WhereTest was generate succeed at /data/codes/queryphp.com/docs/docs/database/query/where.md. A total of 1 files generate succeed. Class Tests\Database\Query\WhereTest was generate succeed at /data/codes/queryphp.com/docs/zh-CN/docs/database/query/where.md. A total of 1 files generate succeed. Class Tests\Database\Query\WhereTest was generate succeed at /data/codes/queryphp.com/docs/zh-TW/docs/database/query/where.md. A total of 1 files generate succeed.