QueryPHP v1-rc.2 多语言文档系统及文档更新

栏目: 软件资讯 · 发布时间: 4年前

内容简介:QueryPHP v1.0.0-rc.1 和 2,这两版本主要推进文档的编写进程,第一个 rc 版本实现多国语言文档,rc.2 开发几十篇文档。 QueryPHP 1.0.0 正式版本的功能基本上已经实现,只需要花点时间做一下收一下尾巴。 在正式版...

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, 让您的业务撑起更多的用户服务。

更新日志

  • 【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 <Visite http://127.0.0.1:9527/>

QueryPHP v1-rc.2 多语言文档系统及文档更新

运行基于 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

QueryPHP v1-rc.2 多语言文档系统及文档更新

多语言文档

普通文档

以 Doc.php 结尾的普通文档,方法以 doc 开始的将会自动生成。

https://www.114.ms/docs/template/

https://github.com/hunzhiwange/framework/blob/master/tests/View/SummaryDoc.php

<?php

declare(strict_types=1);

namespace Tests\View;

/**
 * @api(
 *     title="Summary",
 *     zh-CN:title="概述",
 *     zh-TW:title="概述",
 *     path="template/README",
 *     description="",
 * )
 */
class SummaryDoc
{
    /**
     * @api(
     *     title="Code 语法",
     *     description="侧重简单实用。",
     *     note="",
     *     lang="html",
     * )
     */
    public function doc1()
    {
    }
}

单元测试即文档

QueryPHP 在 3 年里沉淀了 3500 例测试用例,这些测试用例保证了框架的代码的品质。测试用例是最好的活文档,基于测试即文档的理念,我们通过给测试用例注解的方式来自动化文档。

https://www.114.ms/docs/database/query/where.html

https://github.com/hunzhiwange/framework/blob/master/tests/Database/Query/WhereTest.php

<?php

declare(strict_types=1);

namespace Tests\Database\Query;

use Tests\Database\DatabaseTestCase as TestCase;

/**
 * @api(
 *     title="Query lang.where",
 *     zh-CN:title="查询语言.where",
 *     path="database/query/where",
 *     description="",
 * )
 */
class WhereTest extends TestCase
{
    /**
     * @api(
     *     zh-CN:title="where 查询条件",
     *     zh-CN:description="最基本的用法为字段 (表达式) 值。",
     *     note="",
     * )
     */
    public function testBaseUse(): void
    {
        $connect = $this->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.

 


以上所述就是小编给大家介绍的《QueryPHP v1-rc.2 多语言文档系统及文档更新》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

JavaScript & jQuery交互式Web前端开发

JavaScript & jQuery交互式Web前端开发

[美]达克特(Duckett,J.) / 杜伟、柴晓伟、涂曙光 / 清华大学出版社 / 2015-6-9 / 79.80元

欢迎选择一种更高效的学习JavaScript和jQuery的方式。 你是一名JavaScript新手?或是您曾经向自己的Web页面上添加过一些脚本,但想以一种更好的方式来实现它们?本书非常适合您。本书不仅向您展示如何阅读和编写JavaScript代码,同时还会以一种简单且视觉化的方式,教您有关计算机编程的基础知识。阅读本书之前,您只需要对HTML和CSS有一些了解即可。 通过将编程理论......一起来看看 《JavaScript & jQuery交互式Web前端开发》 这本书的介绍吧!

XML 在线格式化
XML 在线格式化

在线 XML 格式化压缩工具

HEX CMYK 转换工具
HEX CMYK 转换工具

HEX CMYK 互转工具

HEX HSV 转换工具
HEX HSV 转换工具

HEX HSV 互换工具