Laravel 5.1中定义事件、事件监听器以及触发事件例子

下文我们来看一篇关于Laravel 5.1中定义事件、事件监听器以及触发事件例子，希望能够帮助到各位新手朋友的哦。

这里我们基于之前基于模型+缓存对文章增删改查这篇文件对文章保存后缓存的处理做进一步优化。我们将文章保存（新建/修改）视为一个事件，将保存文章内容到缓存放到监听器中实现：

1、注册事件-监听器

首先我们需要在EventServiceProvider中注册事件与监听器之间的映射关系：

代码如下	复制代码
protected $listen = [     'App\Events\PostSaved'=>[         'App\Listeners\SaveDataToCache'     ] ];

然后我们在项目根目录运行如下Artisan命令：

php artisan event:generate

该命令会在app/Events目录下生成PostSaved.php，在app/Listeners目录下生成SaveDataToCache.php。

2、定义事件类

接下来我们编辑事件类PostSaved如下：

代码如下

复制代码

<?php namespace App\Events; use App\Events\Event; use App\Models\Post; use Illuminate\Queue\SerializesModels; use Illuminate\Contracts\Broadcasting\ShouldBroadcast; class PostSaved extends Event {     use SerializesModels;     /**      * Create a new event instance.      *      * @return void      */     public function __construct(Post $post)     {         $this->post = $post;     }     /**      * Get the channels the event should be broadcast on.      *      * @return array      */     public function broadcastOn()     {         return [];     } }

我们在构造函数中注入一个Post实例传递给PostSaved。

3、定义监听器类

然后我们来定义监听器类SaveDataToCache，监听器类中使用handle方法接收事件实例并执行响应该事件的业务逻辑，这里就是将就接收到的Post实例保存到缓存中：

代码如下

复制代码

<?php namespace App\Listeners; use App\Events\PostSaved; use Cache; use Log; use Illuminate\Queue\InteractsWithQueue; use Illuminate\Contracts\Queue\ShouldQueue; class SaveDataToCache {     /**      * Create the event listener.      *      * @return void      */     public function __construct()     {         //     }     /**      * Handle the event.      *      * @param PostSaved $event      * @return void      */     public function handle(PostSaved $event)     {         $post = $event->post;         $key = 'post_'.$post->id;         Cache::put($key,$post,60*24*7);         Log::info('保存文章到缓存成功！',['id'=>$post->id,'title'=>$post->title]);     } }

业务逻辑很简单：从注入的PostSaved中获取文章实例并将其保存到缓存，并将该操作记录到日志。

4、触发事件

最后我们来测试文章保存事件及其监听器。

要触发文章保存事件，可以使用Event门面提供的fire方法，在PostController中修改store方法如下：

代码如下	复制代码
public function store(Request $request) {     $title = $request->input('title');     $content = $request->input('content');     $post = new Post;     $post->title = $title;     $post->content = $content;     $post->save();     Event::fire(new PostSaved($post));     return redirect()->route('post.show',['post'=>$post]); }

然后修改update方法如下：

代码如下	复制代码
public function update(Request $request, $id) {     $post = Post::find($id);     if(!$post)         exit('指定文章不存在！');     $title = $request->input('title');     $content = $request->input('content');     $post->title = $title;     $post->content = $content;     $post->save();     Event::fire(new PostSaved($post));     return redirect()->route('post.show',['post'=>$post]); }

在浏览器中访问http://laravel.app:8000/post/create，填写标题和文章内容：

点击提交页面跳转到文章详情页，此时去查看日志storage/logs/laravel.log，可以看到对应日志记录：

[2015-11-10 23:14:12] local.INFO: 保存文章到缓存成功！ {"id":13,"title":"Test Event Add"}
说明已触发文章保存事件，监听器监听到事件后将其保存到缓存中并记录日志。

本文章为各位介绍一篇关于Laravel 集成的 Monolog 库对日志进行配置和记录的实例，具体的如下希望对各位吸帮助。

对于大型系统而言，日志是不可或缺的模块，Laravel自然也对日志提供了完善的支持。目前Laravel集成了强大的Monolog库进行日志记录。下面我们就来大致看一下Laravel中如何对日志进行配置以及日志的简单使用。

1、日志处理器配置

首先我们来看日志处理器的配置。Laravel目前支持四种日志处理器：

single —— 将日志记录到单个文件中。该日志处理器对应Monolog的StreamHandler。
daily —— 以日期为单位将日志进行归档，每天创建一个新的日志文件记录日志。该日志处理器 对应Monolog的RotatingFileHandler。
syslog —— 将日志记录到syslog中。该日志处理器 对应Monolog的SyslogHandler。
errorlog —— 将日志记录到PHP的error_log中。该日志处理器 对应Monolog的ErrorLogHandler。

项目实际日志处理器通过config/app.php中的log配置项决定，默认配置值为single。这里我们使用默认值，不做修改：

'log' => 'single',

当然如果这四种方式满足不了你的需求，还可以使用configureMonologUsing方法完全控制Monolog的日志处理器：

$app->configureMonologUsing(function($monolog) {
    $monolog->pushHandler(...);
});

注：必须将上述这段代码置于bootstrap/app.php文件返回$app之前处才能生效。
2、使用Log记录日志
配置完成后，就可以在代码中使用Log门面来记录日志，Log门面背后实际上是Illuminate\Log\Writer，而在Writer的构造函数中注入了Monolog\Logger。生成的日志文件存放在storage/logs目录下。

目前，Log门面支持八种日志级别（使用RFC 5424标准）：

Log::emergency($error);     //紧急状况，比如系统挂掉
Log::alert($error);     //需要立即采取行动的问题，比如整站宕掉，数据库异常等，这种状况应该通过短信提醒
Log::critical($error);     //严重问题，比如：应用组件无效，意料之外的异常
Log::error($error);     //运行时错误，不需要立即处理但需要被记录和监控
Log::warning($error);    //警告但不是错误，比如使用了被废弃的API
Log::notice($error);     //普通但值得注意的事件
Log::info($error);     //感兴趣的事件，比如登录、退出
Log::debug($error);     //详细的调试信息

下面我们就来分别演示下这几种日志级别的日志记录，我们将在TestController的log方法中进行测试：

public function log(){
    Log::emergency("系统挂掉了");
    Log::alert("数据库访问异常");
    Log::critical("系统出现未知错误");
    Log::error("指定变量不存在");
    Log::warning("该方法已经被废弃");
    Log::notice("用户在异地登录");
    Log::info("用户xxx登录成功");
    Log::debug("调试信息");
}
在浏览器中访问http://laravel.app:8000/test/log，对应在storage/logs/laravel.log记录的日志信息如下：

[2015-11-09 14:24:05] local.EMERGENCY: 系统挂掉了
[2015-11-09 14:24:05] local.ALERT: 数据库访问异常
[2015-11-09 14:24:05] local.CRITICAL: 系统出现未知错误
[2015-11-09 14:24:05] local.ERROR: 指定变量不存在
[2015-11-09 14:24:05] local.WARNING: 该方法已经被废弃
[2015-11-09 14:24:05] local.NOTICE: 用户在异地登录
[2015-11-09 14:24:05] local.INFO: 用户xxx登录成功
[2015-11-09 14:24:05] local.DEBUG: 调试信息

可见对应的日志记录包含了日志记录时间、日志级别和日志消息等信息。当然我们也可以在记录日志时传递上下文信息：

Log::info("用户xxx登录成功",['user_id'=>1]);
对应的日志记录为：

[2015-11-09 14:25:47] local.INFO: 用户xxx登录成功 {"user_id":1}

如果要访问底层Monolog的实例可以使用如下方法：

$monolog = Log::getMonolog();
dd($monolog);

我们可以在浏览器页面中查看当前Monolog对象实例的属性信息：

我们可以从中看出当前使用的日志处理器，日志记录的位置，日志记录的格式等信息。

Laravel 5.1有自己的文件系统了我们可以直接使用Laravel 5.1文件系统来对文件的操作了，下面来看一篇对文件操作，移动，存储及删除的例子。

Laravel 基于 Flysystem 提供了强大的文件系统对文件进行存储和删除，该文件系统和缓存一样，支持多种驱动，这些驱动包括本地驱动、FTP、Amazon S3以及 Rackspace，在这些驱动之上提供了统一的API方便随时切换驱动而不需要修改任何业务逻辑代码。

既然API方法一致，那么这里作为示例，我们使用本地驱动来演示如何使用文件系统API对文件进行存储和删除。

1、配置

文件系统配置位于config/filesystems.php，默认配置如下：

代码如下

复制代码

return [     'default' => 'local',     'cloud' => 's3',     'disks' => [         'local' => [             'driver' => 'local',             'root' => storage_path('app'),         ],         'ftp' => [             'driver' => 'ftp',             'host' => 'ftp.example.com',             'username' => 'your-username',             'password' => 'your-password',         ],         's3' => [             'driver' => 's3',             'key' => 'your-key',             'secret' => 'your-secret',             'region' => 'your-region',             'bucket' => 'your-bucket',         ],         'rackspace' => [             'driver' => 'rackspace',             'username' => 'your-username',             'key' => 'your-key',             'container' => 'your-container',             'endpoint' => 'https://identity.api.rackspacecloud.com/v2.0/',             'region' => 'IAD',             'url_type' => 'publicURL',         ],     ], ];

从配置文件可以看出，Laravel默认的文件系统驱动是local，也就是本地驱动，默认的云存储是Amazon S3。我们可以修改这些默认配置。

所有支持的驱动及驱动详细配置定义在disks配置项中，在local驱动中使用root配置指定文件系统的根路径，即storage/app，这意味着如果使用local驱动，所有文件都会存放在该目录下。如果使用ftp驱动需要指定FTP主机、用户名和登录密码，此外还有一些额外配置，比如端口号、超时时间、加密方式等。同理使用s3或者rackspace也要填写相应的配置项。

由于我们使用local驱动，所以这里我们保持该配置文件不变即可。

2、基本使用

下面我们使用文件系统演示如何上传文件、获取文件、以及删除文件，我们将使用Storage门面提供的方法进行操作。

上传文件/获取文件

这里我们基于 HTTP 请求实例教程#上传文件这篇教程并对其上传方法postFileupload进行修改：

代码如下

复制代码

public function postFileupload(Request $request){     //判断请求中是否包含name=file的上传文件     if(!$request->hasFile('file')){         exit('上传文件为空！');     }     $file = $request->file('file');     //判断文件上传过程中是否出错     if(!$file->isValid()){         exit('文件上传出错！');     }     $newFileName = md5(time().rand(0,10000)).'.'.$file->getClientOriginalExtension();     $savePath = 'test/'.$newFileName;     $bytes = Storage::put(         $savePath,         file_get_contents($file->getRealPath())     );     if(!Storage::exists($savePath)){         exit('保存文件失败！');     }     header("Content-Type: ".Storage::mimeType($savePath));     echo Storage::get($savePath); }

在上传处理逻辑中我们先保存文件到指定位置，然后判断保存后的文件是否存在，如果不存在则表明上传失败，否则显示上传文件内容。

比如我们测试上传图片，访问http://laravel.app:8000/request/fileupload，点击“选择文件”上传一张图片

本文章为各位介绍一篇关于PHP设计模式之Repository资源库模式学习笔记了，希望这篇文章可以为各位带来帮助，具体如下。

1、模式定义

Repository 是一个独立的层，介于领域层与数据映射层（数据访问层）之间。它的存在让领域层感觉不到数据访问层的存在，它提供一个类似集合的接口提供给领域层进行领域对象的访问。Repository 是仓库管理员，领域层需要什么东西只需告诉仓库管理员，由仓库管理员把东西拿给它，并不需要知道东西实际放在哪。

Repository 模式是架构模式，在设计架构时，才有参考价值。应用 Repository 模式所带来的好处，远高于实现这个模式所增加的代码。只要项目分层，都应当使用这个模式。

2、UML类图

3、示例代码

Post.php

<?php

namespace DesignPatterns\More\Repository;

/**
 * Post 类
 * @package DesignPatterns\Repository
 */
class Post
{
    /**
     * @var int
     */
    private $id;

    /**
     * @var string
     */
    private $title;

    /**
     * @var string
     */
    private $text;

    /**
     * @var string
     */
    private $author;

    /**
     * @var \DateTime
     */
    private $created;

    /**
     * @param int $id
     */
    public function setId($id)
    {
        $this->id = $id;
    }

    /**
     * @return int
     */
    public function getId()
    {
        return $this->id;
    }

    /**
     * @param string $author
     */
    public function setAuthor($author)
    {
        $this->author = $author;
    }

    /**
     * @return string
     */
    public function getAuthor()
    {
        return $this->author;
    }

    /**
     * @param \DateTime $created
     */
    public function setCreated($created)
    {
        $this->created = $created;
    }

    /**
     * @return \DateTime
     */
    public function getCreated()
    {
        return $this->created;
    }

    /**
     * @param string $text
     */
    public function setText($text)
    {
        $this->text = $text;
    }

    /**
     * @return string
     */
    public function getText()
    {
        return $this->text;
    }

    /**
     * @param string $title
     */
    public function setTitle($title)
    {
        $this->title = $title;
    }

    /**
     * @return string
     */
    public function getTitle()
    {
        return $this->title;
    }
}
PostRepository.php

<?php

namespace DesignPatterns\More\Repository;

use DesignPatterns\More\Repository\Storage;

/**
 * Post 对应的 Repository
 * 该类介于数据实体层(Post) 和访问对象层(Storage)之间
 *
 * Repository 封装了持久化对象到数据存储器以及在展示层显示面向对象的视图操作
 *
 * Repository 还实现了领域层和数据映射层的分离和单向依赖
 *
 * PostRepository 类
 * @package DesignPatterns\Repository
 */
class PostRepository
{
    private $persistence;

    public function __construct(Storage $persistence)
    {
        $this->persistence = $persistence;
    }

    /**
     * 通过指定id返回Post对象
     *
     * @param int $id
     * @return Post|null
     */
    public function getById($id)
    {
        $arrayData = $this->persistence->retrieve($id);
        if (is_null($arrayData)) {
            return null;
        }

        $post = new Post();
        $post->setId($arrayData['id']);
        $post->setAuthor($arrayData['author']);
        $post->setCreated($arrayData['created']);
        $post->setText($arrayData['text']);
        $post->setTitle($arrayData['title']);

        return $post;
    }

    /**
     * 保存指定对象并返回
     *
     * @param Post $post
     * @return Post
     */
    public function save(Post $post)
    {
        $id = $this->persistence->persist(array(
            'author' => $post->getAuthor(),
            'created' => $post->getCreated(),
            'text' => $post->getText(),
            'title' => $post->getTitle()
        ));

        $post->setId($id);
        return $post;
    }

    /**
     * 删除指定的 Post 对象
     *
     * @param Post $post
     * @return bool
     */
    public function delete(Post $post)
    {
        return $this->persistence->delete($post->getId());
    }
}
Storage.php

<?php

namespace DesignPatterns\More\Repository;

/**
 * Storage接口
 *
 * 该接口定义了访问数据存储器的方法
 * 具体的实现可以是多样化的，比如内存、关系型数据库、NoSQL数据库等等
 *
 * @package DesignPatterns\Repository
 */
interface Storage
{
    /**
     * 持久化数据方法
     * 返回新创建的对象ID
     *
     * @param array() $data
     * @return int
     */
    public function persist($data);

    /**
     * 通过指定id返回数据
     * 如果为空返回null
     *
     * @param int $id
     * @return array|null
     */
    public function retrieve($id);

    /**
     * 通过指定id删除数据
     * 如果数据不存在返回false，否则如果删除成功返回true
     *
     * @param int $id
     * @return bool
     */
    public function delete($id);
}

MemoryStorage.php

<?php

namespace DesignPatterns\More\Repository;

use DesignPatterns\More\Repository\Storage;

/**
 * MemoryStorage类
 * @package DesignPatterns\Repository
 */
class MemoryStorage implements Storage
{

    private $data;
    private $lastId;

    public function __construct()
    {
        $this->data = array();
        $this->lastId = 0;
    }

    /**
     * {@inheritdoc}
     */
    public function persist($data)
    {
        $this->data[++$this->lastId] = $data;
        return $this->lastId;
    }

    /**
     * {@inheritdoc}
     */
    public function retrieve($id)
    {
        return isset($this->data[$id]) ? $this->data[$id] : null;
    }

    /**
     * {@inheritdoc}
     */
    public function delete($id)
    {
        if (!isset($this->data[$id])) {
            return false;
        }

        $this->data[$id] = null;
        unset($this->data[$id]);

        return true;
    }
}

命名空间以前在asp.net中有使用到在新版本的php中已经也有命名空间这一说法了，那么php新版本命名空间怎么样？如何呢，我们下文来看看。

1、什么是命名空间

如果你只需要知道现代PHP特性中的一个，那就应该是命名空间。命名空间在PHP5.3.0中引入，其作用是按照一种虚拟的层次结构组织PHP代码，这种层次结构类似操作系统中文件系统的目录结构。命名空间是现代PHP组件生态的基础，现代的PHP组件框架代码都是放在各自全局唯一的厂商命名空间中，以免和其他厂商使用的常见类名冲突。

下面我来看看真实的PHP组件是如何使用命名空间的。Laravel框架中的Http组件用于管理HTTP请求和响应，这个组件用到了常见的类名，例如Request、Response，很多其他PHP组件也用到了这样的类名，既然其他PHP代码也用到了相同的类名，那怎么使用这个组件呢？其实我们可以放心使用，因为这个组件的代码放在了唯一的厂商命名空间Illuminate中。打开这个组件在GitHub中的仓库（https://github.com/laravel/framework/blob/master/src/Illuminate/Http/Response.php），找到Response.php文件：

第3行代码如下：

namespace Illuminate\Http;
这一行是PHP命名空间声明语句，声明命名空间的代码始终应该放在<?php标签后的第一行。通过这个命名空间的声明语句我们可以看到Response位于厂商命名空间Illuminate中（最顶层命名空间），我们还看到Response类在子命名空间Http中，你可以看下和Response.php文件在同一层级的其他文件，会发现它们都使用相同的命名空间声明语句。

命名空间的作用是封装和组织相关的PHP类，就像在文件系统中把相关的文件放在同一个目录中一样。PHP命名空间和操作系统的物理文件系统不同，这是一个虚拟概念，没必要和文件系统中的目录结构完全相同，虽然如此，但是大多数PHP组件为了兼容广泛使用的PSR-4自动加载标准，会把命名空间放到对应文件系统的子目录中。

2、为什么使用命名空间
前面已经提到过，我们的代码可能和其他开发者的代码使用相同的类名、接口名、函数或常量名，如果不使用命名空间，名称会起冲突，导致PHP执行出错。而使用命名空间将代码放到唯一的厂商命名空间，我们的代码就可以和其他开发者使用相同的类名、接口名、函数或常量名。

当然如果你开发的是小型个人项目，只有少量的依赖，类名冲突可能不是问题，但是如果在团队中工作，开发用到许多第三方依赖的大型项目，就要认真对待命名冲突问题，因为你无法控制项目依赖在全局命名空间中引入的类、接口、函数和常量，这也是为什么要使用命名空间的原因。

3、声明命名空间
每个PHP类、接口、函数和常量都在命名空间中，声明命名空间很简单，在<?php标签后的第一行声明，声明语句以namespace开头，随后是一个空格，然后是命名空间的名称，最后以;结尾。

命名空间经常用于设置顶层厂商名，比如我们设置厂商名为LaravelAcademy：

<?php
namespace LaravelAcademy;
在这个命名空间声明语句后声明的所有PHP类、接口、函数和常量都在LaravelAcademy命名空间中，而且和Laravel学院有某种关系。如果我们想组织学院用到的代码该怎么做呢？答案是使用子命名空间。

子命名空间的声明方式和前面的示例完全一样，唯一的区别是我们要使用\符号把命名空间和子命名空间分开，例如：

<?php
namespace LaravelAcademy\ModernPHP;
这个命名空间后的所有类、接口、函数和常量都位于LaravelAcademy\ModernPHP中。

在同一个命名空间中的类没必要在同一个PHP文件中声明，可以在PHP文件的顶部指定一个命名空间或子命名空间，此时，这个文件的代码就是该命名空间或子命名空间的一部分。因此我们可以在不同文件中编写属于同一个命名空间的多个类。

注：厂商命名空间是最顶层的命名空间，也是最重要的命名空间，用于识别品牌或组织，必须具有全局唯一性。子命名空间相对而言没那么重要，但是可以用于组织项目的代码。
4、导入和别名
在命名空间出现之前，PHP开发者使用Zend风格的类名解决命名冲突问题，这是一种类的命名方案，因Zend框架而流行，这种命名方案在PHP类名中使用下划线的方式表示文件系统的目录分隔符。这种约定有两个作用：其一，确保类名是唯一的；其二，原生的自动加载器会把类名中的下划线替换成文件系统的目录分隔符，从而确定文件的路径。例如，Zend_Cloud_DocumentService_Adapter_WindowsAzure_Query类对应的文件是Zend/Cloud/DocumentService/Adapter/WindowsAzure/Query.php。可以看出，这种命名有个缺点：类名特别长。

现代的PHP命名空间也有这个问题，例如上述Response类完整的全名是Illuminate\Http\Response，幸好，我们可以通过导入以及创建别名的方式来改变这一状况。

导入的意思是指，在每个PHP文件中告诉PHP想使用哪个命名空间、类、接口、函数和常量，导入后就不用使用全名了：

<?php
use Illuminate\Http\Response;

$response = new Response(‘Oops’, 400);
$response->send();
我们通过use关键字告诉PHP，我们想使用Illuminate\Http\Response类，我们只需要输入一次完全限定的类名，随后实例化Response的时候，无需使用完整的类名。

如果觉得这样的类名还是长，可以创建别名。创建别名指的是告诉PHP我要使用简单的名称引用导入的类、接口、函数或常量：

<?php

use Illuminate\Http\Response as Res;

$res = new Res(‘Oops’, 400);
$res->send();
从PHP 5.6开始还可以导入函数和常量，不过要调整use关键字的句法，如果要导入函数，需要使用use func：

<?php
use func Namespace\functionName

functionName();
如果想导入常量，可以使用use constant：

<?php
use constant Namespace\CONST_NAME;

echo CONST_NAME;
当然也支持别名，创建方式和类一样。

5、实用技巧
多重导入

如果想要在PHP文件中导入多个类、接口、函数或常量，需要在PHP文件的顶部使用多个use语句，PHP支持用简短的语法把多个use语句写成一行：

<?php
use Illuminate\Http\Request,
Illuminate\Http\Response;
但是为了可读性，建议不要这么写，还是一行写一个use语句比较好：

<?php
use Illuminate\Http\Request;
use Illuminate\Http\Response;
一个文件使用多个命名空间

PHP允许在一个文件中定义多个命名空间：

<?php
namespace Foo {
    //声明类、接口、函数、常量
}

namespace Bar {
    //声明类、接口、函数、常量
}
但这么做不好，违背了“一个文件一个类”的良好实践，因此不建议这么做。

全局命名空间

如果引用的类、接口、函数和常量没有指定命名空间，PHP假定引用的类、接口、函数和常量在当前的命名空间中。如果要使用其他命名空间的类、接口、函数或常量，需要使用完全限定的PHP类名（命名空间+类名）。

有些代码在全局命名空间中，没有命名空间，比如原生的Exception类就是这样。在命名空间中引用全局的代码时，需要在类、接口、函数或常量前加\符号：

<?php
namespace My\App;

class Foo {
    public function doSomething() {
        throw new \Exception();
    }
}
自动加载

命名空间还为PHP-FIG制定的PSR-4自动加载标准奠定了坚实的基础，大多数现代的PHP组件都使用了这种自动加载模式，使用依赖管理器Composer可以自动加载项目的依赖，后续我们还会详细介绍Composer和PHP-FIG，现在你只需要知道没有命名空间，就没有现代的PHP生态系统和基于组件的新型架构，由此可见命名空间的重要性。