php把文件设置为插件的技巧方法


Posted in PHP onFebruary 03, 2020

php怎么把文件设置为插件?PHP中插件机制的一种实现方案

插件,亦即Plug-in,是指一类特定的功能模块(通常由第三方开发者实现),它的特点是:当你需要它的时候激活它,不需要它的时候禁用/删除它;且无 论是激活还是禁用都不影响系统核心模块的运行,也就是说插件是一种非侵入式的模块化设计,实现了核心程序与插件程序的松散耦合。一个典型的例子就是 Wordpress中众多的第三方插件,比如Akimet插件用于对用户的评论进行Spam过滤。

一个健壮的插件机制,我认为必须具备以下特点:

  • 插件的动态监听和加载(Lookup)
  • 插件的动态触发

以上两点的实现均不影响核心程序的运行

要在程序中实现插件,我们首先应该想到的就是定义不同的钩子(Hooks);“钩子”是一个很形象的逻辑概念,你可以认为它是系统预留的插件触发条件。它 的逻辑原理如下:当系统执行到某个钩子时,会判断这个钩子的条件是否满足;如果满足,会转而先去调用钩子所制定的功能,然后返回继续执行余下的程序;如果 不满足,跳过即可。这有点像汇编中的“中断保护”逻辑。

某些钩子可能是系统事先就设计好的,比如之前我举的关于评论Spam过滤的钩子,通常它已经由核心系统开发人员设计进了评论的处理逻辑中;另外一类钩子则 可能是由用户自行定制的(由第三方开发人员制定),通常存在于表现层,比如一个普通的PHP表单显示页面中。

可能你感觉上面的话比较无聊,让人昏昏欲睡;但是要看懂下面我写的代码,理解以上的原理是必不可少的。

下面进行PHP中插件机制的核心实现,整个机制核心分为三大块:

一个插件经理类:这是核心之核心。它是一个应用程序全局Global对象。它主要有三个职责:

  • 负责监听已经注册了的所有插件,并实例化这些插件对象。
  • 负责注册所有插件。
  • 当钩子条件满足时,触发对应的对象方法。

插件的功能实现:这大多由第三方开发人员完成,但需要遵循一定的规则,这个规则是插件机制所规定的,因插件机制的不同而不同,下面的显 示代码你会看到这个规则。

插件的触发:也就是钩子的触发条件。具体来说这是一小段代码,放置在你需要插件实现的地方,用于触发这个钩子。

原理讲了一大堆,下面看看我的实现方案:

插件经理PluginManager类:

<?

/**

* STBLOG PluginManager Class

*

* 插件机制的实现核心类

*

* @package    STBLOG

* @subpackage  Libraries

* @category  Libraries

* @author    Saturn

*/

class PluginManager

{

  /**

   * 监听已注册的插件

   *

   * @access private

   * @var array

   */

  private $_listeners = array();

   /**

   * 构造函数

   * 

   * @access public

   * @return void

   */

  public function __construct()

  {

    #这里$plugin数组包含我们获取已经由用户激活的插件信息

   #为演示方便,我们假定$plugin中至少包含

   #$plugin = array(

    #  'name' => '插件名称',

    #  'directory'=>'插件安装目录'

    #);

    $plugins = get_active_plugins();#这个函数请自行实现

    if($plugins)

    {

      foreach($plugins as $plugin)

      {//假定每个插件文件夹中包含一个actions.php文件,它是插件的具体实现

        if (@file_exists(STPATH .'plugins/'.$plugin['directory'].'/actions.php'))

        {

          include_once(STPATH .'plugins/'.$plugin['directory'].'/actions.php');

          $class = $plugin['name'].'_actions';

          if (class_exists($class)) 

          {

            //初始化所有插件

            new $class($this);

          }

        }

      }

    }

    #此处做些日志记录方面的东西

  }

   

  /**

   * 注册需要监听的插件方法(钩子)

   *

   * @param string $hook

   * @param object $reference

   * @param string $method

   */

  function register($hook, &$reference, $method)

  {

    //获取插件要实现的方法

    $key = get_class($reference).'->'.$method;

    //将插件的引用连同方法push进监听数组中

    $this->_listeners[$hook][$key] = array(&$reference, $method);

    #此处做些日志记录方面的东西

  }

  /**

   * 触发一个钩子

   *

   * @param string $hook 钩子的名称

   * @param mixed $data 钩子的入参

   *  @return mixed

   */

  function trigger($hook, $data='')

  {

    $result = '';

    //查看要实现的钩子,是否在监听数组之中

    if (isset($this->_listeners[$hook]) && is_array($this->_listeners[$hook]) && count($this->_listeners[$hook]) > 0)

    {

      // 循环调用开始

      foreach ($this->_listeners[$hook] as $listener)

      {

        // 取出插件对象的引用和方法

        $class =& $listener[0];

        $method = $listener[1];

        if(method_exists($class,$method))

        {

          // 动态调用插件的方法

          $result .= $class->$method($data);

        }

      }

    }

    #此处做些日志记录方面的东西

    return $result;

  }

}

?>

以上代码加上注释不超过100行,就完成了整个插件机制的核心。需要再次说明的是,你必须将它设置成全局类,在所有 需要用到插件的地方,优先加载。用#注释的地方是你需要自行完成的部分,包括插件的获取和日志记录等等。

下面是一个简单插件的实现。

<?

/**

* 这是一个Hello World简单插件的实现

*

* @package    DEMO

* @subpackage  DEMO

* @category  Plugins

* @author    Saturn

*/

/**

*需要注意的几个默认规则:

*  1. 本插件类的文件名必须是action

*  2. 插件类的名称必须是{插件名_actions}

*/

class DEMO_actions

{

  //解析函数的参数是pluginManager的引用

  function __construct(&$pluginManager)

  {

    //注册这个插件

    //第一个参数是钩子的名称

    //第二个参数是pluginManager的引用

    //第三个是插件所执行的方法

    $pluginManager->register('demo', $this, 'say_hello');

  }

   

  function say_hello()

  {

    echo 'Hello World';

  }

}

?>

这是一个简单的Hello World插件,用于输出一句话。在实际情况中,say_hello可能包括对数据库的操作,或者是其他一些特定的逻辑,比如调用Akimet API。

插件实现的默认规则由核心系统开发者自行确定。比如本例的一些默认规则我在注释中已经写的很清楚,在此不在赘述。需要特别注意的是钩子名称不要重复。

最后一步,就是定义钩子的触发,你将钩子放在哪里,上面这个插件的方法就会在哪里出发。比如我要将say_hello放到我博客首页Index.php, 那么你在index.php中的某个位置写下:

$pluginManager->trigger('demo','');

第一个参数表示钩子的名字,在本例中它是demo;第二个参数是插件对应方法的入口参数,由于这个例子中没有输入参数,所以为空。

总结

本篇文章介绍了插件机制在PHP中实现的一种方法和思路,以及我本人对插件机制的理解。初次接触这个东西,可能会比较生涩,难以理解。但是当你结合真实的 例子,再想想程序的运行流程,思路可能会更清晰一些。如果大家还有任何补充可以联系三水点靠木小编。

PHP 相关文章推荐
mysql 全文搜索 技巧
Apr 27 PHP
php 图片上添加透明度渐变的效果
Jun 29 PHP
获取远程文件大小的php函数
Jan 11 PHP
PHP 第二节 数据类型之数值型
Apr 28 PHP
邮箱正则表达式实现代码(针对php)
Jun 21 PHP
php给每个段落添加空格的方法
Mar 20 PHP
thinkphp项目部署到Linux服务器上报错“模板不存在”如何解决
Apr 27 PHP
PHP获取真实客户端的真实IP
Mar 07 PHP
PHP开发的微信现金红包功能示例
Jun 29 PHP
PHP实现函数内修改外部变量值的方法示例
Dec 28 PHP
PHP工厂模式、单例模式与注册树模式实例详解
Jun 03 PHP
PHP类的自动加载与命名空间用法实例分析
Jun 05 PHP
PHP如何使用JWT做Api接口身份认证的实现
Feb 03 #PHP
PHP7创建销毁session的实例方法
Feb 03 #PHP
PHP7创建COOKIE和销毁COOKIE的实例方法
Feb 03 #PHP
Laravel + Elasticsearch 实现中文搜索的方法
Feb 02 #PHP
php封装的page分页类完整实例代码
Feb 01 #PHP
PHP实现简单的协程任务调度demo示例
Feb 01 #PHP
PHP设计模式之组合模式定义与应用示例
Feb 01 #PHP
You might like
DC的38部超级英雄动画电影
2020/03/03 欧美动漫
在windows平台上构建自己的PHP实现方法(仅适用于php5.2)
2013/07/05 PHP
PHP实现git部署的方法教程
2017/12/19 PHP
tp5(thinkPHP5框架)captcha验证码配置及验证操作示例
2019/05/28 PHP
jQuery学习笔记 操作jQuery对象 属性处理
2012/09/19 Javascript
javascript中不等于的代码是什么怎么写
2013/12/29 Javascript
JavaScript中输出标签的方法
2014/08/27 Javascript
生成二维码方法汇总
2014/12/26 Javascript
AngularJS快速入门
2015/04/02 Javascript
Jquery Ajax Error 调试错误的技巧
2015/11/20 Javascript
AngularJS基础 ng-options 指令详解
2016/08/02 Javascript
jquery插件uploadify多图上传功能实现代码
2016/08/12 Javascript
关于javascript原型的修改与重写(覆盖)差别详解
2016/08/31 Javascript
js原生跨域_用script标签的简单实现
2016/09/24 Javascript
jquery网页日历显示控件calendar3.1使用详解
2016/11/24 Javascript
React组件之间的通信的实例代码
2017/06/27 Javascript
JavaScript之json_动力节点Java学院整理
2017/06/29 Javascript
jquery 遍历hash操作示例【基于ajax交互】
2019/10/12 jQuery
python 创建弹出式菜单的实现代码
2017/07/11 Python
python更改已存在excel文件的方法
2018/05/03 Python
python中字符串内置函数的用法总结
2018/09/13 Python
基于pytorch的lstm参数使用详解
2020/01/14 Python
Python调用ffmpeg开源视频处理库,批量处理视频
2020/11/16 Python
标签和贴纸印刷:Lightning Labels
2018/03/22 全球购物
售后服务科岗位职责范文
2013/11/13 职场文书
四年级下册教学反思
2014/02/01 职场文书
税务会计岗位职责
2014/02/18 职场文书
宿舍保安职务说明书
2014/02/25 职场文书
小学语文国培感言
2014/03/04 职场文书
体育系毕业生求职自荐信
2014/04/16 职场文书
大学生社会实践方案
2014/05/11 职场文书
2014和解协议书范文
2014/09/15 职场文书
群众路线教育实践活动思想汇报(2014特荐篇)
2014/09/16 职场文书
公司仓管员岗位职责
2015/04/01 职场文书
农业项目合作意向书
2015/05/08 职场文书
vue 自定义的组件绑定点击事件
2022/04/21 Vue.js