Laravel大型项目系列教程(七)之7 扩展包和Artisan开发

本节教程将讲解扩展包开发和Artisan扩展开发,并浏览不同分辨率下的自适应效果。本节结束后整个教程就结束了,文章最后有完整版程序代码的下载。

1.扩展包开发

在前面开发中,我们经常要用到通知,如修改用户信息时视图要写

@if (Session::has(‘message‘))
  <div class="am-alert am-alert-{{ Session::get(‘message‘)[‘type‘] }}" data-am-alert>
    <p>{{ Session::get(‘message‘)[‘content‘] }}</p>
  </div>
@endif

在业务逻辑代码中需要使用

return Redirect::route(‘user.edit‘, $id)->with(‘user‘, $user)->with(‘message‘, array(‘type‘ => ‘success‘, ‘content‘ => ‘Modify successfully‘));

现在我们这里实现一个简单的通知插件,先创建包:

$ php artisan workbench shiyanlou/notification --resources

这时会在项目根目录下多一个名为workbench的目录,里面存放的就是刚才创建的包,我们进入shiyanlou/notification目录,src/Shiyanlou/Notification目录是所有class的主目录,包括ServiceProvider。config、lang、migrations和views目录,就如你所猜测,包含了你创建的包的相应资源。包可以包含这些资源中的任意几个,就像一个”常规”的应用。

修改下包里composer.json中的authors

"authors": [
    {
        "name": "shiyanlou",
        "email": "support@shiyanlou.com"
    }
]

在项目根目录下执行:

$ php artisan dump-autoload

然后我们在app/config/app.php中的providers中增加:

‘Shiyanlou\Notification\NotificationServiceProvider‘,

这步做完后启动开发服务器:

$ php artisan serve

如果启动成功,就说明扩展包的基础就搭建完成了。

现在我们在src/Shiyanlou/Notification下创建一个名为Notification.php的文件,修改:

<?php namespace Shiyanlou\Notification;

use Illuminate\Session\Store as SessionStore;

class Notification {
    private $session = null;

    public function __construct(SessionStore $session)
    {
        $this->session = $session;
    }

    private function addMessage($type, $content)
    {
        $this->session->put(‘notification_message‘, ‘<div class="am-alert ‘ . $type . ‘" data-am-alert><p></p>‘ . $content . ‘</div>‘);
    }

    public function primary($content)
    {
        $this->addMessage(‘am-alert-primary‘, $content);
    }

    public function secondary($content)
    {
        $this->addMessage(‘am-alert-secondary‘, $content);
    }

    public function success($content)
    {
        $this->addMessage(‘am-alert-success‘, $content);
    }

    public function warning($content)
    {
        $this->addMessage(‘am-alert-warning‘, $content);
    }

    public function danger($content)
    {
        $this->addMessage(‘am-alert-danger‘, $content);
    }

    public function show()
    {
        echo $this->session->pull(‘notification_message‘, ‘‘);
    }
}

上面用到了Session,Session表示一次会话,就是从你打开浏览器窗口到关闭。

修改NotificationServiceProvider.php中的register()provides()

public function register()
{
    $this->app[‘notification‘] = $this->app->share(function($app)
    {
        return new Notification($this->app[‘session.store‘]);
    });
}

public function provides()
{
    return array(‘notification‘);
}

上面是向Ioc容器注册类。

然后在src/Shiyanlou/Notification下创建一个名为Facades的文件夹,在Facades目录下创建一个名为Notification.php的文件,修改:

<?php namespace Shiyanlou\Notification\Facades;

use Illuminate\Support\Facades\Facade;

class Notification extends Facade {
    protected static function getFacadeAccessor()
    {
        return ‘notification‘;
    }
}

我们这里继承了Facade类,用Facades可以访问IoC容器中注册的类,有了IoC容器,我们可以在任何地方调用注册的类。

为了方便我们的使用,我们在app/config/app.phpaliases中增加一个别名:

‘Notification‘ => ‘Shiyanlou\Notification\Facades\Notification‘,

下面就来试试这个插件,把上面的

@if (Session::has(‘message‘))
  <div class="am-alert am-alert-{{ Session::get(‘message‘)[‘type‘] }}" data-am-alert>
    <p>{{ Session::get(‘message‘)[‘content‘] }}</p>
  </div>
@endif

替换成

{{ Notification::show() }}

return Redirect::route(‘user.edit‘, $id)->with(‘user‘, $user)->with(‘message‘, array(‘type‘ => ‘success‘, ‘content‘ => ‘Modify successfully‘));

替换成

Notification::success(‘Modify successfully‘);
return Redirect::route(‘user.edit‘, $id);

现在修改用户信息后提示成功的信息就能方便地显示出来:

简单的扩展包开发就完成了。

2.Artisan扩展开发

Artisan是Laravel中自带的命令行工具的名称,它提供了一些开发过程中有用的命令。我们可以编写自己的Artisan命令完成特定的功能,这里举一个开发导出用户数据的命令。首先我们创建一个新的命令类:

$ php artisan command:make ExportUsersCommand

执行完后我们会发现在app/commands生成了一个ExportUsersCommand.php的文件,这个就是我们自定义的命令类,然后我们需要注册命令,在app/start/artisan.php中增加:

Artisan::add(new ExportUsersCommand);

下面编写ExportUsersCommand类,把$name的值改为export:users,这个$name是命令的名称,把$description的值改为Export all users,这个是命令的描述,然后添加一个获取用户数据的方法:

protected function getUsersData()
{
    $users = User::all();
    foreach ($users as $user) {
        $output[] = [$user->id, $user->email, $user->nickname,
                     $user->is_admin, $user->block, $user->created_at];
    }
    return $output;
}

然后编写getArguments()getOptions()

protected function getArguments()
{
    return array(
        array(‘file‘, InputArgument::OPTIONAL, ‘The output file path‘, null),
    );
}

protected function getOptions()
{
    return array(
        array(‘headers‘, null, InputOption::VALUE_NONE, ‘Display headers?‘, null),
    );
}

getArgumentsgetOptions方法是用来接收要传入您的自定义命令的地方,这两个方法都会回传一组命令数组,并由数组清单所组成。

下面开始编写fire()

public function fire()
{
    $output_path = $this->argument(‘file‘);
    $headers = [‘ID‘, ‘E-mail‘, ‘NickName‘, ‘is_admin‘, ‘is_block‘, ‘CreateDateTime‘];
    $rows = $this->getUsersData();
    if ($output_path) {
        $handle = fopen($output_path, ‘w‘);
        if ($this->option(‘headers‘)) {
            fputcsv($handle, $headers);
        }
        foreach ($rows as $row) {
            fputcsv($handle, $row);
        }
        fclose($handle);
        $this->info("Exported list to $output_path");
    } else {
        $table = $this->getHelperSet()->get(‘table‘);
        $table->setHeaders($headers)->setRows($rows);
        $table->render($this->getOutput());
    }
}

当自定义命令被执行时,将会调用fire方法,你可以在此加入任何的逻辑判断。

现在就可以测试我们自己开发的命令了,先执行:

$ php artisan export:users

执行后会在命令行终端输出用户列表,我们试试导出到一个文件:

$ php artisan export:users --headers users.csv

执行后终端会输出Exported list to users.csv,在项目根目录下会生成一个名为users.csv的文件,你可以用表格软件或者直接打开,里面存放的就是用户的数据列表。

3.自适应效果

让我们看下在低分辨率下的自适应效果

首页

文章内容页面

登录页面

文章管理页面

编辑文章页面

4.小结

本节教程介绍了怎么进行扩展包和Artisan开发,本套教程也就此结束了,你可以继续完善这个博客,此教程仅仅只是做一个引入人,你完全可以用Laravel开发自己想要的网站,Laravel中的缓冲、Mail、本地化和队列等还没有提到,这就需要你自己去探索了,最后推荐一个开发环境Laravel Homestead,我们可以非常方便地在其中开发Laravel。

最终版代码下载:

$ git clone https://github.com/shiyanlou/laravel-blog-7-final.git

本文详细出自http://www.shiyanlou.com/courses/123,转载请注明出处

时间: 2024-08-29 03:50:17

Laravel大型项目系列教程(七)之7 扩展包和Artisan开发的相关文章

Laravel大型项目系列教程(三)之发表文章

Laravel大型项目系列教程(三)之发表文章 一.前言 上一节教程中完成了用户管理,这节教程将大概完成发表Markdown格式文章并展示的功能. 二.Let's go 1.数据库迁移 文章模块中我们需要建立articles.tags以及article_tag表,每篇文章会有一到多个标签,每个标签会有一到多篇文章,创建迁移文件: $ php artisan migrate:make create_articles_table --create=articles $ php artisan mig

laravel大型项目系列教程(六)之优化、单元测试以及部署

本节教程将讲解错误处理.配置文件的使用.单元测试以及部署到Apache服务器. 1.错误处理 如果用户访问的URL不存在或者服务器存在错误时,我们不希望返货一个错误的页面,而想返回一个友好提示的页面,在Laravel中可以很轻松地实现,Laravel有很简单的错误和日志处理,当服务器端存在错误时,app/start/global.php里默认有一个处理所有异常的异常处理程序: App::error(function(Exception $exception) { Log::error($exce

Laravel大型项目系列教程(六)之优化、单元测试及部署

一.前言 本节教程将讲解错误处理.配置文件的使用.单元测试以及部署到Apache服务器. 二.Let's go 1.错误处理 如果用户访问的URL不存在或者服务器存在错误时,我们不希望返货一个错误的页面,而想返回一个友好提示的页面,在Laravel中可以很轻松地实现,Laravel有很简单的错误和日志处理,当服务器端存在错误时,app/start/global.php里默认有一个处理所有异常的异常处理程序: App::error(function(Exception $exception) {

Laravel大型项目系列教程(三)之显示文章列表和用户修改文章

小 编心语:不知不觉已经第四部分了,非常感谢很多人给小编提的意见,改了很多bug,希望以后能继续帮小编找找茬~小编也不希望误导大家~这一节,主要讲的 是如何显示文章列表和让用户修改文章,小编预告一下(一共有八节哦)如果有不懂得地方,或者本文呢没有讲清楚的地方,敬请期待下一章节. 一.前言 上节教程中实现了发布文章的功能,本节教程中将大概实现在首页和用户主页分页显示文章和标签列表.用户能够修改删除文章. 二.Let's go 1.首页显示文章和标签列表 我们需要在首页显示文章和标签列表,修改vie

Laravel大型项目系列教程(四)显示文章列表和用户修改文章

小编心语:不知不觉已经第四部分了,非常感谢很多人给小编提的意见,改了很多bug,希望以后能继续帮小编找找茬~小编也不希望误导大家~这一节,主要讲的 是如何显示文章列表和让用户修改文章,小编预告一下(一共有八节哦)如果有不懂得地方,或者本文呢没有讲清楚的地方,敬请期待下一章节. 一.前言 上节教程中实现了发布文章的功能,本节教程中将大概实现在首页和用户主页分页显示文章和标签列表.用户能够修改删除文章. 二.Let's go 1.首页显示文章和标签列表 我们需要在首页显示文章和标签列表,修改view

laravel大型项目系列教程(四)之显示文章列表和用户修改文章

小编心语:不知不觉已经第四部分了,非常感谢很多人给小编提的意见,改了很多bug,希望以后能继续帮小编找找茬~小编也不希望误导大家~这一节,主要讲的是如何显示文章列表和让用户修改文章,小编预告一下(一共有八节哦)如果有不懂得地方,或者本文呢没有讲清楚的地方,敬请期待下一章节. 一.前言 上节教程中实现了发布文章的功能,本节教程中将大概实现在首页和用户主页分页显示文章和标签列表.用户能够修改删除文章. 二.Let's go 1.首页显示文章和标签列表 我们需要在首页显示文章和标签列表,修改views

Laravel大型项目系列教程(五)之文章和标签管理

一.前言 本节教程将大概完成文章和标签管理以及标签关联. 二.Let's go 1.文章管理 首先创建管理后台文章列表视图: $ php artisan generate:view admin.articles.list 修改views/admin/articles/list.blade.php: @extends('_layouts.default') @section('main') <div class="am-g am-g-fixed blog-g-fixed">

webpack4 系列教程(七): SCSS提取和懒加载

教程所示图片使用的是 github 仓库图片,网速过慢的朋友请移步>>> (原文)webpack4 系列教程(七): SCSS 提取和懒加载. 个人技术小站: https://godbmw.com 有空就来看看, 我一直都在 本节课讲解在webpack v4中的 SCSS 提取和懒加载.值得一提的是,v4和v3在 Scss 的懒加载上的处理方法有着巨大差别. >>> 本节课源码 >>> 所有课程源码 1. 准备工作 关于 SCSS 处理的基础,请参考w

ASP.NET 5系列教程(七)完结篇-解读代码

在本文中,我们将一起查看TodoController 类代码. [Route] 属性定义了Controller的URL 模板: [Route("api/[controller]")] 所有符合该模板类型的HTTP 请求都会被路由到该controller.在本例中, 路由的命名规范为对应Controller 的前缀,对于TodoController 类,路由模板为 “api/todo”. HTTP 方法 [HttpGet].[HttpPost]和[HttpDelete] 属性定义为 co