laravel5.5开发composer扩展包

时间:2023-02-04 00:05:52

1. 下载laravel框架,并命名(framework)

composer create-project --prefer-dist laravel/laravel framework "5.4.*"

2. 创建相关目录

app同级目录创建packages文件夹,然后依照下面目录层次创建文件夹,文件可以稍后创建
目录层次如下:

|
|—— packages 
|   |—— archerwong
|       |—— larapackage  实际我们开发包的根目录
|           |—— src
|               |—— ArcherWong
|                   |—— LaraPackage
|                       |—— LaraPackage.php    定义facades
|                       |—— LaraPackageProvider.php    定义服务提供者
|                       |—— MoreAction.php      定义服务提供者提供的各种服务
|               |—— Controllers
|                   |——  IndexController.php  和下面的包路由配合,实现控制器--路由联动
|               |—— views   视图文件夹
|                   |——  message.blade.php 
|                   |——  welcome.blade.php
|               |—— routes.php  包路由
|           |—— composer.json    

3. 项目根目录下的composer.json文件中声明命名空间

"autoload": {
    "classmap": [
        "database"
    ],
    "psr-4": {
        "App\\": "app/",
        "ArcherWong\\LaraPackage\\":"packages/archerwong/larapackage/src/"
    }
},

注意:重新生成autoload文件 ,命令:composer dump-autoload

4. 在包的根目录(packages/archerwong/larapackage)下创建composer.json文件

填入下面内容

{
    "name": "archer-wong/larapackage",
    "description": "how to develop a laravel package",
    "license": "MIT",
    "authors": [
        {   
            "name": "archer-wong",
            "email": "wong_chiu@163.com"
        }   
    ],  
    "minimum-stability": "dev",
    "require": {
        "php": ">=5.6.4"
    },  
    "autoload": {
        "psr-0": {
            "ArcherWong\\LaraPackage": "src/"
        }   
    }   
}

注意:根据自己的需要增加依赖等。。。

5. 各种文件中的内容

5.1 facades文件:LaraPackage.php,这样可以方便的访问IOC容器中注册的类。

文件内容如下

<?php
namespace ArcherWong\LaraPackage;
use Illuminate\Support\Facades\Facade;
class LaraPackage extends Facade
{
    public static function getFacadeAccessor()
    {   
        //return 的字符串会在相应的provider中使用
        return 'larapackage';
    }
}

5.2 定义服务提供者:在该文件夹下创建LaraPackageProvider.php

内容如下

<?php

namespace ArcherWong\LaraPackage;

use Illuminate\Support\ServiceProvider;

class LaraPackageProvider extends ServiceProvider
{
    /** 
     * Bootstrap the application services.
     *
     * @return void
     */
    public function boot()
    {   
        //注册扩展包视图,并起个名字,方便我们调用该文件夹下的视图
        $this->loadViewsFrom(__DIR__.'/../../views','LaraPackageView');
        //注册扩展包路由,使用php artisan route:list 命令可以查看是否生效
        $this->loadRoutesFrom(__DIR__.'/../../routes.php');
        //可以将相应的资源(不仅限于views文件夹)发布到laravel项目的某个位置,下面将views文件夹放到了我们常用的视图文件夹下
        $this->publishes([       
            __DIR__.'/../../views'=>base_path('resources/views/vendor/lara-package'),
        ]);                      
    }                            
                                 
    /**                          
     * Register the application services.
     *                           
     * @return void              
     */                          
    public function register()   
    {                            
        //这里使用到了facades中的字符串
        $this->app->singleton('larapackage',function(){
            //我们可以通过facades的aliase访问下面的MoreAction
            //会在config的app.php文件中进行服务提供者和别名的注册
            return $this->app->make('ArcherWong\LaraPackage\MoreAction');
        });                      
    }                            
}      

5.3 创建MoreAction.php文件

文件内容如下:

<?php
namespace ArcherWong\LaraPackage;

class MoreAction
{
    public function getInfo()
    {   
        $user_ip = $_SERVER["REMOTE_ADDR"]; 
        $time = date('Y-m-d H:i:s');
        return ['user_ip' => $user_ip, 'time' => $time];
    }

}

注意:以下内容和上面有个分割,上面其实已经实现一个包最简单的功能,以上只是返回一个包含ip和时间的数组,开发您的脑洞,当然可以实现各种复杂功能。

在控制器中:

利用门面获得 LaraPackage::getInfo();
返回包中的视图 return view('LaraPackageView::welcome',['data' => $data]);

在视图中:

@include('LaraPackageView::message')

下面内容是为了演示laravel包开发中的控制器,路由,视图的开发。

5.4 controller文件夹下创建IndexController.php

<?php

namespace ArcherWong\LaraPackage\Controllers;

use Illuminate\Routing\Controller as BaseController;
use Illuminate\Support\Facades\View;
use LaraPackage;

class IndexController extends BaseController
{
    public function index() {

        //$data = 'Hello World';
        $data = LaraPackage::getInfo();
        //可以直接使用创建的包里的视图,注意调用是两个冒号
        return view('LaraPackageView::welcome',['data' => $data]);
    }
}

5.5 视图文件

1> welcome.blade.php文件

<!doctype html>
<html>
    <head>
        <meta charset="utf-8">
        <title>Laravel</title>
    </head>
    <body>
        <!--可以直接引入视图中的其他文件-->
        @include('LaraPackageView::message')
        <div>
            您的ip地址是:{{ $data['user_ip'] }}
        </div>
        <div>
            当前时间是:{{ $data['time'] }}
        </div>
    </body>
</html>

2> message.blade.php 文件

<div>
    <div>
        <div>学习laraval扩展包开发</div>
    </div>
</div>

5.6 routes.php

<?php
    //包中路由配置文件
    Route::get('hello','ArcherWong\LaraPackage\Controllers\IndexController@index');

$ vim welcome.blade.php

6. 将包发布到github和packagist上

1> 首先创建一个github项目
拿到对应的仓库地址 :git@github.com:archer-wong/larapackage.git
2> 然后进入packages/archerwong/larapackage文件夹下(也就是我们开发的包的根目录),将包内容上传到github

git init
git add .
git commit -m "first commit"
git remote add origin git@github.com:archer-wong/larapackage.git
git push -u origin master

3>去仓库的setting => Intergrations&services添加Packagist同步服务,

laravel5.5开发composer扩展包
laravel5.5开发composer扩展包

此时需要你的packagist的账号信息,所以我们先进入https://packagist.org(使用github账号登录,免去麻烦),找到右上角的submit按钮,输入我们刚上传包的github仓库地址,进行check验证

laravel5.5开发composer扩展包

审核通过后,类似如下,记下包的packagist地址https://packagist.org/packages/archer-wong/larapackage

laravel5.5开发composer扩展包

然后继续我们的github和packagist的自动同步设置
用户信息,请填写账号,不要写邮箱地址
进入个人信息可以拿到token信息
domain地址填写刚拿到的包packagist地址

此时我们的版本是dev-master

laravel5.5开发composer扩展包

引入的方法是 composer require archer-wong/larapackage “dev-master" 不加版本会报错

如果后期有人提出了一些issues你去修改了自己的package
那么我们会去增加别的tag 也是就是说你修改package之后 再去添加一个tag:

git tag -a 0.1.1 -m 'first version'

填写说明信息后 推送这个tag:

git push origin --tags

参考资料

https://segmentfault.com/a/1190000009069449

https://d.laravel-china.org/docs/5.4/packages#public-assets

https://d.laravel-china.org/docs/5.4/providers

https://d.laravel-china.org/docs/5.4/facades