第一章 DuckPHP 介绍

作者QQ: 85811616

官方QQ群: 714610448

教程

教程 ,强烈推荐先过教程这篇文章。

直接运行演示。

进入 template 目录

php start_server.php

即可

Composer 安装

composer require dvaknheo/duckphp # 用 require 
./vendor/bin/duckphp --help     # 查看有什么指令
./vendor/bin/duckphp --create   # --full # 创建工程，把 template 目录内容复制到当前目录
./vendor/bin/duckphp --start    # --host=127.0.0.1 --port=8080 # 开始 web 服务器

不建议使用命令行的 web 服务器，你把 nginx 或 apache 的 document_root 设置为 public 目录按常规框架调整即可。

DuckPHP 也支持在子目录里使用，同时也支持无 path_info 配置的 web 服务器。

DuckPHP 是什么

一个 PHP Web 简单框架

使用原则：比通常的 Model，Controller，View 多了 Service 缺层。弥补了常见 Web 框架缺少的业务逻辑层。而因为这种缺层，导致了很多很糟糕的场景。你会发现很多人在 Contorller 里写一堆代码，或者在 Model 里写一堆代码。

使用 DuckPHP，让网站开发者专注于业务逻辑。

DuckPHP 的名字源自鸭子类型，这东西看起来像鸭子，叫起来像鸭子，所以就是鸭子。

DuckPHP 的优点

主要优点

DuckPHP 可以做到你的应用和 DuckPHP 的系统代码只有一行关联。这个是其他 PHP 框架目前都做不到的。你的代码，基本和 DuckPHP的系统代码无关。
DuckPHP 用可变单例方式，解决了【系统的调用形式不变，实现形式可变】，比如不用 hack 来改系统漏洞。而其他框架用的 IoC,DI 技术则复杂且不方便调试。
DuckPHP 的应用调试非常方便，堆栈清晰，调用 debug_print_backtrace(2) 很容易发现。那些用了中间件的框架的堆栈很不清晰。
DuckPHP 无第三方依赖，你不必担心第三方依赖改动而大费周折。
DuckPHP 耦合松散，扩展灵活方便，魔改容易。
DuckPHP 是库，可以按 composer 库的方式引入
DuckPHP 很容易嵌入其他 PHP 框架。根据 DuckPHP 的返回值判断是否继续后面其他框架。
DuckPHP 支持 composer。无 composer 环境也可运。
DuckPHP 做到了 swoole 和 fpm 代码无缝切换。单例变成协程单例。

DuckPHP 还有以下优点：

DuckPHP 代码简洁，不做多余事情。
DuckPHP 的 Controller 切换容易，独立，和其他类无关，简单明了。
DuckPHP 支持全站路由，还支持局部路径路由和非 PATH_INFO 路由，不需要配服务器也能用。可以在不修改 Web 服务器设置（如设置 PATH_INFO）的情况下使用，也可以在子目录里使用。
DuckPHP 的路由也可以单独抽出使用。
DuckPHP 支持扩展。这些扩展可独立，不一定非要仅仅用于 DuckPHP。
DuckPHP 的数据库类很简洁，而且，你可以轻易方便的替换。如教程就有使用 thinkphp-db 的例子。
DuckPHP 有扩展能做到禁止你在 Controller 里直接写 sql 。有时候，框架必须为了防止人犯蠢，而牺牲了性能。但 DuckPHP 这么做几乎不影响性能。
DuckPHP/Core 是 DuckPHP 的子框架。有时候你用 DuckPHP/Core 也行。类似 lumen 之于 Laravel
DuckPHP/Core 没有数据类，因为数据库类不是 Web 框架的必备。Laravel 的 ORM 确实很强大。但是意味着和 jquery 那样不可调试。
DuckPHP 不限制你的工程的命名空间固定为 app.
DuckPHP 可以规范为，Service 类只能用 MY\Base\ServiceHelper . Controller 类只能用 MY\Base\ControllerHelper .Model 类只能引用 MY\Base\ModelHepler。 View 类只能用 ViewHelper ，其他类不允许用。也可以规范成只用 MY\Base\App 类这个系统类。其中 MY 这个命名空间你可以自定义。

和其他框架简单对比

功能	CodeIgnter 4	ThinkPHP 6	DuckPHP
仅一行关联			V
堆栈清晰	V	V	V
不改源码解决所有问题			V
swoole/fpm 无缝切换			V
以库引用			V
单一 composer 框架			V
无第三方依赖			V
高性能	V	V	V
代码简洁	V	V	V

关于 Servivce 层

MVC 结构的时候，你们业务逻辑放在哪里？新手放在 Controller ，后来的放到 Model ，后来觉得 Model 和数据库混一起太乱，搞个 DAO 层吧。可是一般的 PHP 框架不提供这个功能。所以，Service 按业务走，Model 层按数据库走，Controller 层按 URL 地址走，View 按页面走，这就是 DuckPHP 的理念。

DuckPHP 的最大意义是**，只要**在，什么框架你都可以用你可以不用 DuckPHP 实现 Controller-Service-Model 架构。只要有这个**就是理念成功了。

理解 DuckPHP 的原则

DuckPHP 层级关系图

           /-> View-->ViewHelper
Controller --> Service ------------------------------ ---> Model
         \         \   \               \  /                  \
          \         \   \-> LibService ----> ExModel----------->ModelHelper
           \         \             \                
            \         ---------------->ServiceHelper
             \-->ControllerHelper

Controller 按 URL 入口走调用 view 和service
Service 按业务走 ,调用 model 和其他第三方代码。
Model 按数据库表走，基本上只实现和当前表相关的操作。
View 按页面走
不建议 Model 抛异常
ControllerHelper,ServiceHelper,ModelHelper,ViewHelper 都为助手类，通常缩写为 C, S, M, V

如果 Service 相互调用怎么办? 添加后缀为 LibService 用于 Service 共享调用，不对外，如MyLibService
如果跨表怎么办?，三种解决方案
1. 在主表里附加，其他表估计用不到的情况。
2. 添加后缀为 ExModel 用于表示这个 Model 是多个表的，如 UserExModel。
3. 或者单独和数据库不一致如取名 UserAndPlayerRelationModel

DuckPHP 不做什么

ORM ，和各种屏蔽 sql 的行为，根据日志查 sql 方便多了。自己简单封装了 pdo 。你也可以使用自己的DB类。你也可以用第三方ORM（教程最末有替换成 think-orm 的方法）
模板引擎，PHP本身就是模板引擎。
Widget ，和 MVC 分离违背。
接管替代默认的POST，GET，SESSION 。系统提供给你就用，不要折腾这些。 除非为了支持 swoole

DuckPHP 还要做什么

我真的很需要反馈啊，给我个反馈吧

文档，教程是有了，但还是不太够。
范例，例子还太少太简单了。
单元测试，我真的在学习中。
更多的杀手级应用。

样例

hello world

<?php
require_once __DIR__.'/../vendor/autoload.php';

class Main
{
    public function index()
    {
        echo "hello world";
    }
}
$options=[
    'namespace_controller'=>'\\',   // 设置控制器的命名空间为根
    'skip_setting_file'=>true,      // 跳过配置文件
];
DuckPHP\DuckPHP::RunQuickly($options);

复杂例子

工程附带的模板文件

template/public/demo.php

在单一的文件里演示如何使用 DuckPHP。

这个样例是为了演示特性把所有东西集中到一个文件，

实际编码不会把所有东西全放在同一个文件里。

<?php declare(strict_types=1);
/**
 * DuckPHP
 * From this time, you never be alone~
 */
namespace {
    require_once(__DIR__.'/../../autoload.php');        // @DUCKPHP_HEADFILE
    //头文件可以自行修改。
}
// 以下部分是核心程序员写。
namespace MySpace\Base
{
    use \DuckPhp\Core\View;
    use \DuckPhp\Ext\CallableView;

    // 默认的View 不支持函数调用，我们这里替换他。
    class App extends \DuckPhp\App
    {
        protected function onInit()
        {
            // 本例特殊，这里演示函数调用的   CallableView 代替系统的 View
            $this->options['callable_view_class'] = 'MySpace\View\Views';
            View::G(CallableView::G());
            
            ////
            return parent::onInit();
        }
    }
    //服务基类, 为了 XXService::G() 可变单例。
    class BaseService
    {
        use \DuckPhp\SingletonEx;
    }
    // 模型基类, 为了 XXModel::G() 可变单例。
    class BaseModel
    {
        use \DuckPhp\SingletonEx;
    }
} // end namespace
// 助手类
namespace MySpace\Base\Helper
{
    class ControllerHelper extends \DuckPhp\Helper\ControllerHelper
    {
        // 一般不需要添加东西，继承就够了
    }
    class ServiceHelper extends \DuckPhp\Helper\ServiceHelper
    {
        // 一般不需要添加东西，继承就够了
    }
    class ModelHelper extends \DuckPhp\Helper\ModelHelper
    {
        // 一般不需要添加东西，继承就够了
    }
    class ViewHelper extends \DuckPhp\Helper\ViewHelper
    {
        // 一般不需要添加东西，继承就够了
    }
} // end namespace
// 以下部分是普通程序员写的。不再和 DuckPhp 的类有任何关系。
namespace MySpace\Controller {

    use MySpace\Base\Helper\ControllerHelper as C;
    use MySpace\Service\MyService;

    class Main
    {
        public function __construct()
        {
            //设置页眉页脚。
            C::setViewWrapper('header', 'footer');
        }
        public function index()
        {
            //获取数据
            $output = "Hello, now time is " . C::H(MyService::G()->getTimeDesc());
            $url_about = C::URL('about/me');
            C::Show(get_defined_vars(), 'main_view'); //显示数据
        }
    }
    class about
    {
        public function me()
        {
            $url_main = C::URL('');
            C::setViewWrapper('header', 'footer');
            C::Show(get_defined_vars());
        }
    }
} // end namespace
namespace MySpace\Service
{
    use MySpace\Base\Helper\ServiceHelper as S;
    use MySpace\Base\BaseService;
    use MySpace\Model\MyModel;

    class MyService extends BaseService
    {
        public function getTimeDesc()
        {
            return "<" . MyModel::G()->getTimeDesc() . ">";
        }
    }

} // end namespace
namespace MySpace\Model
{
    use MySpace\Base\Helper\ModelHelper as M;
    use MySpace\Base\BaseModel;

    class MyModel extends BaseModel
    {
        public function getTimeDesc()
        {
            return date(DATE_ATOM);
        }
    }

}
// 把 PHP 代码去掉看，这是可预览的 HTML 结构
namespace MySpace\View {
    class Views
    {
        public function header($data)
        {
            extract($data); ?>
            <html>
                <head>
                </head>
                <body>
                <header style="border:1px gray solid;">I am Header</header>
    <?php
        }

        public function main_view($data)
        {
            extract($data); ?>
            <h1><?=$output?></h1>
            <a href="<?=$url_about?>">go to "about/me"</a>
    <?php
        }
        public function about_me($data)
        {
            extract($data); ?>
            <h1> OK, go back.</h1>
            <a href="<?=$url_main?>">back</a>
    <?php
        }
        public function footer($data)
        {
            ?>
            <footer style="border:1px gray solid;">I am footer</footer>
        </body>
    </html>
    <?php
        }
    }
} // end namespace
// 以下部分是核心程序员写。
// 这里是入口，单一文件下要等前面类声明
namespace {
    $options = [];
    $options['namespace'] = rtrim('MySpace\\', '\\'); //项目命名空间为 MySpace，  你可以随意命名
    $options['is_debug'] = true;  // 开启调试模式
    
    $options['skip_app_autoload'] = true; // 本例特殊，跳过app 用的 autoload 免受干扰
    $options['skip_setting_file'] = true; // 本例特殊，跳过设置文件
    
    \DuckPhp\App::RunQuickly($options, function () {
    });
} // end namespace

架构图

DuckPHP/Framwork 全框架

还有什么要说的

使用它，鼓励我，让我有写下去的动力

mistery-li / duckphp