扩展包开发说明

引入正在开发的包

在项目目录中创建packages目录,需要开发的扩展包在此目录中创建,如:

Screen Shot 2017-08-18 at 11.21.30 AM.png

在库的根目录需要创建composer.json文件,写库的配置,如下(更多配置可以参考composer文档):

{
    "name": "mallto/easy-tool",
    "description": "tools",
    "type": "library",
    "keywords": [
        "laravel",
        "tools"
    ],
    "license": "MIT",
    "authors": [
        {
            "name": "never615",
            "email": "never615@gmail.com"
        }
    ],
    "require": {
        "php": ">=5.6.4",
        "laravel/framework": "5.4.*"
    },
    "autoload": {
        "psr-4": {
            "Mallto\\Tool\\": "src/"
        }
    }
}

在项目的composer.json文件中添加:

{
...
    repositories": [
        {
            "type": "path",
            "url": "packages/mallto/easy-mall"
        }
    ]
}

如:

Screen Shot 2017-08-18 at 11.33.22 AM.png

像平时引入库一样执行命令composer require mallto/easy-tool:*@dev(mallto/tool即库中composer文件配置的name).执行命令之后会在项目的vendor目录引入你的库了,只不过是软链接到你的真实库所在目录的.

发布到 VCS 和引用

这部分内容其实composer的文档就写到很清楚:参见,这里补充说明一点,对于私有项目在github上是无法直接安装的,需要在项目目录创建auth.json文件,然后里面写:

{
    "github-oauth": {
        "github.com": "[Personal access tokens]"
    }
}

创建github私人访问令牌的方式:参见

编写扩展库

扩展开发主要看laravel的扩展包开发文档

一般一个库的目录结构如下(当然具体想怎么样看你自己,只要有composer.json文件就行):

Screen Shot 2017-08-17 at 4.13.56 PM.png

Screen Shot 2017-08-17 at 4.34.44 PM.png

src目录中,我是data目录中放model,domain目录中放一些复杂的逻辑,如果很简单的逻辑就直接在controller中完成了.如下:

可以看到有会员和停车的逻辑代码在这里是大头,Repository我也放到了这里,按理应该放在数据data层中.我是这样考虑的,因为在laravel框架下,model的定义基本就是固定模板,定义好之后,我也比较少会反复修改它.在我写一个模块的逻辑的时候,比如会员部分,我基本上所有的逻辑改动都是在Member这个目录中,也包括Repository的部分,这样更加聚合.

在一个项目或者一个库中,一般逻辑执行的流程如下:
简单逻辑下:路由->控制器(简单逻辑直接控制器中编写完成)
复杂逻辑下:路由->控制器->domain层(在根据需要细分)
其他如:队列任务或者调度任务等里面的逻辑也会抽离到domain层中.