单一功能原则:面向对象编程领域规定每个类都应该有一个单一功能

单一功能原则,在面向对象编程领域中，单一功能原则（Single responsibility principle）规定每个类都应该有一个单一的功能，并且该功能应该由这个类完全封装起来。所有它的（这个类的）服务都应该严密的和该功能平行（功能平行，意味着没有依赖）。

把前面课堂源码改为单一功能原则思路

这节课按照单一功能原则，每个类负责一个单一的功能，把类完全封装起来，从程序中把其余部分代码分离出来。在这个user class，显然它的唯一功能应该是为用户保存数据，但现在它有多重功能。例如，这个类也负责验证。

我们代码对电子邮件进行硬编码验证方法，现在带来了一些实际问题，首先验证与user class没有紧密的联系，其次我们不能在程序的其它地方中重复使用这个验证方法。现在让我们想一想，这个验证方法放在user类中是个好主意吗？如果我们想要检查一个有效的电子邮件比如我们的联系表单？如果我们的user类真的负责验证，或者我们可以提取出来，创建一些验证服务。

如果用户类是关于存储用户数据，我们是否真的需要一个登录和一个注销方法？或者我们应该创建一个专门用于登录和注销的认证服务。哈希？user类是我们应用程序中唯一需要哈希的地方，如果不是的话，那为什么要在我们的user类中呢？

上述这些考虑都与单一功能原则有关，现在按照单一功能原则，每个类都要有一个单一的功能，实际的功能应该完全由类来包装。好的，现在让我们来改进，让我们先重构应用程序的结构，创建一个app的文件夹，然后我会将user类并将其移到该文件夹内，把user.php的文件名修改User.php，在app文件夹创建一个新类叫Validator.php，专门用来验证，又创建Helper.php。

单一功能原则-php面向对象编程单实例演示

打开Validator.php，让我们为我们的验证类创建一个非常简单的验证服务，首先我们需要存储错误，默认情况下是一个空的数组，我们把它创建为私有：

<?php

class Validator
{
	//设置一个空的数组存储错误信息
	private $errors = array();

	//创建一个叫validate的公共方法
	public function validate()
	{

	}

	//如果验证失败我们将添加错误到我们私有错误数组
	//所以我们还需要一个公共的方法从该数组中获取错误
	public function getErrors()
	{
		//这里返回错误信息
		return $this->errors;
	}
}
?>

回到validation方法，现在需要两个参数，第一个将会是一个数组，这个将称为数组($data)，它将包含我们要验证的数据，第二个是一个数组，将被称为规则($rules)：

<?php

class Validator
{
	//设置一个空的数组存储错误信息
	private $errors = array();

	//创建一个叫validate的公共方法
	public function validate(Array $data, Array $rules)
	{
	//这里将包含我们希望验证的规则
	//假设验证已经通过所以我们设置valid等于true
	$valid = true;
	
	//如果有一个或多个规则失败，我们只是设置valid为错误
	//我们需要把规则像这样遍历它们
	foreach ($rules as $item => $ruleset)
	{
		//让我们假设ruleset是一个字符串
		//验证像这样required|email|min:8，我们的验证规则是required中横线另外一个验证规则
		//这里ruleset是字符串，让它是一个数组，我们就能够遍历它
		//所以我将要做就是explode它
		//设置分隔符为|
		//ruleset作为第二个参数
		$ruleset = explode('|',$ruleset);
		
		//现在我们可以把ruleset遍历出来
		//所以我们设置每一个规则为规则
		foreach ($ruleset as $rule)
		{
			//规则就是检查冒号
			$pos = strpos($rule, ':');
			//如果在规则里面有冒号，我们将设置一个pos变量
			//接着，我们将调整这个规则和这个参数根据我们的变量
			//如该$pos不等于false,那么我们有一个参数
			if ($pos !== false){
				//让我们从规则字符串中获取参数
				//我们将在我们的规则上做一个子字符串，我们希望在这里冒号的后面。
				$parameter = substr($rule,$pos + 1);
				//随后，我们字符串的规则将是冒号前的所有内容
				//所以从零开始直到冒号结束
				$rule = substr($rule, 0, $pos);
			
			}
			//如该我们验证规则字符串没有冒号
			//这种情况参数将会等于一个空字符串
			//我们的规则什么都不会发生
			else{
				$parameter = '';
			}
			
			//现在我们想要做的下一件事是采取我们的规则，称为电子邮件
			//我们真正想要做的是寻找一个验证电子邮件的方法，如果存在，我们需要传递我们正在验证的项目的名称，我们还需要传递一个值，如果我们有任何参数，我也只是通过验证。
			
			//ValidateEmail($item,$value,$param)
			
			//所以为了能够做到这一点，我们首先需要构建一个方法名称(methodName)
			//设置为验证并且跟上 . ucfirst($rule);
			//如果rule是电子邮箱将会验证电子邮箱
			
			$methodName = 'validate' . ucfirst($rule);
			$value = isset($data[$item]) ? $data[$item] : NULL;
			
			//判断这个方法是否存在，如果存在我们将调用它
			
			if(method_exists($this,$methodName)){
				//接着我们将要在这里用这个item
				//我们将把它作为第一个参数传递
				//接着我们将要拿出一个值，我们将在稍后不得不定义
				//最后我们用parameter并传递进来
				
				//$this->$methodName($item,$value,$parameter);


				//对于$value，我们如何找到这个特定项目的$value
				//假定该项目被设置在$data数组中
				//我们可以只是做$data，然后$item
				//最好先是检查是否存在
				
				//验证会返回true或者false，如该false
				
				$this->$methodName($item,$value,$parameter) OR $valid = false;
			}
		}		
	}
	//我们将通过返回有效的变量结束
	return $valid;
	}

	//如果验证失败我们将添加错误到我们私有错误数组
	//所以我们还需要一个公共的方法从该数组中获取错误
	public function getErrors()
	{
		//这里返回错误信息
		return $this->errors;
	}
}

检查上述代码是否工作让我们回到index.php：

<?php

//引入类文件
require 'app/User.php';
require 'app/Validator.php';
require 'app/Helper.php';

//设置
$rules = array('email' => 'required|email','password'=>'required|min:8');
$data= array('email' => 'peter@linyongmin.com','password'=>'12345678');

$validator = new Validator();

$validator->validate($data, $rules);

返回浏览器刷新index.php页面显示空白。

让我们回到Validator.php开始设置validation规则：

	//ValidateRequired验证需要通过调用的三个参数$item,$value,$parameter
	private function validateRequired($item,$value,$parameter)
	{
		//require验证非常简单
		//如果值等于空字符串，或者等于null
		//验证应该失败
		//添加一条信息到这个错误数组
		if ($value === '' || $value === NULL)
		{
			//让我们来做一个这样的$item索引
			//然后让我们只是添加一个错误
			$this->errors[$item][] = '这个' . $item . '必填项';
			//我们也需要返回false，因为验证规则确实失败了
			return false;
		}
		
		//如果不失败，通过
		return true;
	}

如我们非常想知道validation返回false或true，我们可以在index.php这样来操作：

<?php

//引入类文件
require 'app/User.php';
require 'app/Validator.php';
require 'app/Helper.php';

//设置
$rules = array('email' => 'required|email','password'=>'required|min:8');
$data= array('email' => 'peter@linyongmin.com','password'=>'12345678');

$validator = new Validator();

//$validator->validate($data, $rules);

if ($validator->validate($data, $rules) == true){
	var_dump('通过');
}else {
	var_dump($validator->getErrors());
}
?>

返回浏览器刷新index.php页面显示string(6) “通过”。让我们删除邮箱地址和密码，测试结果：array(2) { [“email”]=> array(1) { [0]=> string(20) “这个email必填项” } [“password”]=> array(1) { [0]=> string(23) “这个password必填项” } }

如果我们设置无效的邮箱地址和无效的密码呢，让我们开始做邮箱和密码验证：

	private function validateEmail($item,$value,$parameter)
	{
		//把user.php的setEmail的验证方法复制过来
		if (!filter_var($value,FILTER_VALIDATE_EMAIL))
		{
			$this->errors[$item][] = '这个' . $item . '必须填写有效果邮箱';
			return false;
		}
		return true;
	}


	Private function validateMin($item,$value,$parameter)
	{
		//检查字符串的长度
		if (strlen($value) >= $parameter == false)
		{
			$this->errors[$item][] = '这个' . $item . '至少要' . $parameter . '个字符长';
			return false;
		}
		return true;
	}

返回index.php测试显示结果：

array(2) { ["email"]=> array(1) { [0]=> string(38) "这个email必须填写有效果邮箱" } ["password"]=> array(1) { [0]=> string(36) "这个password至少要8个字符长" } }

让我们整理User.php的代码，把validate从user类移除，删除minchars常量，设置电子邮箱地址，删除validation方法：

<?php

class User {
	private $email;
	private $password;

	public function login(){
	 return '登陆 …';
	}

	public function logout(){
	 return '登出…';
	}

	public function setPassword($string){
        $this->password = $string;
        return $this;
    }

    //创建另外一个获取密码的方法
    public function getPassword(){
    	return $this->password;
    }

    public function setEmail ($string){
        $this->email = $string;
        return $this;
    }
    
    public function getEmail (){
        return $this->email;
    }
}
?>

回到index.php，如果通过validation输出电子邮箱和密码，否则就返回错误信息：

<?php

//引入类文件
require 'app/User.php';
require 'app/Validator.php';
require 'app/Helper.php';

//设置
$rules = array('email' => 'required|email','password'=>'required|min:8');
$data= array('email' => 'peter@linyongmin.com','password'=>'12345678');

$validator = new Validator();

//$validator->validate($data, $rules);

if ($validator->validate($data,$rules) === true)
{
	//实例化新用户
	$peter = new User();
	//然后我们将要用peter.setEmail，设置这个到data['email']
	//接着因为我们有方法链接允许，我们可以做设置密码
	$peter->setEmail($data['email'])
		->setPassword($data['password']);
	
}else{
	var_dump($validator->getErrors());
}
?>

接下来我们要做的是密码加密，在我们的Helper.php文件里面，我们将创建一个getHash方法：

<?php 

//字符串作为参数

function getHash($string)
{
	//返回哈希
	
	return hash('sha256',$string);
}
?>

回到index.php把hash添加上去

<?php

//引入类文件
require 'app/User.php';
require 'app/Validator.php';
require 'app/Helper.php';

//设置
$rules = array('email' => 'required|email','password'=>'required|min:8');
$data= array('email' => 'peter@linyongmin.com','password'=>'12345678');

$validator = new Validator();

//$validator->validate($data, $rules);

if ($validator->validate($data,$rules) === true)
{
	//实例化新用户
	$peter = new User();
	//然后我们将要用peter.setEmail，设置这个到data['email']
	//接着因为我们有方法链接允许，我们可以做设置密码
	$peter->setEmail($data['email'])
		->setPassword(getHash($data['password']));
		
	//把peter的输出看看	
	var_dump($peter);
	
}else{
	var_dump($validator->getErrors());
}
?>

返回index.php显示结果：

object(User)#2 (2) { ["email":"User":private]=> string(20) "peter@linyongmin.com" ["password":"User":private]=> string(64) "ef797c8118f02dfb649607dd5d3f8c7623048c9c063d532cc95c5ed7a898a64f" }

让我们回头看

Validate类只负责验证，这些类可以重复性一次又一次是使用；
User类只负责建立一个用户,并登录和注销；
Helper类负责做简单的事情，像创建一个hash。

下载本课堂完整源码

转载请注明：林雍岷 » 第六节：php面向对象编程单一功能原则

把前面课堂源码改为单一功能原则思路

单一功能原则-php面向对象编程单实例演示

与本文相关的文章